Aktualisierung der Custom Edition in einer Air-Gapped-Umgebung

Sie können die Custom Edition in einer Air-Gapped-Umgebung mithilfe des Plug-ins „ kubectl “ aktualisieren.

Das Plug-in „ Instana “ ( kubectl ) und der Operator „ Instana “ (Enterprise) werden immer zusammen veröffentlicht. Die Backend-Updates von Instana sind unabhängig von Instana Der Enterprise-Betreiber releases.You kann das Plug-in Instana kubectl verwenden, um die unterstützten Backend-Versionen von Instana zu überprüfen und das Backend bei Bedarf zu aktualisieren. Nach bis zu vier Backend- Instana -Releases wird eine neue Version des Instana Enterprise-Operators veröffentlicht. Die spezifischen Anforderungen für das Upgrade finden Sie in den Upgrade-Hinweisen.

Voraussetzungen

Stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind, bevor Sie „ Instana “ aktualisieren:
  • Der Cluster verfügt über ausreichende Kapazität. Wenn der Cluster seine Anforderungskapazität fast erreicht hat, fügen Sie einen zusätzlichen Knoten hinzu, um zu vermeiden, dass die Pods im Status „Ausstehend“ hängen bleiben.
  • Die Knoten „ Elasticsearch “ verfügen über ausreichend Speicherplatz. Wenn die Festplattenauslastung 80 % überschreitet, wechseln die Knoten „ Elasticsearch “ automatisch in den schreibgeschützten Modus, was dazu führen kann, dass das Upgrade hängen bleibt oder stillschweigend fehlschlägt.
  • Der Jump-Host ist mit dem Internet verbunden und hat Zugriff auf den luftisolierten Cluster oder die Umgebung, in der das Backend von Instana aktualisiert wird.
  • Lesen Sie die Hinweise zum Upgrade. Wenn Sie eine Version überspringen, lesen Sie die Upgrade-Hinweise für jede übersprungene Version sowie für die Zielversion durch.

Vorgehensweise

Um die Custom Edition in einer Air-Gapped-Umgebung zu aktualisieren, führen Sie die folgenden Schritte aus:

Hinweis:
Die in dieser Anleitung enthaltenen Beispiele sind für Linux x86_64 bestimmt.
  • Informationen zu den Versionen von „ Linux on IBM Z and LinuxONE “ finden Sie unter „Upgrading data stores“ (Aktualisieren von Datenspeichern) auf Linux on IBM Z and LinuxONE.
  • Informationen zu den Versionen von „ Linux on Power “ finden Sie unter „Upgrading data stores“ (Aktualisieren von Datenspeichern) auf Linux on Power ( ppc64le ).

  1. Überprüfen Sie, ob die Datenspeicherversionen mit der Version von „ Instana “ kompatibel sind, auf die Sie aktualisieren möchten. Informationen zu Datenspeicherversionen finden Sie unter Aktualisieren von Datenspeicheroperatoren von Drittanbietern.

  2. Wenn Ihre Datenspeicherversion nicht kompatibel ist, aktualisieren Sie die Datenspeicher.

    1. Wartungsmodus aktivieren.

      kubectl patch core instana-core -n instana-core --type='merge' -p '{"spec":{"operationMode": "maintenance"}}'
      • Skopeo:
        skopeo login -u <your_internal_artifactory_username> -p <your_internal_artifactory_password> <internal-image-registry>
      • Docker:
        docker login -u <your_internal_artifactory_username> -p <your_internal_artifactory_password> <internal-image-registry>

        Ändern Sie nicht den tatsächlichen Namen der Bilder. Ändern Sie nur die Artifactory- URL - und Pfadangaben. Wenn Sie beispielsweise ausführen kubectl instana versions list-images und der zurückgegebene Bildname lautet artifact-public.instana.io/backend/acceptor:3.xxx.xxx–x, müssen Sie das Bild im folgenden Format in Ihr internes Artifactory übertragen: <internal-image-registry>/<internal-image-repository-path>/acceptor:<tag_of_image>.

    2. Artefakte herunterladen und in eine interne Bildregistrierung hochladen.

      Hinweis:
      Kopieren Sie die Images von Ihrem Bastion-Host in Ihr eigenes internes Image-Repository. Führen Sie einen der folgenden Schritte aus, je nachdem, ob Sie Skopeo oder Docker verwenden. Ändern Sie nicht den tatsächlichen Namen der Bilder. Ändern Sie nur die Artifactory- URL - und Pfadangaben. Wenn Sie beispielsweise den Befehl ausführen und kubectl instana versions list-images als Ergebnis den Bildnamen erhalten artifact-public.instana.io/backend/acceptor:3.xxx.xxx–x, müssen Sie das Bild im folgenden Format in Ihr internes Artifactory hochladen: <interne-Bild-Registry>/<interner-Bild-Repository-Pfad>/acceptor:<Tag_des_Bildes>.
      • Skopeo
        1. Kopieren Sie die Strimzi-Bilder.
          skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/self-hosted-images/3rd-party/operator/strimzi:1.0.1_v0.33.0 docker://<internal-image-registry>/<internal-image-repository-path>/strimzi:1.0.1_v0.33.0
skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/self-hosted-images/3rd-party/datastore/kafka:1.0.1-kafka-4.1.2_v0.37.0 docker://<internal-image-registry>/<internal-image-repository-path>/kafka:1.0.1-kafka-4.1.2_v0.37.0
        2. Kopieren Sie die Bilder „ Elasticsearch “.
          skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/self-hosted-images/3rd-party/operator/elasticsearch:3.4.1_v0.34.0 docker://<internal-image-registry>/<internal-image-repository-path>/elasticsearch-operator:3.4.1_v0.34.0
skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/self-hosted-images/3rd-party/datastore/elasticsearch:8.19.18_v0.37.0 docker://<internal-image-registry>/<internal-image-repository-path>/elasticsearch:8.19.18_v0.37.0
        3. Kopieren Sie die Bilder „ CNPG “ und „ Postgres “.
          skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/self-hosted-images/3rd-party/operator/cloudnative-pg:v1.29.2_v0.35.0 docker://<internal-image-registry>/<internal-image-repository-path>/cloudnative-pg-operator:v1.29.2_v0.35.0
skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/self-hosted-images/3rd-party/datastore/cnpg-containers:15_v0.40.0 docker://<internal-image-registry>/<internal-image-repository-path>/cnpg-containers:15_v0.40.0
        4. Kopieren Sie die Bilder „ Cassandra “.
          skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/self-hosted-images/3rd-party/operator/cass-operator:1.30.3_v0.41.0 docker://<internal-image-registry>/<internal-image-repository-path>/cass-operator:1.30.3_v0.41.0
skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/self-hosted-images/3rd-party/datastore/cassandra:4.1.11_v0.43.0 docker://<internal-image-registry>/<internal-image-repository-path>/cassandra:4.1.11_v0.43.0
skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/self-hosted-images/3rd-party/datastore/system-logger:1.30.3_v0.24.0 docker://<internal-image-registry>/<internal-image-repository-path>/system-logger:1.30.3_v0.41.0
skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/self-hosted-images/3rd-party/datastore/k8ssandra-client:0.8.14_v0.34.0 docker://<internal-image-registry>/<internal-image-repository-path>/k8ssandra-client:0.8.14_v0.34.0
        5. Kopieren Sie die Bilder von ClickHouse.
          skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/clickhouse-operator:v1.2.39 docker://<internal-image-registry>/<internal-image-repository-path>/clickhouse-operator:v1.2.39
skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/clickhouse:25.8.13.73-7-lts-ibm docker://<internal-image-registry>/<internal-image-repository-path>/clickhouse:25.8.13.73-7-lts-ibm
        6. Kopieren Sie die Zookeeper-Bilder.
          skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/self-hosted-images/3rd-party/operator/zookeeper:0.2.15_v0.21.0 docker://<internal-image-registry>/<internal-image-repository-path>/operator/zookeeper:0.2.15_v0.21.0 
skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/self-hosted-images/3rd-party/datastore/zookeeper:3.9.3_v0.21.0 docker://<internal-image-registry>/<internal-image-repository-path>/zookeeper:3.9.3_v0.21.0 
skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/self-hosted-images/k8s/kubectl:v1.36.2_v0.13.0 docker://<internal-image-registry>/<internal-image-repository-path>/k8s/kubectl:v1.36.2_v0.13.0
      • Docker
        1. Kopieren Sie die Strimzi-Bilder.
          #Pull images 
