Update to latest codebase

Author: flobernd

.buildkite/DockerFile

@@ -1,4 +1,4 @@
-ARG DOTNET_VERSION=8.0.400
+ARG DOTNET_VERSION=9.0.100
 FROM mcr.microsoft.com/dotnet/sdk:${DOTNET_VERSION} AS elasticsearch-net-build
 
 ENV NUGET_SCRATCH="/tmp/NuGetScratch"

.buildkite/pipeline.yml

@@ -5,7 +5,7 @@ steps:
     env:
       TEST_SUITE: "{{ matrix.suite }}"
       STACK_VERSION: master-SNAPSHOT
-      DOTNET_VERSION: 8.0.400
+      DOTNET_VERSION: 9.0.100
     matrix:
       setup:
         suite:

.buildkite/run-repository.ps1

@@ -14,7 +14,7 @@ param(
     $NODE_NAME,
 
     [string]
-    $DOTNET_VERSION = "8.0.400"
+    $DOTNET_VERSION = "9.0.100"
 )
 
 $ESC = [char]27

.buildkite/run-repository.sh

@@ -9,7 +9,7 @@ script_path=$(dirname $(realpath -s $0))
 source $script_path/functions/imports.sh
 set -euo pipefail
 
-DOTNET_VERSION=${DOTNET_VERSION-8.0.400}
+DOTNET_VERSION=${DOTNET_VERSION-9.0.100}
 ELASTICSEARCH_URL=${ELASTICSEARCH_URL-"$elasticsearch_url"}
 elasticsearch_container=${elasticsearch_container-}
 

.buildkite/run-tests.ps1

@@ -8,7 +8,7 @@ param (
     $TEST_SUITE = "free",
 
     [string]
-    $DOTNET_VERSION = "8.0.400"
+    $DOTNET_VERSION = "9.0.100"
 )
 
 $ESC = [char]27

.ci/DockerFile

@@ -1,4 +1,4 @@
-ARG DOTNET_VERSION=8.0.400
+ARG DOTNET_VERSION=9.0.100
 FROM mcr.microsoft.com/dotnet/sdk:${DOTNET_VERSION} AS elasticsearch-net-build
 
 ENV NUGET_SCRATCH="/tmp/NuGetScratch"

.ci/make.sh

@@ -42,7 +42,7 @@ OUTPUT_DIR="$repo/${output_folder}"
 REPO_BINDING="${OUTPUT_DIR}:/sln/${output_folder}"
 mkdir -p "$OUTPUT_DIR"
 
-DOTNET_VERSION=${DOTNET_VERSION-8.0.400}
+DOTNET_VERSION=${DOTNET_VERSION-9.0.100}
 
 echo -e "\033[34;1mINFO:\033[0m PRODUCT ${product}\033[0m"
 echo -e "\033[34;1mINFO:\033[0m VERSION ${STACK_VERSION}\033[0m"

.ci/readme.md

@@ -30,7 +30,7 @@ $ STACK_VERSION=8.0.0-SNAPSHOT ./.ci/run-tests
 |-------------------------|-------------|-------------|
 | `STACK_VERSION` | `N/A`       | The elasticsearch version to target
 | `TEST_SUITE`            | `basic`     | `free` or `platinum` sets which test suite to run and which container to run against. |
-| `DOTNET_VERSION`        | `8.0.400`   | The .NET sdk version used to grab the proper container |
+| `DOTNET_VERSION`        | `9.0.100`   | The .NET sdk version used to grab the proper container |
 
 If you want to manually spin up elasticsearch for these tests and call the runner afterwards you can use
 

.ci/run-repository.ps1

@@ -14,7 +14,7 @@ param(
     $NODE_NAME,
 
     [string]
-    $DOTNET_VERSION = "8.0.400"
+    $DOTNET_VERSION = "9.0.100"
 )
 
 $ESC = [char]27

.ci/run-repository.sh

@@ -9,7 +9,7 @@ script_path=$(dirname $(realpath -s $0))
 source $script_path/functions/imports.sh
 set -euo pipefail
 
-DOTNET_VERSION=${DOTNET_VERSION-8.0.400}
+DOTNET_VERSION=${DOTNET_VERSION-9.0.100}
 ELASTICSEARCH_URL=${ELASTICSEARCH_URL-"$elasticsearch_url"}
 elasticsearch_container=${elasticsearch_container-}
 

.ci/run-tests.ps1

@@ -8,7 +8,7 @@ param (
     $TEST_SUITE = "free",
 
     [string]
-    $DOTNET_VERSION = "8.0.400"
+    $DOTNET_VERSION = "9.0.100"
 )
 
 $ESC = [char]27

.ci/test-matrix.yml

