Tanzu Kubernetes クラスタでの組み込みの Harbor レジストリの使用

組み込みの Harbor レジストリを、Tanzu Kubernetes Grid サービスによってプロビジョニングされた Tanzu Kubernetes クラスタにデプロイするイメージのプライベートコンテナレジストリとして使用することができます。

vSphere with Tanzu には、スーパーバイザークラスタで有効にできる Harbor レジストリインスタンスが組み込まれていて、コンテナベースのワークロードを Tanzu Kubernetes クラスタにデプロイする場合に使用できます。

スーパーバイザークラスタで組み込みの Harbor レジストリが有効になっている場合は、Tanzu Kubernetes Grid サービスによって、レジストリインスタンスのルート CA 証明書が Tanzu Kubernetes クラスタノードにインストールされます。この証明書は、（調整ループを使用して）新しいクラスタと既存のクラスタの両方にインストールされます。クラスタ内のイメージを実行するには、ワークロード YAML 内でプライベートレジストリを指定します。

ワークフロー

次のワークフローを使用して、 Tanzu Kubernetes クラスタノードからプライベートレジストリに安全にアクセスし、コンテナイメージをプルします。

手順	操作	方法
0	Tanzu Kubernetes クラスタで組み込みの Harbor レジストリを使用する際のワークフローを確認します。	vSphere with Tanzu ワークロードに対するコンテナレジストリの使用を参照してください。
1	スーパーバイザークラスタで組み込みの Harbor レジストリを有効にします。	スーパーバイザークラスタの組み込み Harbor レジストリの有効化を参照してください。
2	レジストリサービスのシークレットを使用して、各クラスタの kubeconfig を構成します。	以下の手順を参照してください：組み込みの Harbor レジストリのイメージプルシークレットを使用した Tanzu Kubernetes クラスタの構成。
3	プライベートコンテナレジストリを指定するようにワークロード YAML を構成します。	以下の手順を参照してください：組み込みの Harbor レジストリのイメージプルシークレットを使用した Tanzu Kubernetes クラスタの構成。
4	組み込みの Harbor レジストリにイメージをプッシュするには、Docker クライアントを構成し、vSphere Docker 認証情報ヘルパーをインストールします。	組み込みの Harbor レジストリ証明書を使用した Docker クライアントの構成と組み込みの Harbor レジストリへのイメージのプッシュを参照してください。

組み込みの Harbor レジストリのイメージプルシークレットを使用した Tanzu Kubernetes クラスタの構成

イメージプルシークレットで kubeconfig を構成し、 Tanzu Kubernetes クラスタをプライベートコンテナレジストリ、組み込みの Harbor レジストリまたは外部プライベートレジストリに接続します。

スーパーバイザークラスタに接続します。vCenter Single Sign-On ユーザーとしてスーパーバイザークラスタに接続するを参照してください。
ターゲット Tanzu Kubernetes クラスタがプロビジョニングされている vSphere 名前空間にコンテキストを切り替えます。
```
kubectl config use-context tkgs-cluster-ns
```

vSphere 名前空間のイメージプルシークレットを取得して、ファイルに保存します。

kubectl get secret -n <vsphere-namespace> <vsphere-namespace>-default-image-pull-secret -o yaml > <path>/image-pull-secret.yaml

例：

kubectl get secret -n tkgs-cluster-ns tkgs-cluster-ns-default-image-pull-secret -o yaml > tanzu/image-pull-secret.yaml

テキストエディタで image-pull-secret.yaml を開きます。最小限必要な変更を行い、完了したらファイルを保存します。
```
apiVersion: v1
data:
  .dockerconfigjson: ewoJCQkJImF1dGhzJUV2s1ZVZwWVFuWmp...
kind: Secret
metadata:
  creationTimestamp: "2020-11-12T02:41:08Z"
  managedFields:
  - apiVersion: v1
    ...
  name: harbor-registry-secret   #OPTIONAL: Change if desired
  namespace: default           #REQUIRED: Enter the Kuberentes namespace
  ownerReferences:
  - apiVersion: registryagent.vmware.com/v1alpha1
    ...
  resourceVersion: "675868"
  selfLink: /api/v1/namespaces/tkgs-cluster-ns/secrets/tkgs-cluster-ns-default-image-pull-secret
  uid: 66606b41-7363-4b74-a3f2-4436f83f
type: kubernetes.io/dockerconfigjson
```
- 必須：namespace の値を、default など、クラスタ内の適切な Kubernetes 名前空間と一致するように変更します。
  注：イメージプルシークレットを構成するには、Kubernetes 名前空間を指定します。 Tanzu Kubernetes クラスタがすでに存在する場合は、コンテキストをそのクラスタに切り替えて kubectl get namespaces を実行し、使用可能な Kubernetes 名前空間を一覧表示します。必要な場合は、先にターゲット名前空間を作成してから続行します。 Tanzu Kubernetes クラスタが存在しない場合は、 default 名前空間を使用できます。