docker pull artifact-public.instana.io/self-hosted-images/3rd-party/operator/strimzi:1.0.1_v0.33.0
docker pull artifact-public.instana.io/self-hosted-images/3rd-party/datastore/kafka:1.0.1-kafka-4.1.2_v0.37.0
#Retag the images to your internal image registry 
docker tag artifact-public.instana.io/self-hosted-images/3rd-party/operator/strimzi:1.0.1_v0.33.0 <internal-image-registry>/operator/strimzi:1.0.1_v0.33.0
docker tag artifact-public.instana.io/self-hosted-images/3rd-party/datastore/kafka:1.0.1-kafka-4.1.2_v0.37.0 <internal-image-registry>/datastore/kafka:1.0.1-kafka-4.1.2_v0.37.0 
#Push the images to your internal image registry  
docker push <internal-image-registry>/operator/strimzi:1.0.1_v0.33.0
docker push <internal-image-registry>/datastore/kafka:1.0.1-kafka-4.1.2_v0.37.0
        2. Kopieren Sie die Bilder „ Elasticsearch “.
          #Pull images 
docker pull artifact-public.instana.io/self-hosted-images/3rd-party/operator/elasticsearch:3.4.1_v0.34.0 
docker pull artifact-public.instana.io/self-hosted-images/3rd-party/datastore/elasticsearch:8.19.18_v0.37.0 
#Retag the images to your internal image registry 
docker tag artifact-public.instana.io/self-hosted-images/3rd-party/operator/elasticsearch:3.4.1_v0.34.0 <internal-image-registry>/operator/elasticsearch:3.4.1_v0.34.0 
docker tag artifact-public.instana.io/self-hosted-images/3rd-party/datastore/elasticsearch:8.19.18_v0.37.0 <internal-image-registry>/datastore/elasticsearch:8.19.18_v0.37.0 
#Push the images to your internal image registry  
docker push <internal-image-registry>/operator/elasticsearch:3.4.1_v0.34.0 
docker push <internal-image-registry>/datastore/elasticsearch:8.19.18_v0.37.0
        3. Kopieren Sie die Bilder „ CNPG “ und „ Postgres “.
          #Pull images 
docker pull artifact-public.instana.io/self-hosted-images/3rd-party/operator/cloudnative-pg:v1.29.2_v0.35.0 
docker pull artifact-public.instana.io/self-hosted-images/3rd-party/datastore/cnpg-containers:15_v0.40.0 
#Retag the images to your internal image registry 
docker tag artifact-public.instana.io/self-hosted-images/3rd-party/operator/cloudnative-pg:v1.29.2_v0.35.0 <internal-image-registry>/operator/cloudnative-pg:v1.29.2_v0.35.0 
docker tag artifact-public.instana.io/self-hosted-images/3rd-party/datastore/cnpg-containers:15_v0.40.0 <internal-image-registry>/datastore/cnpg-containers:15_v0.40.0 
#Push the images to your internal image registry  
docker push <internal-image-registry>/operator/cloudnative-pg:v1.29.2_v0.35.0 
docker push <internal-image-registry>/datastore/cnpg-containers:15_v0.40.0
        4. Kopieren Sie die Bilder „ Cassandra “.
          #Pull images 
docker pull artifact-public.instana.io/self-hosted-images/3rd-party/operator/cass-operator:1.30.3_v0.41.0 
docker pull artifact-public.instana.io/self-hosted-images/3rd-party/datastore/system-logger:1.30.3_v0.24.0 
docker pull artifact-public.instana.io/self-hosted-images/3rd-party/datastore/k8ssandra-client:0.8.14_v0.34.0 
docker pull artifact-public.instana.io/self-hosted-images/3rd-party/datastore/cassandra:4.1.11_v0.43.0 
#Retag the images to your internal image registry 
docker tag artifact-public.instana.io/self-hosted-images/3rd-party/operator/cass-operator:1.30.3_v0.41.0 <internal-image-registry>/operator/cass-operator:1.30.3_v0.41.0 
docker tag artifact-public.instana.io/self-hosted-images/3rd-party/datastore/system-logger:1.30.3_v0.24.0 <internal-image-registry>/datastore/system-logger:1.30.3_v0.24.0 
docker tag artifact-public.instana.io/self-hosted-images/3rd-party/datastore/k8ssandra-client:0.8.14_v0.34.0 <internal-image-registry>/datastore/k8ssandra-client:0.8.14_v0.34.0 
docker tag artifact-public.instana.io/self-hosted-images/3rd-party/datastore/cassandra:4.1.11_v0.43.0 <internal-image-registry>/datastore/cassandra:4.1.11_v0.43.0 
#Push the images to your internal image registry  
docker push <internal-image-registry>/operator/cass-operator:1.30.3_v0.41.0 
docker push <internal-image-registry>/datastore/system-logger:1.30.3_v0.24.0 
docker push <internal-image-registry>/datastore/k8ssandra-client:0.8.14_v0.34.0 
docker push <internal-image-registry>/datastore/cassandra:4.1.11_v0.43.0

        5. Kopieren Sie die Bilder von ClickHouse.

          Bilder ziehen:
          
