Erstellen eines „ Postgres “-Datenspeichers auf Linux on Power ( ppc64le )

Tabelle 1. CNPG Postgres Operatorversionen und Bild-Tags

Plattform	Operatorversionen	Version des Helm-Diagramms	Image mit Tag
Linux® on Power® (ppc64le)	v1.29.1	0.28.2	artifact-public.instana.io/self-hosted-images/3rd-party/operator/cloudnative-pg: v1.29.1_v0.34.0 artifact-public.instana.io/self-hosted-images/3rd-party/datastore/cnpg-containers: 15_v0.39.0

Tabelle 2. Zalando Postgres Operatorversionen und Bild-Tags

Plattform	Operatorversionen	Version des Helm-Diagramms	Image mit Tag
Linux® on Power® (ppc64le)	1.10.0	v1.10.1	artifact-public.instana.io/self-hosted-images/3rd-party/operator/zalando: v1.10.0_v0.1.0 artifact-public.instana.io/self-hosted-images/3rd-party/datastore/zalando: 15.7_v0.1.0

Führen Sie die folgenden Schritte aus, um den Datenspeicher „ Postgres “ zu installieren.

1. Erstellen Sie den Namensbereich instana-postgres .

   kubectl create namespace instana-postgres
    

2. Erstellen Sie Bildzugriffsgeheimnisse für den Namensraum instana-postgres.

   kubectl create secret docker-registry instana-registry --namespace instana-postgres \
     --docker-username=_ \
     --docker-password=<download_key> \
     --docker-server=artifact-public.instana.io
    

3. Wenn Sie „ Postgres “ auf einem „ Red Hat® OpenShift® “-Cluster installieren, ermitteln Sie die Dateisystem-Gruppen-ID anhand des instana-postgres Namespace. Red Hat OpenShift erfordert, dass sich Dateisystemgruppen innerhalb eines für den Namensraum spezifischen Wertebereichs befinden.

   kubectl get namespace instana-postgres -o yaml
    

   Für den Befehl wird eine Ausgabe angezeigt, die dem folgenden Beispiel ähnelt:

   apiVersion: v1
   kind: Namespace
   metadata:
   annotations:
     .......
     openshift.io/sa.scc.uid-range: 1000750000/10000
     creationTimestamp: "2024-01-14T07:04:59Z"
   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 umfasst 10.000 Werte, beginnend mit der ID 1000750000, d. h. er gibt den Bereich der IDs von 1000750000 bis 1000760000an. In diesem Beispiel könnte der 1000750000 Wert als Dateisystem-Gruppen-ID (UID) verwendet werden.

4. Installieren Sie den Operator „ Postgres “. Verwenden Sie die UID aus dem vorherigen Schritt als im <UID from namespace> folgenden Befehl:

   helm install cnpg instana/cloudnative-pg --set image.repository=artifact-public.instana.io/self-hosted-images/3rd-party/operator/cloudnative-pg --set image.tag=v1.29.1_v0.34.0 --version=0.28.2 --set imagePullSecrets[0].name=instana-registry --set containerSecurityContext.runAsUser=<UID from namespace> --set containerSecurityContext.runAsGroup=<UID from namespace> -n instana-postgres
    

5. Erstellen Sie ein Passwort unter base64. Notieren Sie sich das Passwort. Das musst du später in der config.yaml Datei speichern.

   openssl rand -base64 24 | tr -cd 'a-zA-Z0-9' | head -c32; echo
    

6. Erstellen Sie eine Ressource vom Typ Secret unter Verwendung des Passworts, das Sie im vorherigen Befehl erhalten haben.

   kind: Secret
   apiVersion: v1
   metadata:
     name: instanaadmin
   type: Opaque
   stringData:
     username: instanaadmin
     password: <user-generate-password>
    

7. Erstellen Sie den geheimen Schlüssel „ Postgres “.

   kubectl apply -f postgres-secret.yaml -n instana-postgres
    