- オプション：name の値を harbor-registry-secret、private-registry-secret などの意味のある値に変更します。
Tanzu Kubernetes クラスタへのアクセスに使用可能な kubeconfig ファイルを作成します。
```
kubectl get secret -n <vsphere-namespace> <cluster-name>-kubeconfig -o jsonpath='{.data.value}' | base64 -d > <path>/cluster-kubeconfig
```
<vsphere-namespace> を、ターゲット Tanzu Kubernetes クラスタがプロビジョニングされている vSphere 名前空間の名前に置き換えます。 <cluster-name> を Tanzu Kubernetes クラスタの名前に置き換えます。
```
kubectl get secret -n tkgs-cluster-ns tkgs-cluster-5-kubeconfig -o jsonpath='{.data.value}' | base64 -d > tanzu/cluster-kubeconfig
```
Tanzu Kubernetes クラスタ内にレジストリサービスのシークレットを作成します。ローカルで保存および更新していたイメージプルシークレットファイルを参照します。
```
kubectl --kubeconfig=<path>/cluster-kubeconfig apply -f <path>/image-pull-secret.yaml
```
例：
```
kubectl --kubeconfig=tanzu/cluster-kubeconfig apply -f tanzu/image-pull-secret.yaml
```
レジストリサービスのシークレットが正常に作成されたことを確認します。
```
secret/harbor-registry-secret created
```

プライベートコンテナレジストリからイメージをプルするための Tanzu Kubernetes ワークロードの構成

Tanzu Kubernetes クラスタのワークロードのためにプライベートコンテナレジストリからイメージをプルするには、プライベートレジストリの詳細を使用してワークロード YAML を構成します。

この手順は、プライベートコンテナレジストリまたは組み込みの Harbor レジストリからイメージをプルする場合に使用できます。この例では、組み込みの Harbor レジストリに保存されているイメージを使用するポッド仕様を作成し、以前に構成したイメージプルシークレットを利用します。

プライベートレジストリの詳細を含むサンプルのポッド仕様を作成します。
```
apiVersion: v1
kind: Pod
metadata:
  name: <workload-name>
  namespace: <kubernetes-namespace>
spec:
  containers:
  - name: private-reg-container
    image: <Registry-IP-Address>/<vsphere-namespace>/<image-name>:<version>
  imagePullSecrets:
  - name: <registry-secret-name>
```
- <workload-name> をポッドワークロードの名前に置き換えます。
- <kubernetes-namespace> を、ポッドが作成されるクラスタ内の Kubernetes 名前空間に置き換えます。この名前空間は、レジストリサービスのイメージプルシークレットが格納されている、Tanzu Kubernetes クラスタ内の Kubernetes 名前空間（デフォルトの名前空間など）と同じにする必要があります。
- <Registry-IP-Address> を、スーパーバイザークラスタで実行されている組み込みの Harbor レジストリインスタンスの IP アドレスに置き換えます。
- <vsphere-namespace> を、ターゲット Tanzu Kubernetes がプロビジョニングされている vSphere 名前空間に置き換えます。
- <image-name> を、任意のイメージ名に置き換えます。
- <version> を、イメージの適切なバージョン（「最新」バージョンなど）に置き換えます。
- <registry-secret-name> を、以前に作成したレジストリサービスのイメージプルシークレットの名前に置き換えます。
定義したポッド仕様に基づいて、Tanzu Kubernetes クラスタ内にワークロードを作成します。
```
kubectl --kubeconfig=<path>/cluster-kubeconfig apply -f <pod.yaml>
```
ポッドは、レジストリからプルされたイメージに基づいて作成する必要があります。

ワークフロー

組み込みの Harbor レジストリ のイメージ プル シークレットを使用した Tanzu Kubernetes クラスタの構成

プライベート コンテナ レジストリからイメージをプルするための Tanzu Kubernetes ワークロードの構成

組み込みの Harbor レジストリのイメージプルシークレットを使用した Tanzu Kubernetes クラスタの構成

プライベートコンテナレジストリからイメージをプルするための Tanzu Kubernetes ワークロードの構成