docker pull artifact-public.instana.io/clickhouse-operator:v1.2.39 
docker pull artifact-public.instana.io/clickhouse:25.8.13.73-7-lts-ibm
          Ordnen Sie die Bilder Ihrer internen Bilddatenbank neu zu:
          docker tag artifact-public.instana.io/clickhouse-operator:v1.2.39 <internal-image-registry>/clickhouse-operator:v1.2.39 
docker tag artifact-public.instana.io/clickhouse:25.8.13.73-7-lts-ibm <internal-image-registry>/clickhouse:25.8.13.73-7-lts-ibm
          Laden Sie die Bilder in Ihr internes Bildarchiv hoch:
          docker push <internal-image-registry>/clickhouse-operator:v1.2.39 
docker push <internal-image-registry>/clickhouse:25.8.13.73-7-lts-ibm
        6. Kopieren Sie die Zookeeper-Bilder.
          #Pull images 
docker pull artifact-public.instana.io/self-hosted-images/3rd-party/operator/zookeeper:0.2.15_v0.21.0
docker pull artifact-public.instana.io/self-hosted-images/3rd-party/datastore/zookeeper:3.9.3_v0.21.0 
docker pull artifact-public.instana.io/self-hosted-images/k8s/kubectl:v1.36.2_v0.13.0
#Retag the images to your internal image registry 
docker tag artifact-public.instana.io/self-hosted-images/3rd-party/operator/zookeeper:0.2.15_v0.21.0 <internal-image-registry>/operator/zookeeper:0.2.15_v0.21.0 
docker tag artifact-public.instana.io/self-hosted-images/3rd-party/datastore/zookeeper:3.9.3_v0.21.0 <internal-image-registry>/zookeeper:3.9.3_v0.21.0 
docker tag artifact-public.instana.io/self-hosted-images/k8s/kubectl:v1.36.2_v0.13.0 <internal-image-registry>/self-hosted-images/k8s/kubectl:v1.36.2_v0.13.0 
#Push the images to your internal image registry  
docker push <internal-image-registry>/operator/zookeeper:0.2.15_v0.21.0
docker push <internal-image-registry>/zookeeper:3.9.3_v0.21.0 
docker push <internal-image-registry>/self-hosted-images/k8s/kubectl:v1.36.2_v0.13.0
    3. Helm -Diagramme herunterladen:
      1. helm -Repositorys hinzufügen.
        helm repo add instana https://artifact-public.instana.io/artifactory/rel-helm-customer-virtual --username=_ --password=$DOWNLOAD_KEY
        helm repo update
      2. Helm -Diagramme herunterladen:
        helm pull instana/ibm-clickhouse-operator --version=v1.2.0
helm pull instana/strimzi-kafka-operator --version=1.0.1 
helm pull instana/eck-operator --version=3.4.1 
helm pull instana/cloudnative-pg --version=0.29.0
helm pull instana/cass-operator --version=0.64.4
helm pull instana/zookeeper-operator --version=1.0.0
    4. Daten-Stores aktualisieren.
      1. Optional: Erstellen Sie einen Image Pull Secret, wenn Ihre interne Image-Registry eine Authentifizierung erfordert.
        kubectl create secret docker-registry <internal-image-registry-pull-secret> --namespace instana-clickhouse \