8. Erstellen Sie eine Datei namens „ YAML “, beispielsweise mit der Clusterkonfiguration postgres.yaml „ Postgres “.

   apiVersion: postgresql.cnpg.io/v1
   kind: Cluster
   metadata:
     name: postgres
   spec:
     instances: 3
     imageName: artifact-public.instana.io/self-hosted-images/3rd-party/datastore/cnpg-containers:15_v0.39.0
     imagePullPolicy: IfNotPresent
     imagePullSecrets:
       - name: instana-registry
     postgresql:
       parameters:
         shared_buffers: 32MB
         pg_stat_statements.track: all
         auto_explain.log_min_duration: '10s'
       pg_hba:
         - local     all          all                            trust
         - host      all          all          0.0.0.0/0         md5
         - local     replication  standby                        trust
         - hostssl   replication  standby      all               md5
         - hostnossl all          all          all               reject
         - hostssl   all          all          all               md5
     managed:
       roles:
       - name: instanaadmin
         login: true
         superuser: true
         createdb: true
         createrole: true
         passwordSecret:
           name: instanaadmin
     bootstrap:
       initdb:
         database: instanaadmin
         owner: instanaadmin
         secret:
           name: instanaadmin
     superuserSecret:
       name: instanaadmin
     storage:
       size: 1Gi
     #    storageClass: "Optional"
    

9. Führen Sie die Schritte unter Postgres (online und offline)aus.

Führen Sie die folgenden Schritte aus, um den Operator „ Zalando “ Postgres online bereitzustellen:

1. Wenn Sie einen „ Red Hat OpenShift “-Cluster verwenden, erstellen Sie „Security Context Constraints“ (SCC), bevor Sie den „ Postgres “-Operator bereitstellen.

   1. Erstellen Sie eine Datei „ YAML “, beispielsweise postgres-scc.yamlmit der SCC-Ressourcendefinition.

      apiVersion: security.openshift.io/v1
      kind: SecurityContextConstraints
      metadata:
        name: postgres-scc
      runAsUser:
        type: MustRunAs
        uid: 101
      seLinuxContext:
        type: RunAsAny
      fsGroup:
        type: RunAsAny
      allowHostDirVolumePlugin: false
      allowHostNetwork: true
      allowHostPorts: true
      allowPrivilegedContainer: false
      allowHostIPC: true
      allowHostPID: true
      readOnlyRootFilesystem: false
      users:
        - system:serviceaccount:instana-postgres:postgres-operator
        - system:serviceaccount:instana-postgres:postgres-pod
        - system:serviceaccount:instana-postgres:default
       

   2. Erstellen Sie die SCC-Ressource.

      kubectl apply -f postgres-scc.yaml
       

2. Installieren Sie den Operator „ Postgres “.

   1. Erstellen Sie den Namensbereich instana-postgres .

      kubectl create namespace instana-postgres
       

   2. Erstellen Sie Bildzugriffsgeheimnisse für den Namensraum instana-postgres. Ersetzen Sie im folgenden Befehl den Wert <download_key> durch Ihren Agentenschlüssel.

      kubectl create secret docker-registry instana-registry --namespace instana-postgres \
        --docker-username=_ \
        --docker-password=<download_key> \
        --docker-server=artifact-public.instana.io
       

   3. Erstellen Sie eine Datei, zum Beispiel mit der Konfiguration „ Postgresvalues.yaml“.

      configGeneral:
        kubernetes_use_configmaps: true
      securityContext:
        runAsUser: 101
      image:
        registry: artifact-public.instana.io
        repository: self-hosted-images/3rd-party/operator/zalando
        tag: v1.10.0_v0.1.0
      imagePullSecrets:
        - name: instana-registry
      configKubernetes:
        pod_service_account_definition: |
          apiVersion: v1
          kind: ServiceAccount
          metadata:
            name: postgres-pod
          imagePullSecrets:
            - name: instana-registry
      podServiceAccount:
        name: postgres-pod
       

   4. Installieren Sie den Operator „ Postgres “.

      helm install postgres-operator instana/postgres-operator --version=v1.10.1 -f values.yaml -n instana-postgres
       

3. Erstellen Sie eine Datei, z. B. postgres.yaml, mit der Ressourcendefinition postgresql .

   apiVersion: "acid.zalan.do/v1"
   kind: postgresql
   metadata:
     name: postgres
   spec:
     patroni:
       pg_hba:
         - local     all          all                            trust
         - host      all          all          0.0.0.0/0         trust
         - local     replication  standby                        trust
         - hostssl   replication  standby      all               trust
         - hostnossl all          all          all               reject
         - hostssl   all          all          all               trust
     dockerImage: artifact-public.instana.io/self-hosted-images/3rd-party/datastore/zalando:15.7_v0.1.0
     teamId: instana
     numberOfInstances: 3
     postgresql:
       version: "15"
       parameters:  # Expert section
         shared_buffers: "32MB"
     volume:
       size: 10Gi
       # Uncomment the following line to specify your own storage class, otherwise use the default.
       # storageClass: <REPLACE>
    

   1. Führen Sie die Schritte unter Postgres (online und offline)aus.

