Instana Enterpriseオペレーターのインストール

デフォルトでは、 cert-manager を使用してシークレットを自動的にプロビジョニングします。 クラスタに cert-manager がインストールされていれば、これはそのまま動作します。 この場合、インストール時に Issuer オブジェクトとCertificateオブジェクトが作成され、これにより cert-manager が証明書のプロビジョニングとインジェクションを行います。

cert-manager のインストールに関する詳細については、 cert-manager のドキュメントを参照してください。

cert-manager を使用することをお勧めします。 ただし、自分で証明書をプロビジョンしたい場合は、プロビジョンすることができます。 シークレットには、以下の項目が含まれている必要があります。

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

証明書 (tls.crt) には、以下の DNS 名が含まれている必要があります。

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

• <namespace> を、 Instana Enterprise オペレーターをインストールする名前空間の名前に置き換えてください。
• 「 <clusterDomain> 」を、 Instana Enterpriseオペレーターをインストールするクラスターのドメイン名に置き換えてください。

TLS のシークレット instana-operator-webhook （タイプ kubernetes.io/tls）を作成するには、次のいずれかの方法を使用します：

• シークレットを直接作成します。

  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
   

• 適用せずに、そのシークレット用の YAML を作成します。 秘密は作成されずに印刷されます。

  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
   

  次に、シークレットを作成します。

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

IBM Z® および LinuxONE ( s390x ) 上でセルフホスト型カスタムエディションを実行するためのシステム要件を満たしていることを確認してください。 詳細については、 IBM Z® および LinuxONE ( s390x ) の「Custom Edition のシステム要件 」をご覧ください。

IBM Z® および LinuxONE ( s390x ) に Custom Edition をインストールするには、operator ファイル values.yaml に以下の行を追加してください：

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"
 

このオプションでは、CRD を作成し、オペレーターのデプロイメントおよび関連するリソースを Kubernetes クラスターにインストールします。

• Instana Enterpriseオペレーターを、`` instana-operatorなどの指定されたネームスペースにインストールするには、次のコマンドを実行します：

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

• カスタム証明書を使用して、指定したネームスペースに Instana Enterpriseオペレーターをインストールするには、次のコマンドを実行します

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

  <base64-encoded ca.crt file> を base64-encoded CA バンドル・ファイル名に置き換えます。

マニフェストをレンダリングし、最初にそれらを標準出力 (STDOUT) または特定のディレクトリー内のファイルに書き込みます。 マニフェストをレンダリングするには、以下のステップのいずれかを実行します。

• 指定された名前空間で YAML ファイルをレンダリングし、指定されたディレクトリに書き出すには：

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

• カスタムクラスタドメインを使用して、指定された名前空間の YAML ファイルをレンダリングし、指定されたディレクトリに書き出すには：

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

• 指定した名前空間を持つ YAML ファイルをレンダリングし、カスタム証明書を使用して指定したディレクトリに書き出すには：

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

  <base64-encoded ca.crt file> を base64-encoded CA バンドル・ファイル名に置き換えます。

その後、 「マニフェストの直接適用」のコマンドを使用して、マニフェストを適用できます。

Instana のバックエンドは、デフォルトのリリースバージョンでデプロイされます。 可能であれば、最新のパッチリリースを使用するか、利用可能なより新しい Instana バックエンドバージョンに更新してください。

Instana のバックエンドをアップグレードするには、以下の versionsinstana-kubectl コマンドを使用できます。 詳しくはアップグレード手順をご覧ください。

設定可能なオプションは、「 Instana Enterprise オペレーター設定オプション」の表に記載されています。