From 283d7161a3d049ed1082c289bd5dd1f53c6c6fe0 Mon Sep 17 00:00:00 2001 From: kema-dev Date: Wed, 7 May 2025 10:09:33 +0200 Subject: [PATCH 01/15] chore(ci): add semconv-update workflow for automatic updates --- .github/workflows/semconv-update.yml | 66 ++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 .github/workflows/semconv-update.yml diff --git a/.github/workflows/semconv-update.yml b/.github/workflows/semconv-update.yml new file mode 100644 index 00000000000..5fd984e834a --- /dev/null +++ b/.github/workflows/semconv-update.yml @@ -0,0 +1,66 @@ +name: ci +on: + push: +env: + # Default version of Go to use by CI workflows. This should be the latest + # release of Go; developers likely use the latest release in development and + # we want to catch any bugs (e.g. lint errors, race detection) with this + # release before they are merged. The Go compatibility guarantees ensure + # backwards compatibility with the previous two minor releases and we + # explicitly test our code for these versions so keeping this at prior + # versions does not add value. + DEFAULT_GO_VERSION: '~1.24.0' +# Declare default permissions as read only. +permissions: read-all +jobs: + semconv-update: + runs-on: ubuntu-latest + permissions: + contents: read + pull-requests: write + steps: + - name: Checkout Repo + uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2 + with: + fetch-depth: 0 ## Needed for "Set internal/tools/go.mod timestamp" step. + - name: Install Go + uses: actions/setup-go@0aaccfd150d50ccaeb58ebd88d36e91967a5f35b # v5.4.0 + with: + go-version: ${{ env.DEFAULT_GO_VERSION }} + check-latest: true + cache-dependency-path: '**/go.sum' + - name: Tools cache + uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3 + env: + cache-name: go-tools-cache + with: + path: .tools + key: ${{ runner.os }}-${{ env.DEFAULT_GO_VERSION }}-${{ env.cache-name }}-${{ hashFiles('./internal/tools/**') }} + - name: Fetch latest release tag + id: semconv-get-latest-tag + uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1 + with: + script: | + const owner = "open-telemetry"; + const repo = "semantic-conventions"; + const latestRelease = await github.rest.repos.getLatestRelease({ + owner, + repo, + }); + core.setOutput('tag', latestRelease.data.tag_name); + console.log(`Latest ${owner}/${repo} release tag: ${latestRelease.data.tag_name}`); + - name: Generate + env: + SEMCONV_LATEST_TAG: ${{ steps.semconv-get-latest-tag.outputs.tag }} + run: | + export LATEST_SEMCONV_TAG="${SEMCONV_LATEST_TAG:-}" + make semconv-generate + + - name: Create Pull Request + uses: peter-evans/create-pull-request@271a8d0340265f705b14b6d32b9829c1cb33d45e # v7.0.8 + with: + title: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag }}' + branch: 'chore-semconv-update-to-${{ steps.semconv-get-latest-tag.outputs.tag }}' + body: 'Updating semconv to match open-telemetry/semantic-conventions latest release' + commit-message: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag }}' + labels: bot-generated From b553714352f934c717c71b5be69a1a90a23c8556 Mon Sep 17 00:00:00 2001 From: kema-dev Date: Wed, 7 May 2025 10:32:37 +0200 Subject: [PATCH 02/15] fix(semconv-ci): fix tag outputs --- .github/workflows/semconv-update.yml | 22 ++++++++++++++++------ 1 file changed, 16 insertions(+), 6 deletions(-) diff --git a/.github/workflows/semconv-update.yml b/.github/workflows/semconv-update.yml index 5fd984e834a..04eb2aaae2e 100644 --- a/.github/workflows/semconv-update.yml +++ b/.github/workflows/semconv-update.yml @@ -1,4 +1,4 @@ -name: ci +name: Update semconv on: push: env: @@ -18,17 +18,21 @@ jobs: permissions: contents: read pull-requests: write + outputs: + tag: ${{ steps.semconv-get-latest-tag.outputs.tag_name }} steps: - name: Checkout Repo uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2 with: fetch-depth: 0 ## Needed for "Set internal/tools/go.mod timestamp" step. + - name: Install Go uses: actions/setup-go@0aaccfd150d50ccaeb58ebd88d36e91967a5f35b # v5.4.0 with: go-version: ${{ env.DEFAULT_GO_VERSION }} check-latest: true cache-dependency-path: '**/go.sum' + - name: Tools cache uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3 env: @@ -36,6 +40,7 @@ jobs: with: path: .tools key: ${{ runner.os }}-${{ env.DEFAULT_GO_VERSION }}-${{ env.cache-name }}-${{ hashFiles('./internal/tools/**') }} + - name: Fetch latest release tag id: semconv-get-latest-tag uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1 @@ -47,11 +52,16 @@ jobs: owner, repo, }); - core.setOutput('tag', latestRelease.data.tag_name); - console.log(`Latest ${owner}/${repo} release tag: ${latestRelease.data.tag_name}`); + if (latestRelease && latestRelease.data && latestRelease.data.tag_name) { + core.setOutput('tag_name', latestRelease.data.tag_name); + console.log(`Latest ${owner}/${repo} release tag: ${latestRelease.data.tag_name}`); + } else { + throw new Error("Failed to set latest release tag."); + } + - name: Generate env: - SEMCONV_LATEST_TAG: ${{ steps.semconv-get-latest-tag.outputs.tag }} + SEMCONV_LATEST_TAG: ${{ steps.semconv-get-latest-tag.outputs.tag_name }} run: | export LATEST_SEMCONV_TAG="${SEMCONV_LATEST_TAG:-}" make semconv-generate @@ -59,8 +69,8 @@ jobs: - name: Create Pull Request uses: peter-evans/create-pull-request@271a8d0340265f705b14b6d32b9829c1cb33d45e # v7.0.8 with: - title: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag }}' + title: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag_name }}' branch: 'chore-semconv-update-to-${{ steps.semconv-get-latest-tag.outputs.tag }}' body: 'Updating semconv to match open-telemetry/semantic-conventions latest release' - commit-message: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag }}' + commit-message: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag_name }}' labels: bot-generated From 2c2dcb3bd1d4964dbfd97f6c31fbb8d692a71131 Mon Sep 17 00:00:00 2001 From: kema-dev Date: Wed, 7 May 2025 10:35:31 +0200 Subject: [PATCH 03/15] fix(semconv-ci): fix tag name --- .github/workflows/semconv-update.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/semconv-update.yml b/.github/workflows/semconv-update.yml index 04eb2aaae2e..5ef4291a460 100644 --- a/.github/workflows/semconv-update.yml +++ b/.github/workflows/semconv-update.yml @@ -63,7 +63,7 @@ jobs: env: SEMCONV_LATEST_TAG: ${{ steps.semconv-get-latest-tag.outputs.tag_name }} run: | - export LATEST_SEMCONV_TAG="${SEMCONV_LATEST_TAG:-}" + export TAG="${SEMCONV_LATEST_TAG:-}" make semconv-generate - name: Create Pull Request From 3667e6baed0c7e08a8a4365a148133a029142b43 Mon Sep 17 00:00:00 2001 From: kema-dev Date: Wed, 7 May 2025 10:37:06 +0200 Subject: [PATCH 04/15] fix(semconv-ci): fix workflow permissions --- .github/workflows/semconv-update.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/semconv-update.yml b/.github/workflows/semconv-update.yml index 5ef4291a460..7c1868f3620 100644 --- a/.github/workflows/semconv-update.yml +++ b/.github/workflows/semconv-update.yml @@ -16,7 +16,7 @@ jobs: semconv-update: runs-on: ubuntu-latest permissions: - contents: read + contents: write pull-requests: write outputs: tag: ${{ steps.semconv-get-latest-tag.outputs.tag_name }} From ac7309c85d6cc89adfd3885cabaac6c25c764782 Mon Sep 17 00:00:00 2001 From: kema-dev Date: Wed, 7 May 2025 10:38:24 +0200 Subject: [PATCH 05/15] fix(semconv-ci): fix workflow permissions --- .github/workflows/semconv-update.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/semconv-update.yml b/.github/workflows/semconv-update.yml index 7c1868f3620..05d937150e5 100644 --- a/.github/workflows/semconv-update.yml +++ b/.github/workflows/semconv-update.yml @@ -18,6 +18,7 @@ jobs: permissions: contents: write pull-requests: write + issues: write outputs: tag: ${{ steps.semconv-get-latest-tag.outputs.tag_name }} steps: From 353eb363f4b4557f344e7db0734d7a6e505cce44 Mon Sep 17 00:00:00 2001 From: kema-dev Date: Wed, 7 May 2025 10:43:08 +0200 Subject: [PATCH 06/15] fix(semconv-ci): change trigger from push to scheduled cron job --- .github/workflows/semconv-update.yml | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/.github/workflows/semconv-update.yml b/.github/workflows/semconv-update.yml index 05d937150e5..219a58da1fe 100644 --- a/.github/workflows/semconv-update.yml +++ b/.github/workflows/semconv-update.yml @@ -1,6 +1,16 @@ name: Update semconv on: - push: + schedule: + # ┌───────────── minute (0 - 59) + # │ ┌───────────── hour (0 - 23) + # │ │ ┌───────────── day of the month (1 - 31) + # │ │ │ ┌───────────── month (1 - 12 or JAN-DEC) + # │ │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT) + # │ │ │ │ │ + # │ │ │ │ │ + # │ │ │ │ │ + # * * * * * + - cron: '30 1 * * *' env: # Default version of Go to use by CI workflows. This should be the latest # release of Go; developers likely use the latest release in development and From f51a36b8dba652a9198308c05336b84a578ffb22 Mon Sep 17 00:00:00 2001 From: kema-dev Date: Thu, 8 May 2025 15:07:08 +0200 Subject: [PATCH 07/15] fix(semconv-ci): remove unused Go setup and caching steps from workflow, add workflow dispatch --- .github/workflows/semconv-update.yml | 41 +++++++++------------------- 1 file changed, 13 insertions(+), 28 deletions(-) diff --git a/.github/workflows/semconv-update.yml b/.github/workflows/semconv-update.yml index 05d937150e5..041c1f7a873 100644 --- a/.github/workflows/semconv-update.yml +++ b/.github/workflows/semconv-update.yml @@ -1,15 +1,17 @@ name: Update semconv on: - push: -env: - # Default version of Go to use by CI workflows. This should be the latest - # release of Go; developers likely use the latest release in development and - # we want to catch any bugs (e.g. lint errors, race detection) with this - # release before they are merged. The Go compatibility guarantees ensure - # backwards compatibility with the previous two minor releases and we - # explicitly test our code for these versions so keeping this at prior - # versions does not add value. - DEFAULT_GO_VERSION: '~1.24.0' + schedule: + # ┌───────────── minute (0 - 59) + # │ ┌───────────── hour (0 - 23) + # │ │ ┌───────────── day of the month (1 - 31) + # │ │ │ ┌───────────── month (1 - 12 or JAN-DEC) + # │ │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT) + # │ │ │ │ │ + # │ │ │ │ │ + # │ │ │ │ │ + # * * * * * + - cron: '30 1 * * *' + workflow_dispatch: {} # Declare default permissions as read only. permissions: read-all jobs: @@ -24,23 +26,6 @@ jobs: steps: - name: Checkout Repo uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2 - with: - fetch-depth: 0 ## Needed for "Set internal/tools/go.mod timestamp" step. - - - name: Install Go - uses: actions/setup-go@0aaccfd150d50ccaeb58ebd88d36e91967a5f35b # v5.4.0 - with: - go-version: ${{ env.DEFAULT_GO_VERSION }} - check-latest: true - cache-dependency-path: '**/go.sum' - - - name: Tools cache - uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3 - env: - cache-name: go-tools-cache - with: - path: .tools - key: ${{ runner.os }}-${{ env.DEFAULT_GO_VERSION }}-${{ env.cache-name }}-${{ hashFiles('./internal/tools/**') }} - name: Fetch latest release tag id: semconv-get-latest-tag @@ -72,6 +57,6 @@ jobs: with: title: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag_name }}' branch: 'chore-semconv-update-to-${{ steps.semconv-get-latest-tag.outputs.tag }}' - body: 'Updating semconv to match open-telemetry/semantic-conventions latest release' + body: 'Updating semconv to match open-telemetry/semantic-conventions latest release, ${{ steps.semconv-get-latest-tag.outputs.tag }}' commit-message: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag_name }}' labels: bot-generated From 9c42868f8ed3da80744f3233e765dbb15e8029e7 Mon Sep 17 00:00:00 2001 From: kema-dev Date: Thu, 8 May 2025 15:17:51 +0200 Subject: [PATCH 08/15] fix(semconv-ci): update Go installation and caching steps in workflow --- .github/workflows/semconv-update.yml | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/.github/workflows/semconv-update.yml b/.github/workflows/semconv-update.yml index 041c1f7a873..7a7047471c9 100644 --- a/.github/workflows/semconv-update.yml +++ b/.github/workflows/semconv-update.yml @@ -27,6 +27,21 @@ jobs: - name: Checkout Repo uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2 + - name: Install Go + uses: actions/setup-go@0aaccfd150d50ccaeb58ebd88d36e91967a5f35b # v5.4.0 + with: + go-version-file: 'internal/tools/semconvkit/go.mod' + check-latest: true + cache-dependency-path: 'internal/tools/semconvkit/go.sum' + + - name: Tools cache + uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3 + env: + cache-name: go-semconvkit-cache + with: + path: .tools + key: ${{ runner.os }}-${{ env.cache-name }}-${{ hashFiles('./internal/tools/semconvkit/**', './internal/tools/go.*') }} + - name: Fetch latest release tag id: semconv-get-latest-tag uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1 @@ -57,6 +72,6 @@ jobs: with: title: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag_name }}' branch: 'chore-semconv-update-to-${{ steps.semconv-get-latest-tag.outputs.tag }}' - body: 'Updating semconv to match open-telemetry/semantic-conventions latest release, ${{ steps.semconv-get-latest-tag.outputs.tag }}' + body: 'Updating semconv to match open-telemetry/semantic-conventions latest release' commit-message: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag_name }}' labels: bot-generated From d360dee99647c8cbad6041c7630e6f51e3548e81 Mon Sep 17 00:00:00 2001 From: kema-dev Date: Thu, 8 May 2025 15:18:31 +0200 Subject: [PATCH 09/15] fix(semconv-ci): update Go version file path in workflow --- .github/workflows/semconv-update.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/semconv-update.yml b/.github/workflows/semconv-update.yml index 7a7047471c9..22aa864dde9 100644 --- a/.github/workflows/semconv-update.yml +++ b/.github/workflows/semconv-update.yml @@ -30,7 +30,7 @@ jobs: - name: Install Go uses: actions/setup-go@0aaccfd150d50ccaeb58ebd88d36e91967a5f35b # v5.4.0 with: - go-version-file: 'internal/tools/semconvkit/go.mod' + go-version-file: 'internal/tools/go.mod' check-latest: true cache-dependency-path: 'internal/tools/semconvkit/go.sum' From 7a4515dfe787f9e339ec0b6cabe8999c05e649f0 Mon Sep 17 00:00:00 2001 From: kema-dev Date: Thu, 8 May 2025 15:20:50 +0200 Subject: [PATCH 10/15] fix(semconv-ci): correct branch name in pull request creation step --- .github/workflows/semconv-update.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/semconv-update.yml b/.github/workflows/semconv-update.yml index 22aa864dde9..db171e25dc9 100644 --- a/.github/workflows/semconv-update.yml +++ b/.github/workflows/semconv-update.yml @@ -71,7 +71,7 @@ jobs: uses: peter-evans/create-pull-request@271a8d0340265f705b14b6d32b9829c1cb33d45e # v7.0.8 with: title: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag_name }}' - branch: 'chore-semconv-update-to-${{ steps.semconv-get-latest-tag.outputs.tag }}' + branch: 'chore-semconv-update-to-${{ steps.semconv-get-latest-tag.outputs.tag_name }}' body: 'Updating semconv to match open-telemetry/semantic-conventions latest release' commit-message: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag_name }}' labels: bot-generated From 99d9cece3d3fce3a1e9144a9347b744a1c529f7e Mon Sep 17 00:00:00 2001 From: kema-dev Date: Thu, 8 May 2025 15:22:18 +0200 Subject: [PATCH 11/15] fix(semconv-ci): include latest release tag in pull request body --- .github/workflows/semconv-update.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/semconv-update.yml b/.github/workflows/semconv-update.yml index db171e25dc9..5c97b81e234 100644 --- a/.github/workflows/semconv-update.yml +++ b/.github/workflows/semconv-update.yml @@ -72,6 +72,6 @@ jobs: with: title: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag_name }}' branch: 'chore-semconv-update-to-${{ steps.semconv-get-latest-tag.outputs.tag_name }}' - body: 'Updating semconv to match open-telemetry/semantic-conventions latest release' + body: 'Updating semconv to match open-telemetry/semantic-conventions latest release, ${{ steps.semconv-get-latest-tag.outputs.tag_name }}' commit-message: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag_name }}' labels: bot-generated From 43177123f9a31510d2f958072ef94755294b4825 Mon Sep 17 00:00:00 2001 From: kema-dev Date: Thu, 8 May 2025 15:23:52 +0200 Subject: [PATCH 12/15] fix(semconv-ci): update pull request body to include link to latest release --- .github/workflows/semconv-update.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/semconv-update.yml b/.github/workflows/semconv-update.yml index 5c97b81e234..91be47a9102 100644 --- a/.github/workflows/semconv-update.yml +++ b/.github/workflows/semconv-update.yml @@ -72,6 +72,6 @@ jobs: with: title: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag_name }}' branch: 'chore-semconv-update-to-${{ steps.semconv-get-latest-tag.outputs.tag_name }}' - body: 'Updating semconv to match open-telemetry/semantic-conventions latest release, ${{ steps.semconv-get-latest-tag.outputs.tag_name }}' + body: 'Updating semconv to match [open-telemetry/semantic-conventions latest release, ${{ steps.semconv-get-latest-tag.outputs.tag_name }}](https://github.com/open-telemetry/semantic-conventions/releases/tag/${{ steps.semconv-get-latest-tag.outputs.tag_name }})' commit-message: 'chore(semconv): update semconv to ${{ steps.semconv-get-latest-tag.outputs.tag_name }}' labels: bot-generated From 8f84faa2ecafc3621d0645774c48fa5566d6a2fe Mon Sep 17 00:00:00 2001 From: kema-dev Date: Thu, 8 May 2025 15:32:48 +0200 Subject: [PATCH 13/15] doc(RELEASING.md): remove outdated semantic convention generation instructions --- RELEASING.md | 18 ------------------ 1 file changed, 18 deletions(-) diff --git a/RELEASING.md b/RELEASING.md index 7c1a9119dcc..81dadcdbc63 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -4,24 +4,6 @@ Create a `Version Release` issue to track the release process. -## Semantic Convention Generation - -New versions of the [OpenTelemetry Semantic Conventions] mean new versions of the `semconv` package need to be generated. -The `semconv-generate` make target is used for this. - -1. Set the `TAG` environment variable to the semantic convention tag you want to generate. -2. Run the `make semconv-generate ...` target from this repository. - -For example, - -```sh -export TAG="v1.30.0" # Change to the release version you are generating. -make semconv-generate # Uses the exported TAG. -``` - -This should create a new sub-package of [`semconv`](./semconv). -Ensure things look correct before submitting a pull request to include the addition. - ## Breaking changes validation You can run `make gorelease` that runs [gorelease](https://pkg.go.dev/golang.org/x/exp/cmd/gorelease) to ensure that there are no unwanted changes done in the public API. From e6457358212ed7700e54c865e69b991dce1a1ee3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Jourdan?= Date: Sat, 26 Jul 2025 11:22:42 +0200 Subject: [PATCH 14/15] Revert "doc(RELEASING.md): remove outdated semantic convention generation instructions" This reverts commit 8f84faa2ecafc3621d0645774c48fa5566d6a2fe. --- RELEASING.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/RELEASING.md b/RELEASING.md index d79abe1f329..1ddcdef0396 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -4,6 +4,24 @@ Create a `Version Release` issue to track the release process. +## Semantic Convention Generation + +New versions of the [OpenTelemetry Semantic Conventions] mean new versions of the `semconv` package need to be generated. +The `semconv-generate` make target is used for this. + +1. Set the `TAG` environment variable to the semantic convention tag you want to generate. +2. Run the `make semconv-generate ...` target from this repository. + +For example, + +```sh +export TAG="v1.30.0" # Change to the release version you are generating. +make semconv-generate # Uses the exported TAG. +``` + +This should create a new sub-package of [`semconv`](./semconv). +Ensure things look correct before submitting a pull request to include the addition. + ## Breaking changes validation You can run `make gorelease` that runs [gorelease](https://pkg.go.dev/golang.org/x/exp/cmd/gorelease) to ensure that there are no unwanted changes done in the public API. From e0d3c715ad89fa1d3cde583cde402459302df018 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Jourdan?= Date: Sat, 26 Jul 2025 11:31:50 +0200 Subject: [PATCH 15/15] docs(release): update semconv generation process --- RELEASING.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/RELEASING.md b/RELEASING.md index 1ddcdef0396..d8aa9c9a7f2 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -7,7 +7,9 @@ Create a `Version Release` issue to track the release process. ## Semantic Convention Generation New versions of the [OpenTelemetry Semantic Conventions] mean new versions of the `semconv` package need to be generated. -The `semconv-generate` make target is used for this. +This is automatically done each day by CI pipeline [semconv-update.yml](.github/workflows/semconv-update.yml), which opens a PR adding the generated package if it finds an upstream update. You can also trigger the pipeline manually via `workflow_dispatch`. + +However you can still use `semconv-generate` make target to generate the package. 1. Set the `TAG` environment variable to the semantic convention tag you want to generate. 2. Run the `make semconv-generate ...` target from this repository. @@ -15,7 +17,7 @@ The `semconv-generate` make target is used for this. For example, ```sh -export TAG="v1.30.0" # Change to the release version you are generating. +export TAG="v1.36.0" # Change to the release version you are generating. make semconv-generate # Uses the exported TAG. ```