--docker-username=<registry_username> \
--docker-password=<registry_password> \
--docker-server=<internal-image-registry>:<internal-image-registry-port> \
--docker-email=<registry_email>
      2. Kafka aktualisieren
        1. Aktualisieren Sie den Strimzi Operator. Wenn Sie im vorherigen Schritt einen Image-Pull-Secret erstellt haben, fügen Sie --set image.imagePullSecrets[0].name="<internal-image-registry-pull-secret>" zum folgenden Befehl hinzu.
          helm upgrade --install strimzi-kafka-operator strimzi-kafka-operator-helm-3-chart-1.0.1.tgz --version 1.0.1 -n instana-kafka --set image.registry=<internal-image-registry> --set image.repository=operator --set image.name=strimzi --set image.tag=1.0.1_v0.33.0 --set kafka.image.registry=<internal-image-registry> --set kafka.image.repository=datastore --set kafka.image.name=kafka --set kafka.image.tag=1.0.1-kafka-4.1.2_v0.37.0
        2. Aktualisieren Sie die benutzerdefinierte Ressource „ Kafka “.
          kubectl patch Kafka instana -n instana-kafka --type='merge' -p '
   spec:
     kafka:
       version: 4.1.2 
     entityOperator:
       userOperator:
         image: <internal-image-registry>/operator/strimzi:1.0.1_v0.33.0
         '
        3. Warten Sie, bis die Bereitstellung abgeschlossen ist.
          kubectl wait kafka/instana --for=condition=Ready --timeout=300s -n instana-kafka
      3. Elasticsearch aktualisieren.
        1. Aktualisieren Sie den Operator „ Elasticsearch “. Wenn Sie im vorherigen Schritt einen Image-Pull-Secret erstellt haben, fügen Sie --set imagePullSecrets[0].name="<internal-image-registry-pull-secret>" zum folgenden Befehl hinzu.
          helm upgrade --install elastic-operator eck-operator-3.4.1.tgz -n instana-elastic --version=3.4.1 --set image.repository=<internal-image-registry>/operator/elasticsearch --set image.tag=3.4.1_v0.34.0
        2. Aktualisieren Sie die benutzerdefinierte Ressource „ Elasticsearch “.
          kubectl patch Elasticsearch instana -n instana-elastic --type='merge' -p '{"spec":{"image": "<internal-image-registry>/datastore/elasticsearch:8.19.18_v0.37.0"}}'
        3. Warten Sie, bis die Bereitstellung abgeschlossen ist.
          kubectl wait elasticsearch/instana --for=condition=ReconciliationComplete --timeout=300s -n instana-elastic
      4. CNPG aktualisieren Postgres.

        1. Für die Custom Edition auf einem Red Hat OpenShift -Cluster ermitteln Sie die Dateisystem-Gruppen-ID auf Red Hat OpenShift. Red Hat OpenShift erfordert, dass Dateisystemgruppen innerhalb eines für den Namespace spezifischen Wertebereichs liegen.

        2. Wenn Sie die Custom Edition auf einem Cluster „ Red Hat OpenShift “ bereitstellen, rufen Sie den zulässigen Benutzerbereich ab.
          kubectl get namespace instana-postgres -o yaml
          Es wird eine Ausgabe ähnlich dem folgenden Beispiel angezeigt:
          apiVersion: v1
kind: Namespace
metadata:
  annotations:
  .......
    openshift.io/sa.scc.uid-range: 1000750000/10000
  labels:
    kubernetes.io/metadata.name: instana-postgres
  .......
  name: instana-postgres

          Die openshift.io/sa.scc.supplemental-groups Anmerkung enthält den Bereich der zulässigen IDs. Der Bereich 1000750000/10000 gibt 10.000 Werte an, die mit der ID 1000750000 beginnen und einen ID-Bereich von 1000750000 bis 1000760000 haben. Im Beispiel wird der Wert 1000750000 als Dateisystem-Gruppen-ID verwendet.

        3. Postgres -Operator aktualisieren. Wenn Sie einen Image-Pull-Secret für Ihre interne Registry erstellt haben, fügen Sie --set image.imagePullSecrets[0].name="<internal-image-registry-pull-secret>" zum folgenden Befehl hinzu.

          helm upgrade --install cnpg cloudnative-pg-0.29.0.tgz --set image.repository=<internal-image-registry>/<internal-image-repository-path>/cloudnative-pg-operator --set image.tag=v1.29.2_v0.35.0 --version=0.29.0 -n instana-postgres
          # Applicable for Red Hat Open Shift clusters