Wenn Sie die Postgres -Images noch nicht aus der externen Registry extrahiert haben, als Sie für die Installation vorbereitethaben, können Sie sie jetzt extrahieren. Führen Sie die folgenden Befehle auf Ihrem Bastionshost aus: Kopieren Sie die Bilder anschließend auf Ihren „ Instana “-Host, der sich in Ihrer Air-Gapped-Umgebung befindet.

docker pull artifact-public.instana.io/self-hosted-images/3rd-party/operator/cloudnative-pg:v1.29.1_v0.34.0
docker pull artifact-public.instana.io/self-hosted-images/3rd-party/datastore/cnpg-containers:15_v0.39.0
            

Führen Sie die folgenden Schritte auf Ihrem „ Instana “-Host aus.

1. Versehen Sie die Images erneut mit Ihrer internen Image-Registry.

   docker tag artifact-public.instana.io/self-hosted-images/3rd-party/operator/cloudnative-pg:v1.29.1_v0.34.0 <internal-image-registry>/operator/cloudnative-pg:v1.29.1_v0.34.0
   docker tag artifact-public.instana.io/self-hosted-images/3rd-party/datastore/cnpg-containers:15_v0.39.0 <internal-image-registry>/datastore/cnpg-containers:15_v0.39.0
                     

2. Übertragen Sie die Images mit Push-Operation in Ihre interne Image-Registry auf Ihrem Bastionshost.

   docker push <internal-image-registry>/operator/cloudnative-pg:v1.29.1_v0.34.0
   docker push <internal-image-registry>/datastore/cnpg-containers:15_v0.39.0
                     

3. Erstellen Sie den Namensbereich instana-postgres .

   kubectl create namespace instana-postgres
    

4. Optional: Erstellen Sie ein Bildabrufgeheimnis, wenn Ihre interne Bildregistrierung eine Authentifizierung erfordert.

   kubectl create secret docker-registry <secret_name> --namespace instana-postgres \
   --docker-username=<registry_username> \
   --docker-password=<registry_password> \
   --docker-server=<internal-image-registry>:<internal-image-registry-port> \
   --docker-email=<registry_email>
    

5. Wenn Sie „ Postgres “ auf einem „ Red Hat® OpenShift® “-Cluster installieren, ermitteln Sie die Dateisystem-Gruppen-ID anhand des instana-postgres Namespace. Red Hat OpenShift erfordert, dass sich Dateisystemgruppen innerhalb eines für den Namensraum spezifischen Wertebereichs befinden.

   kubectl get namespace instana-postgres -o yaml
    

   Für den Befehl wird eine Ausgabe angezeigt, die dem folgenden Beispiel ähnelt:

   apiVersion: v1
   kind: Namespace
   metadata:
   annotations:
     .......
     openshift.io/sa.scc.uid-range: 1000750000/10000
     creationTimestamp: "2024-01-14T07:04:59Z"
   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 umfasst 10.000 Werte, beginnend mit der ID 1000750000, d. h. er gibt den Bereich der IDs von 1000750000 bis 1000760000an. In diesem Beispiel könnte der 1000750000 Wert als Dateisystem-Gruppen-ID (UID) verwendet werden.

6. Installieren Sie den Operator „ Postgres “. Ersetzen Sie im folgenden Befehl den Wert <download_key> durch Ihren eigenen Agentenschlüssel. Wenn Sie ein Image-Pull-Secret für Ihr internes Registry erstellt haben, fügen Sie --docker-server=<internal-image-registry>:<internal-image-registry-port> zum folgenden Befehl hinzu.

   • Red Hat OpenShift Cluster

     Verwenden Sie die UID aus dem vorherigen Schritt in <UID from namespace> den folgenden Befehlen:

     helm install cnpg cloudnative-pg-1.28.0.tgz --set image.repository=image-registry.openshift-image-registry.svc:5000/instana-postgres/cloudnative-pg-operator --set image.tag=v1.29.1_v0.34.0 --version=0.28.2 --set containerSecurityContext.runAsUser=<UID from namespace> --set containerSecurityContext.runAsGroup=<UID from namespace> -n instana-postgres
      

   • Kubernetes-Cluster

     helm install cnpg cloudnative-pg-operator --set image.repository=<internal-image-registry>/operator/cloudnative-pg --set image.tag=v1.29.1_v0.34.0 --version=0.28.2 -n instana-postgres
      

