4.2. cert-manager のインストール

手順

1. 次のコマンドを実行して、Jetstack チャートリポジトリーをローカル Helm リポジトリーに追加します。

   $ helm repo add jetstack https://charts.jetstack.io --force-update

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して istio-csr チャートをインストールします。

   $ helm upgrade cert-manager-istio-csr jetstack/cert-manager-istio-csr \
       --install \
       --namespace cert-manager \
       --wait \
       --set "app.tls.rootCAFile=/var/run/secrets/istio-csr/ca.pem" \
       --set "volumeMounts[0].name=root-ca" \
       --set "volumeMounts[0].mountPath=/var/run/secrets/istio-csr" \
       --set "volumes[0].name=root-ca" \
       --set "volumes[0].secret.secretName=istio-root-ca" \
       --set "app.istio.namespace=istio-system"

   Copy to Clipboard Toggle word wrap

手順

1. istio-csr デプロイメントにすべての Istio リビジョンを指定します。「istio-csr デプロイメント」を参照してください。

2. 次のコマンドを実行して、Jetstack チャートをローカル Helm リポジトリーに追加します。

   $ helm repo add jetstack https://charts.jetstack.io --force-update

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、リビジョン名で istio-csr チャートをインストールします。

   $ helm upgrade cert-manager-istio-csr jetstack/cert-manager-istio-csr \
       --install \
       --namespace cert-manager \
       --wait \
       --set "app.tls.rootCAFile=/var/run/secrets/istio-csr/ca.pem" \
       --set "volumeMounts[0].name=root-ca" \
       --set "volumeMounts[0].mountPath=/var/run/secrets/istio-csr" \
       --set "volumes[0].name=root-ca" \
       --set "volumes[0].secret.secretName=istio-root-ca" \
       --set "app.istio.namespace=istio-system" \
       --set "app.istio.revisions={default-v1-24-3}"

   Copy to Clipboard Toggle word wrap
   注記

   リビジョン名は、<istio-name>-v<major_version>-<minor_version>-<patch_version> という形式を使用します。例: default-v1-24-3

手順

1. 次の例に示すように、Istio オブジェクトを作成します。

   istio.yaml オブジェクトの例

   apiVersion: sailoperator.io/v1
   kind: Istio
   metadata:
     name: default
   spec:
     version: v1.24.3
     namespace: istio-system
     values:
       global:
         caAddress: cert-manager-istio-csr.cert-manager.svc:443
       pilot:
         env:
           ENABLE_CA_SERVER: "false"

   Copy to Clipboard Toggle word wrap

   注記

   リビジョンベースの更新ストラテジーを使用して CSR エージェントをインストールした場合は、Istio オブジェクト YAML に以下を追加する必要があります。

   kind: Istio
   metadata:
     name: default
   spec:
     updateStrategy:
       type: RevisionBased

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して Istio リソースを作成します。

   $ oc apply -f istio.yaml

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、Istio オブジェクトの準備が整うまで待ちます。

   $ oc wait --for=condition=Ready istios/default -n istio-system

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを実行して sample namespace を作成します。

   $ oc new-project sample

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、アクティブな Istio リビジョンを見つけます。

   $ oc get istios default -o jsonpath='{.status.activeRevisionName}'

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、アクティブなリビジョンのインジェクションラベルを sample namespace に追加します。

   $ oc label namespace sample istio.io/rev=<your-active-revision-name> --overwrite=true

   Copy to Clipboard Toggle word wrap

4. 次のコマンドを実行して、サンプル httpbin サービスをデプロイします。

   $ oc apply -n sample -f https://raw.githubusercontent.com/openshift-service-mesh/istio/refs/heads/master/samples/httpbin/httpbin.yaml

   Copy to Clipboard Toggle word wrap

5. 次のコマンドを実行して、サンプルの sleep アプリケーションをデプロイします。

   $ oc apply -n sample -f https://raw.githubusercontent.com/openshift-service-mesh/istio/refs/heads/master/samples/sleep/sleep.yaml

   Copy to Clipboard Toggle word wrap

6. 次のコマンドを実行して、両方のアプリケーションの準備が完了するまで待ちます。

   $ oc rollout status -n sample deployment httpbin sleep

   Copy to Clipboard Toggle word wrap

7. 次のコマンドを実行して、sleep アプリケーションが httpbin サービスにアクセスできることを確認します。

   $ oc exec "$(oc get pod -l app=sleep -n sample \
        -o jsonpath={.items..metadata.name})" -c sleep -n sample -- \
        curl http://httpbin.sample:8000/ip -s -o /dev/null \
        -w "%{http_code}\n"

   Copy to Clipboard Toggle word wrap

   成功した出力の例

   200

   Copy to Clipboard Toggle word wrap

8. 次のコマンドを実行して、httpbin サービスのワークロード証明書を出力し、その出力を確認します。

   $ istioctl proxy-config secret -n sample $(oc get pods -n sample -o jsonpath='{.items..metadata.name}' --selector app=httpbin) -o json | jq -r '.dynamicActiveSecrets[0].secret.tlsCertificate.certificateChain.inlineBytes' | base64 --decode | openssl x509 -text -noout

   Copy to Clipboard Toggle word wrap

   出力例

   ...
   Issuer: O = cert-manager + O = cluster.local, CN = istio-ca
   ...
   X509v3 Subject Alternative Name:
     URI:spiffe://cluster.local/ns/sample/sa/httpbin

   Copy to Clipboard Toggle word wrap