helm upgrade --install cnpg cloudnative-pg-0.29.0.tgz --set image.repository=<internal-image-registry>/<internal-image-repository-path>/cloudnative-pg-operator --set image.tag=v1.29.2_v0.35.0 --version=0.29.0 --set containerSecurityContext.runAsUser=<UID from namespace> --set containerSecurityContext.runAsGroup=<UID from namespace> -n instana-postgres
        4. Postgres -Benutzerdefinierte Ressource aktualisieren:
          kubectl patch Cluster postgres -n instana-postgres --type='merge' -p '{"spec":{"imageName": "<internal-image-registry>/<internal-image-repository-path>/cnpg-containers:15_v0.40.0"}}'
      5. Cassandra aktualisieren.
        1. Installieren Sie den Operator „ Cassandra “. Wenn Sie im vorherigen Schritt einen Image-Pull-Secret erstellt haben, fügen Sie --set imagePullSecrets[0].name="<internal-image-registry-pull-secret>" zum folgenden Befehl hinzu.
          helm upgrade --install cass-operator cass-operator-0.64.4.tgz -n instana-cassandra --version=0.64.4 --set securityContext.runAsGroup=999 --set securityContext.runAsUser=999 --set image.registry=<internal-image-registry> --set image.repository=operator/cass-operator --set image.tag=1.30.3_v0.41.0 --set appVersion=1.30.3 --set imageConfig.systemLogger=<internal-image-registry>/datastore/system-logger:1.30.3_v0.24.0 --set imageConfig.k8ssandraClient=<internal-image-registry>/datastore/k8ssandra-client:0.8.14_v0.34.0
        2. Aktualisieren Sie die benutzerdefinierte Ressource „ Cassandra “.
          kubectl patch CassandraDatacenter cassandra -n instana-cassandra --type='merge' -p '{"spec":{"serverImage":"<internal-image-registry>/datastore/cassandra:4.1.11_v0.43.0","systemLoggerImage":"<internal-image-registry>/datastore/system-logger:1.30.3_v0.24.0","serverVersion":"4.1.11"}}'
        3. Erstellen Sie eine Datei, z. B clickhouse_installation.yaml.:
          kubectl patch clickhouseinstallation instana -n instana-clickhouse --type='strategic' -p='
spec:
  templates:
    podTemplates:
      -name: clickhouse
       spec:
         containers:
           - name: instana-clickhouse
             image: <internal-image-registry>/<internal-image-repository-path>/clickhouse:25.8.13.73-7-lts-ibm
           - name: clickhouse-log
             image: <internal-image-registry>/<internal-image-repository-path>/clickhouse:25.8.13.73-7-lts-ibm '
      6. ClickHouse aktualisieren.
        1. ClickHouse -Operator aktualisieren. Wenn Sie im vorherigen Schritt einen Image-Pull-Secret erstellt haben, fügen Sie --set imagePullSecrets[0].name="<internal-image-registry-pull-secret>" zum folgenden Befehl hinzu.
          helm upgrade --install clickhouse-operator ibm-clickhouse-operator-v1.2.0.tgz -n instana-clickhouse --version=v1.2.0 --set operator.image.repository=<internal-image-registry>/<internal-image-repository-path>/clickhouse-operator --set operator.image.tag=v1.2.39
        2. Aktualisieren Sie die benutzerdefinierte Ressource „ ClickHouseKeeperInstallation “.
          kubectl patch ClickHouseKeeperInstallation clickhouse-keeper -n instana-clickhouse --type='strategic' -p='
spec:
  templates:
    podTemplates:
      - name: clickhouse-keeper
        spec:
          containers:
      - name: clickhouse-keeper
        image: <internal-image-registry>/<internal-image-repository-path>/clickhouse:25.8.13.73-7-lts-ibm
initContainers:
      - name: server-id-injector
        image: <internal-image-registry>/<internal-image-repository-path>/clickhouse:25.8.13.73-7-lts-ibm '
        3. Erstellen Sie eine Datei, z. B clickhouse_installation.yaml.:
          kubectl patch clickhouseinstallation instana -n instana-clickhouse --type='strategic' -p='
