Installation de l'opérateur Enterprise d' Instana

Par défaut, cert-manager est utilisé pour provisionner automatiquement le secret. Cela fonctionne immédiatement si cert-manager est installé sur le cluster. Dans ce cas, les objets « Issuer » et « Certificate » sont créés lors de l'installation, ce qui déclenche la procédure de provisionnement et d'injection des certificats par l' cert-manager.

Pour plus d'informations sur l'installation d' cert-manager, consultez la documentation disponible à l'adresse cert-manager.

Nous vous recommandons d'utiliser cert-manager. Toutefois, si vous préférez mettre à disposition les certificats vous-même, vous pouvez le faire. Le secret doit contenir les entrées suivantes :

• ca.crt
• tls.crt
• tls.key

Le certificat (tls.crt) doit contenir les noms de système de noms de domaine suivants :

• instana-operator.<namespace>.svc
• instana-operator.<namespace>.svc.<clusterDomain>

• Remplacez <namespace> par le nom de l'espace de noms dans lequel l'opérateur Enterprise d' Instana sera installé.
• Remplacez <clusterDomain> par le nom de domaine du cluster sur lequel l'opérateur Instana Enterprise sera installé.

Pour créer un secret instana-operator-webhook de type kubernetes.io/tls« TLS », procédez de l'une des manières suivantes :

• Créez le secret directement.

  kubectl create secret generic instana-operator-webhook \
      --type=kubernetes.io/tls \
      --from-file=tls.key=path/to/tls.key \
      --from-file=tls.crt=path/to/tls.crt \
      --from-file=ca.crt=path/to/ca.crt
   

• Créez l' YAML e du mot de passe sans l'appliquer. Le secret est imprimé sans création.

  kubectl create secret generic instana-operator-webhook \
      --type=kubernetes.io/tls \
      --from-file=tls.key=path/to/tls.key \
      --from-file=tls.crt=path/to/tls.crt \
      --from-file=ca.crt=path/to/ca.crt \
      --dry-run=client \
      --output=yaml
   

  Ensuite, créez le secret.

  kubectl create -f <secret-file-name.yaml>
   

Assurez-vous que la configuration système requise pour l'édition personnalisée auto-hébergée, telle que décrite sur IBM Z® et LinuxONE ( s390x ), est respectée. Pour plus d'informations, consultez la section « Configuration système requise pour Custom Edition » sur IBM Z® et LinuxONE ( s390x ).

Pour installer Custom Edition sur IBM Z® et LinuxONE ( s390x ), ajoutez les lignes suivantes dans le fichier values.yaml operator :

operator:
  affinity:
    nodeAffinity:
      requiredDuringSchedulingIgnoredDuringExecution:
        nodeSelectorTerms:
        - matchExpressions:
          - key: node-role.kubernetes.io/monitor
            operator: In
            values:
            - "true"
  tolerations:
    - key: node.instana.io/monitor
      operator: "Exists"
      effect: "NoSchedule"
webhook:
  affinity:
    nodeAffinity:
      requiredDuringSchedulingIgnoredDuringExecution:
        nodeSelectorTerms:
        - matchExpressions:
          - key: node-role.kubernetes.io/monitor
            operator: In
            values:
            - "true"
  tolerations:
    - key: node.instana.io/monitor
      operator: "Exists"
      effect: "NoSchedule"
 

Cette option crée des définitions de ressources personnalisées et installe le déploiement de l'opérateur et des ressources associées sur le cluster Kubernetes.

• Pour installer l'opérateur Enterprise d' Instana. dans un espace de noms spécifique, tel que instana-operator, exécutez la commande suivante :

  kubectl instana operator apply --values values.yaml --namespace=instana-operator
   

• Pour installer l'opérateur Enterprise d' Instana dans un espace de noms spécifié à l'aide de certificats personnalisés, exécutez la commande suivante :

  kubectl instana operator apply --values values.yaml --ca-bundle-base64=<base64-encoded ca.crt file> --namespace=instana-operator
   

  Remplacez <base64-encoded ca.crt codé en base64 > par le nom du fichier de bundle de l'autorité de certification base64-encoded .

Rendez les manifestes et écrivez-les d'abord dans la sortie standard (STDOUT) ou dans les fichiers d'un répertoire spécifique. Pour afficher les manifestes, procédez comme suit:

• Pour générer les fichiers d' YAML s avec un espace de noms spécifié et les enregistrer dans un répertoire spécifié :

  kubectl instana operator template --values values.yaml --namespace=instana-operator --output-dir <dir>
   

• Pour traiter des fichiers « YAML » avec un espace de noms spécifié et les enregistrer dans un répertoire spécifié à l'aide d'un domaine de cluster personnalisé :

  kubectl instana operator template --values values.yaml --cluster-domain=my-domain.local --namespace=instana-operator --output-dir <dir>
   

• Pour générer des fichiers ` YAML ` avec un espace de noms spécifié et les enregistrer dans un répertoire donné à l'aide de certificats personnalisés :

  kubectl instana operator template --values values.yaml --ca-bundle-base64=<base64-encoded ca.crt file> --namespace=instana-operator --output-dir <dir>
   

  Remplacez <base64-encoded ca.crt codé en base64 > par le nom du fichier de bundle de l'autorité de certification base64-encoded .

Ensuite, vous pouvez appliquer les manifestes à l'aide des commandes de la rubrique Application directe des manifestes.

Le backend Instana est déployé avec une version de publication par défaut. Dans l'idéal, utilisez le dernier correctif disponible ou passez à une version plus récente du backend d' Instana.

Vous pouvez utiliser les instana-kubectlversions commandes pour mettre à jour le backend Instana. Pour plus d'informations, voir procédure de mise à niveau.

Les options disponibles que vous pouvez configurer sont répertoriées dans le tableau des options de configuration de l'opérateur d' Instana Enterprise.