7. Erstellen Sie ein Passwort unter base64. Notieren Sie sich das Passwort. Das musst du später in der config.yaml Datei speichern.

   openssl rand -base64 24 | tr -cd 'a-zA-Z0-9' | head -c32; echo
    

8. Erstellen Sie eine Ressource vom Typ Secret unter Verwendung des Passworts, das Sie im vorherigen Befehl erhalten haben.

   kind: Secret
   apiVersion: v1
   metadata:
     name: instanaadmin
   type: Opaque
   stringData:
     username: instanaadmin
     password: <user-generate-password>
    

9. Erstellen Sie den geheimen Schlüssel „ Postgres “.

   kubectl apply -f postgres-secret.yaml -n instana-postgres
    

10. Erstellen Sie eine Datei namens „ YAML “, beispielsweise mit der Clusterkonfiguration postgres.yaml „ Postgres “.

    apiVersion: postgresql.cnpg.io/v1
    kind: Cluster
    metadata:
      name: postgres
    spec:
      instances: 3
      imageName: <internal-image-registry>/datastore/cnpg-containers:15_v0.39.0
      imagePullPolicy: IfNotPresent
     # Optional: if you created an image pull secret for your internal registry, uncomment the following lines and update the image pull secret information.
     # imagePullSecrets:
     #   - name: <internal-image-registry-pull-secret>
      postgresql:
        parameters:
          shared_buffers: 32MB
          pg_stat_statements.track: all
          auto_explain.log_min_duration: '10s'
        pg_hba:
          - local     all          all                            trust
          - host      all          all          0.0.0.0/0         md5
          - local     replication  standby                        trust
          - hostssl   replication  standby      all               md5
          - hostnossl all          all          all               reject
          - hostssl   all          all          all               md5
      managed:
        roles:
        - name: instanaadmin
          login: true
          superuser: true
          createdb: true
          createrole: true
          passwordSecret:
            name: instanaadmin
      bootstrap:
        initdb:
          database: instanaadmin
          owner: instanaadmin
          secret:
            name: instanaadmin
      superuserSecret:
        name: instanaadmin
      storage:
        size: 1Gi
      #    storageClass: "Optional"
     

11. Führen Sie die Schritte unter Postgres (online und offline)aus.

Wenn Sie einen „ Red Hat OpenShift “-Cluster verwenden, erstellen Sie „Security Context Constraints“, bevor Sie den „ Postgres “-Operator bereitstellen.

1. Erstellen Sie eine Datei „ YAML “, beispielsweise postgres-scc.yamlmit der SCC-Ressourcendefinition.

   apiVersion: security.openshift.io/v1
   kind: SecurityContextConstraints
   metadata:
     name: postgres-scc
   runAsUser:
     type: MustRunAs
     uid: 101
   seLinuxContext:
     type: RunAsAny
   fsGroup:
     type: RunAsAny
   allowHostDirVolumePlugin: false
   allowHostNetwork: true
   allowHostPorts: true
   allowPrivilegedContainer: false
   allowHostIPC: true
   allowHostPID: true
   readOnlyRootFilesystem: false
   users:
     - system:serviceaccount:instana-postgres:postgres-operator
     - system:serviceaccount:instana-postgres:postgres-pod
     - system:serviceaccount:instana-postgres:default
    

2. Erstellen Sie die SCC-Ressource.

   kubectl apply -f postgres-scc.yaml
    

Fahren Sie anschließend mit der Installation des Operators Postgres fort.

Wenn Sie die Postgres -Images noch nicht aus der externen Registry extrahiert haben, als Sie für die Installation vorbereitethaben, können Sie sie jetzt extrahieren. Führen Sie die folgenden Befehle auf Ihrem Bastionshost aus: Kopieren Sie die Bilder anschließend auf Ihren „ Instana “-Host, der sich in Ihrer Air-Gapped-Umgebung befindet.