spec:
  templates:
    podTemplates:
      - name: clickhouse
        spec:
          containers:
            - name: instana-clickhouse
              image: <internal-image-registry>/<internal-image-repository-path>/clickhouse:25.8.13.73-7-lts-ibm
            - name: clickhouse-log
              image: <internal-image-registry>/<internal-image-repository-path>/clickhouse:25.8.13.73-7-lts-ibm '
      7. Optional: Zookeeper aktualisieren. Führen Sie diese Schritte aus, um den Datenspeicher „ ZooKeeper “ zu aktualisieren, wenn Sie Zookeeper anstelle von Clickhousekeeper verwenden.
        1. Aktualisieren Sie den Operator „ ZooKeeper “.
          helm upgrade --install zookeeper-operator -n instana-zookeeper zookeeper-operator-1.0.0.tgz --set image.repository=<internal-image-registry>/operator/zookeeper --set image.tag=0.2.15_v0.21.0 --set global.imagePullSecrets={"instana-registry"}
          1. Aktualisieren Sie die Cluster-Ressource „ ZooKeeper “, indem Sie den folgenden Patch anwenden.
            kubectl patch zookeepercluster instana-zookeeper -n instana-clickhouse --type=merge --patch '
spec:
 image:
   tag: 3.9.3_v0.21.0
      '
      8. Optional: Aktualisieren Sie BeeInstana, siehe „Aktualisieren von BeeInstana “ auf Kubernetes.
  3. Installieren Sie das neueste Plug-in „ kubectl “, siehe
  4. Artefakte herunterladen und in die interne Bildregistrierung hochladen.
    1. Rufen Sie die Liste der Bilder auf dem Backend von Instana ab:
      kubectl instana versions list-images -d $DOWNLOAD_KEY
      Es wird eine Ausgabe ähnlich dem folgenden Beispiel angezeigt:
      artifact-public.instana.io/backend/acceptor:3.xxx.xxx-x
...
...
artifact-public.instana.io/backend/gateway:1.26.3_v0.46.0
artifact-public.instana.io/backend/config-templates:3.xxx.xxx-x
artifact-public.instana.io/infrastructure/instana-enterprise-operator:1.3.0
artifact-public.instana.io/infrastructure/instana-enterprise-operator-webhook:1.3.0

      • Der identify Befehl liefert eine Liste der derzeit verfügbaren Backend-Versionen von „ Instana “, die mit der installierten Custom Edition kompatibel sind.

      • Der list-images Befehl gibt eine Liste der Bilder des Operators „ InstanaKubernetes ” und aller Komponenten „ Instana ” aus. Sie können das --instana-version Flag verwenden, um die Operatorversion anzugeben. Wenn Sie das Flag nicht verwenden, werden alle verfügbaren Backend-Versionen von Instana aufgelistet, und Sie können dann eine Version auswählen.

    2. Export-Download-Schlüssel:
      export DOWNLOAD_KEY="<download_key>"

    3. Melden Sie sich bei der Registrierungsstelle „ Instana “ an:

      Hinweis:

      Führen Sie einen der folgenden Befehle aus, je nachdem, ob Sie „ Skopeo “ oder „ Docker “ verwenden.

      • Skopeo:
        skopeo login -u _ -p $DOWNLOAD_KEY artifact-public.instana.io
      • Docker:
        docker login -u _ -p $DOWNLOAD_KEY artifact-public.instana.io
    4. Melden Sie sich bei der internen Bildregistrierung an. Führen Sie einen der folgenden Schritte aus, je nachdem, ob Sie Skopeo oder Docker verwenden.
      • Skopeo:
        skopeo login -u <your_internal_artifactory_username> -p <your_internal_artifactory_password> <internal-image-registry>
      • Docker:
        docker login -u <your_internal_artifactory_username> -p <your_internal_artifactory_password> <internal-image-registry>

    5. Kopieren Sie die Backend- und Enterprise-Operator-Images von „ Instana “ von Ihrem Jump-Host in Ihre eigene interne Image-Registrierung. Führen Sie einen der folgenden Schritte aus, je nachdem, ob Sie Skopeo oder Docker verwenden.

      • Skopeo:
        while read p; do SOURCE=`echo "$p" | tac -s'/' | head -1`; echo $SOURCE; skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/backend/$SOURCE docker://<internal-image-registry>/$SOURCE; done<images.txt