@@ -8,6 +8,6 @@ TEST_SUITE:
   - platinum
 
 DOTNET_VERSION:
-  - 8.0.400
+  - 9.0.100
 
 exclude: ~

.github/ISSUE_TEMPLATE/bug-report-for-version-9-x.md

@@ -0,0 +1,33 @@
+---
+name: Bug report for version 9.x
+about: File a bug report for Elastic.Clients.Elasticsearch version 9.x
+title: ''
+labels: 
+  - 'Category: Bug'
+  - '9.x'
+assignees: ''
+
+---
+
+**Elastic.Clients.Elasticsearch version**:
+
+**Elasticsearch version**:
+
+**.NET runtime version**:
+
+**Operating system version**:
+
+**Description of the problem including expected versus actual behavior**:
+A clear and concise description of what the bug is.
+
+**Steps to reproduce**:
+ 1.
+ 2.
+ 3.
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Provide `ConnectionSettings` (if relevant)**:
+
+**Provide `DebugInformation` (if relevant)**:

.github/ISSUE_TEMPLATE/config,yml renamed to .github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,126 @@
+name: Check
+
+on:
+  pull_request:
+    branches:
+      - main
+    types: [labeled, unlabeled, opened, reopened, synchronize]
+
+permissions:
+  pull-requests: "read"
+
+jobs:
+  check-backport-label:
+    name: backport label 
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: "Check backport label"
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          json_pr_labels='${{ toJSON(github.event.pull_request.labels) }}'
+          readarray -t pr_labels < <(echo "${json_pr_labels}" | jq -r -c '.[].name')
+
+          json_all_labels="$(gh label list --repo ${{ github.repository }} --json name --search "backport" --limit 1000)"
+          readarray -t all_labels < <(echo "${json_all_labels}" | jq -r -c '.[].name')
+
+          declare -A all_backport_labels=()
+          declare -A all_floating_majors=()
+
+          backport_regex="^backport ([0-9])+\.([0-9]+|x)$"
+
+          echo "::group::Available Labels"
+          echo "skip-backport"
+
+          for label in "${all_labels[@]}"; do
+            if [[ "${label}" =~ ${backport_regex} ]]; then
+              major="${BASH_REMATCH[1]}"
+              minor="${BASH_REMATCH[2]}"
+              all_backport_labels["${label}"]=1
+              echo "${label}"
+
+              if [ "${minor}" = "x" ]; then
+                all_floating_majors["${major}"]=1
+              fi
+            fi
+          done
+
+          echo "::endgroup::"
+
+          has_exact_backport_label=false
+          declare -A pr_exact_majors=()
+          declare -A pr_floating_majors=()
+
+          echo "::group::Detected Labels"
+
+          for pr_label in "${pr_labels[@]}"; do
+            if [ "${pr_label}" = "skip-backport" ]; then
+              has_exact_backport_label=true
+              echo "${pr_label}"
+              continue
+            fi
+
+            if [ -z "${all_backport_labels[${pr_label}]}" ]; then
+              continue
+            fi
+
+            if [[ "${pr_label}" =~ ${backport_regex} ]]; then
+              major="${BASH_REMATCH[1]}"
+              minor="${BASH_REMATCH[2]}"
+              if [ "${minor}" != "x" ]; then
+                pr_exact_majors["${major}"]=1
+                has_exact_backport_label=true
+              else
+                pr_floating_majors["${major}"]=1
+              fi
+            fi
+
+            echo "${pr_label}"
+          done
+
+          echo "::endgroup::"
+
+          if [ "${has_exact_backport_label}" != true ]; then
+            echo "::error::No exact backport label found. Please add at least one of the"\
+                  "'backport {major}.{minor}' labels or use 'skip-backport',"\
+                  "if this PR should not be backported."
+            exit 1
+          fi
+
+          # Validate that a floating backport label exists for each exact backport label major
+          # version.
+
+          has_required_floating_labels=true
+
+          for pr_major in "${!pr_exact_majors[@]}"; do
+            if [ -z "${all_floating_majors[${pr_major}]}" ]; then
+              # There is no floating version branch for the given major version.
+              continue
+            fi
+
+            if [ -z "${pr_floating_majors[${pr_major}]}" ]; then
+              has_required_floating_labels=false
+              echo "::error::Missing floating backport label for '${pr_major}.x'"
+            fi
+          done
+
+          if [ "${has_required_floating_labels}" != true ]; then
+            exit 1
+          fi
+
+          # Validate that an exact backport label exists for each floating backport label major
+          # version.
+
+          has_required_exact_labels=true
+
+          for pr_floating_major in "${!pr_floating_majors[@]}"; do
+            if [ -z "${pr_exact_majors[${pr_floating_major}]}" ]; then
+              has_required_exact_labels=false
+              echo "::error::Missing exact backport label for '${pr_floating_major}.x'"
+            fi
+          done
+
+          if [ "${has_required_exact_labels}" != true ]; then
+            exit 1
+          fi