docker pull artifact-public.instana.io/self-hosted-images/3rd-party/operator/zalando:v1.10.0_v0.1.0
docker pull artifact-public.instana.io/self-hosted-images/3rd-party/datastore/zalando:15.7_v0.1.0
            

Führen Sie die folgenden Schritte auf Ihrem „ Instana “-Host aus.

1. Versehen Sie die Images erneut mit Ihrer internen Image-Registry.

   docker tag artifact-public.instana.io/self-hosted-images/3rd-party/operator/zalando:v1.10.0_v0.1.0 <internal-image-registry>/self-hosted-images/3rd-party/operator/zalando:v1.10.0_v0.1.0
   docker tag artifact-public.instana.io/self-hosted-images/3rd-party/datastore/zalando:15.7_v0.1.0 <internal-image-registry>/self-hosted-images/3rd-party/datastore/zalando:15.7_v0.1.0
                     

2. Übertragen Sie die Images mit Push-Operation in Ihre interne Image-Registry auf Ihrem Bastionshost.

   docker push <internal-image-registry>/self-hosted-images/3rd-party/operator/zalando:v1.10.0_v0.1.0
   docker push <internal-image-registry>/self-hosted-images/3rd-party/datastore/zalando:15.7_v0.1.0
                     

3. Erstellen Sie eine Datei, zum Beispiel mit der Konfiguration „ Postgresvalues.yaml“.

   configGeneral:
     kubernetes_use_configmaps: true
   securityContext:
     runAsUser: 101
   image:
     registry: <internal-image-registry>
     repository: self-hosted-images/3rd-party/operator/zalando
     tag: v1.10.0_v0.1.0
   imagePullSecrets:
     - name: instana-registry
   configKubernetes:
     pod_service_account_definition: |
       apiVersion: v1
       kind: ServiceAccount
       metadata:
         name: postgres-pod
       imagePullSecrets:
         - name: instana-registry
   podServiceAccount:
     name: postgres-pod
    

4. Erstellen Sie den Namensbereich instana-postgres .

   kubectl create namespace instana-postgres
    

5. Optional: Erstellen Sie ein Bildabrufgeheimnis, wenn Ihre interne Bildregistrierung eine Authentifizierung erfordert.

   kubectl create secret docker-registry <secret_name> --namespace instana-postgres \
   --docker-username=<registry_username> \
   --docker-password=<registry_password> \
   --docker-server=<internal-image-registry>:<internal-image-registry-port> \
   --docker-email=<registry_email>
    

6. Installieren Sie den Operator „ Postgres “. Wenn Sie im vorherigen Schritt ein Bildzugriffsgeheimnis erstellt haben, fügen Sie --set imagePullSecrets[0].name="<internal-image-registry-pull-secret>" zum folgenden Befehl hinzu.

   helm install postgres-operator postgres-operator-ppc64le-1.10.0.tgz --version=1.10.0 --set configGeneral.kubernetes_use_configmaps=true --set securityContext.runAsUser=101 --namespace=instana-postgres --set image.registry=<internal-image-registry>  --set image.repository=ppc64le-oss/postgres-operator-ppc64le --set image.tag=v1.10.0_v0.1.0
                     

7. Erstellen Sie eine Datei, z. B. postgres.yaml, mit der Ressourcendefinition postgresql .

   apiVersion: "acid.zalan.do/v1"
   kind: postgresql
   metadata:
     name: postgres
   spec:
     patroni:
       pg_hba:
         - local     all          all                            trust
         - host      all          all          0.0.0.0/0         trust
         - local     replication  standby                        trust
         - hostssl   replication  standby      all               trust
         - hostnossl all          all          all               reject
         - hostssl   all          all          all               trust
     dockerImage: <internal-image-registry>/self-hosted-images/3rd-party/datastore/zalando:15.7_v0.1.0
     teamId: instana
     numberOfInstances: 3
     postgresql:
       version: "15"
       parameters:  # Expert section
         shared_buffers: "32MB"
     volume:
       size: 10Gi
       # Uncomment the line below to specify your own storage class, otherwise use the default.
       # storageClass: <REPLACE>
    

8. Führen Sie die Schritte unter Postgres (online und offline)aus.