OPERATOR_IMAGE=`echo "$(cat images.txt | tail -1)" | tac -s'/' |  head -1`
skopeo copy --dest-tls-verify=false docker://artifact-public.instana.io/infrastructure/$OPERATOR_IMAGE docker://<internal-image-registry>/$OPERATOR_IMAGE

      • Docker:

      1. Bilder ziehen:
        docker pull artifact-public.instana.io/backend/acceptor:3.xxx.xxx–x
docker pull artifact-public.instana.io/clickhouse-operator:v1.2.39
      2. Bilder neu taggen:
        docker tag artifact-public.instana.io/backend/acceptor:3.xxx.xxx–x <internal-image-registry>/backend/acceptor:3.xxx.xxx–x
docker tag artifact-public.instana.io/clickhouse-operator:v1.2.39 <internal-image-registry>/clickhouse-operator:v1.2.39
      3. Bilder hochladen:
        docker push <internal-image-registry>/backend/acceptor:3.xxx.xxx–x
docker push <internal-image-registry>/clickhouse-operator:v1.2.39

        Ändern Sie nicht den tatsächlichen Namen der Bilder. Ändern Sie nur die Artifactory- URL - und Pfadangaben. Wenn Sie beispielsweise ausführen kubectl instana versions list-images und der zurückgegebene Bildname lautet artifact-public.instana.io/backend/acceptor:3.xxx.xxx–x, müssen Sie das Bild im folgenden Format an Ihr internes Artifactory übertragen: <internal-image-registry>/<internal-image-repository-path>/acceptor:<tag_of_image>.

  5. Instana -Upgrade für Unternehmensbetreiber:

      1. Installieren Sie die Zielversion des Plug-ins „ Instanakubectl “. Das Plug-in „ Instana “ ( kubectl ) und der Operator „ Instana “ (Enterprise) werden gemeinsam versioniert. Installieren Sie daher die Plug-in-Version, die mit der Version des zu installierenden Operators übereinstimmt.

      2. Erstellen Sie eine Wertedatei, siehe Erstellen der Wertedatei.

      3. Fügen Sie die folgenden Zeilen zur Werte-Datei hinzu:
        operator:
  image:
    registry: <internal-image-registry>
webhook:
  image:
    registry: <internal-image-registry>
imagePullSecrets:
  - name: instana-registry
      4. Wenden Sie die Änderungen an:
        kubectl instana operator apply -n instana-operator --values <pathtoFile>/values.yaml
      5. Überprüfen Sie die Bereitstellung des Instana Enterprise-Operators:
        kubectl get all -n instana-operator

        Denken Sie immer daran, nach der Neugenerierung von Manifesten die interne Bildregistrierung in der Wertedatei festzulegen, um sicherzustellen, dass die Bilder korrekt aus Ihrer internen Registrierung abgerufen werden.

  6. Instana -Backend aktualisieren:
    Hinweis:
    Ab Build 1.0.0 können Sie das Backend „ Instana “ aktualisieren, sobald neue Versionen veröffentlicht werden. Alle Befehle verfügen über ein optionales Flag --download-key . Wenn Sie das Flag nicht angeben, wird der Download-Schlüssel der bestehenden Installation verwendet.
    1. Finden Sie die verfügbaren Backend-Versionen von „ Instana “, die mit der installierten Custom Edition kompatibel sind.
      kubectl instana versions identify

    2. Aktualisieren Sie die Backend-Version. Führen Sie einen der folgenden Schritte aus.

      • Wählen Sie eine Version zum Aktualisieren aus:
        kubectl instana versions update

        Alle unterstützten Upgrade-Versionen werden angezeigt. Sie können eine Version auswählen.

      • Geben Sie eine Version für das Upgrade an:
        kubectl instana versions update --instana-version 3.xxx.xxx-0
        Alternativ können Sie die Backend-Version, auf die Sie aktualisieren möchten, in der Core-Spezifikation konfigurieren und die Spezifikation wie im folgenden Beispiel gezeigt anwenden.
        ...
spec:
 imageConfig:
   tag: 3.xxx.xxx-0
...
    3. Überprüfen Sie das Backend-Upgrade von „ Instana “:
      kubectl get core -n instana-core
      kubectl get units -n instana-units