.github/workflows/check-backport-labels.yml

@@ -0,0 +1,74 @@
+name: 'CD'
+
+on:
+  workflow_call:
+    inputs:
+      target_branch:
+        description: 'The target branch to which the documentation should be pushed to.'
+        type: 'string'
+        required: true
+      name:
+        description: 'The name to use for the documentation folder (defaults to the name of the current ref)'
+        type: 'string'
+        required: false
+        default: ${{ github.ref_name }}
+
+concurrency:
+  group: 'docfx'
+  cancel-in-progress: false
+
+env:
+  # Configuration
+  GLOBAL_JSON_FILE: 'global.json'
+  CACHE_PATTERNS: '["**/*.[cf]sproj*", "**/*.Build.props"]'
+  # .NET SDK related environment variables
+  DOTNET_NOLOGO: 1
+  DOTNET_SKIP_FIRST_TIME_EXPERIENCE: 1
+  DOTNET_CLI_TELEMETRY_OPTOUT: 1
+  DOTNET_GENERATE_ASPNET_CERTIFICATE: 0
+
+jobs:
+  docfx:
+    name: 'DocFx'
+    runs-on: 'ubuntu-latest'
+    steps:
+      - name: 'Checkout'
+        uses: 'actions/checkout@v4'
+
+      - name: '.NET Setup'
+        uses: 'actions/setup-dotnet@v4'
+        with:
+          global-json-file: '${{ github.workspace }}/${{ env.GLOBAL_JSON_FILE }}'
+
+      - name: 'DocFX Setup'
+        run: |-
+          dotnet tool update -g docfx
+
+      # TODO: Remove 'stack'
+      - name: '.NET Cache Packages'
+        uses: 'actions/cache@v4'
+        with:
+          path: '~/.nuget/packages'
+          key: '${{ runner.os }}-nuget-stack-${{ hashFiles(fromJson(env.CACHE_PATTERNS)) }}'
+          restore-keys: '${{ runner.os }}-nuget-stack-'
+
+      - name: 'DocFx Build'
+        working-directory: 'docfx'
+        run: |-
+          docfx docfx.json
+          mv ./_site ./../..
+
+      - name: 'Checkout'
+        uses: 'actions/checkout@v4'
+        with:
+          ref: ${{ inputs.target_branch }}
+
+      - name: 'Commit'
+        run: |-
+          rm -r "./${{ inputs.name }}" || true
+          mv ../_site "./${{ inputs.name }}"
+          git config --global user.name '${{ github.actor }}'
+          git config --global user.email '${{ github.actor }}@users.noreply.github.com'
+          git add -A
+          git commit -am "Add ${{ inputs.name }}"
+          git push

.github/workflows/docfx.yml

@@ -0,0 +1,12 @@
+name: 'DocFx'
+
+on:
+  workflow_dispatch:
+
+jobs:
+  docfx:
+    name: 'DocFx'
+    uses: ./.github/workflows/docfx.yml
+    with:
+      target_branch: 'refdoc'
+    secrets: 'inherit'

.github/workflows/docfx_manual.yml

@@ -0,0 +1,19 @@
+name: docs-build
+
+on:
+  push:
+    branches:
+      - main
+  pull_request_target: ~
+  merge_group: ~
+
+jobs:
+  docs-preview:
+    uses: elastic/docs-builder/.github/workflows/preview-build.yml@main
+    with:
+      path-pattern: docs/**
+    permissions:
+      deployments: write
+      id-token: write
+      contents: read
+      pull-requests: read

.github/workflows/docs-build.yml

@@ -0,0 +1,14 @@
+name: docs-cleanup
+
+on:
+  pull_request_target:
+    types:
+      - closed
+
+jobs:
+  docs-preview:
+    uses: elastic/docs-builder/.github/workflows/preview-cleanup.yml@main
+    permissions:
+      contents: none
+      id-token: write
+      deployments: write

.github/workflows/docs-cleanup.yml

@@ -16,3 +16,12 @@ jobs:
       release_tag: ${{ github.event.release.tag_name }}
       release_body: ${{ github.event.release.body }}
     secrets: 'inherit'
+
+  docfx:
+    name: 'DocFx'
+    if: ${{ !startsWith(github.event.release.tag_name, 'serverless-') }}
+    uses: ./.github/workflows/docfx.yml
+    with:
+      name: ${{ github.event.release.tag_name }}
+      target_branch: 'refdoc'
+    secrets: 'inherit'