4.4. 非ベアメタルエージェントマシンへの Hosted Control Plane のデプロイ

手順

1. 次のコマンドを入力して、Hosted Control Plane namespace を作成します。

   $ oc create ns <hosted_cluster_namespace>-<hosted_cluster_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   <hosted_cluster_namespace> を、ホステッドクラスターの namespace 名 (例: clusters) に置き換えます。<hosted_cluster_name> は、ホステッドクラスターの名前に置き換えます。

2. 次のコマンドを入力して、ホステッドクラスターを作成します。

   $ hcp create cluster agent \
     --name=<hosted_cluster_name> \

   1

   
     --pull-secret=<path_to_pull_secret> \

   2

   
     --agent-namespace=<hosted_control_plane_namespace> \

   3

   
     --base-domain=<basedomain> \

   4

   
     --api-server-address=api.<hosted_cluster_name>.<basedomain> \

   5

   
     --etcd-storage-class=<etcd_storage_class> \

   6

   
     --ssh-key  <path_to_ssh_key> \

   7

   
     --namespace <hosted_cluster_namespace> \

   8

   
     --control-plane-availability-policy HighlyAvailable \

   9

   
     --release-image=quay.io/openshift-release-dev/ocp-release:<ocp_release> \

   10

   
     --node-pool-replicas <node_pool_replica_count> 

   11

   Copy to Clipboard Toggle word wrap

   1

   ホステッドクラスターの名前を指定します (例: example)。

   2

   プルシークレットへのパスを指定します (例: /user/name/pullsecret)。

   3

   Hosted Control Plane namespace を指定します (例: clusters-example)。oc get agent -n <hosted-control-plane-namespace> コマンドを使用して、この namespace でエージェントが使用可能であることを確認します。

   4

   ベースドメインを指定します (例: krnl.es)。

   5

   --api-server-address フラグは、ホステッドクラスター内の Kubernetes API 通信に使用される IP アドレスを定義します。--api-server-address フラグを設定しない場合は、管理クラスターに接続するためにログインする必要があります。

   6

   クラスターにデフォルトのストレージクラスが設定されていることを確認します。設定されていない場合は、PVC が保留になる可能性があります。etcd ストレージクラス名を指定します (例: lvm-storageclass)。

   7

   SSH 公開鍵へのパスを指定します。デフォルトのファイルパスは ~/.ssh/id_rsa.pub です。

   8

   ホステッドクラスターの namespace を指定します。

   9

   Hosted Control Plane コンポーネントの可用性ポリシーを指定します。サポートされているオプションは SingleReplica と HighlyAvailable です。デフォルト値は HighlyAvailable です。

   10

   使用するサポート対象の OpenShift Container Platform バージョンを指定します (例: 4.19.0-multi)。

   11

   ノードプールのレプリカ数を指定します (例: 3)。同じ数のレプリカを作成するには、レプリカ数を 0 以上に指定する必要があります。それ以外の場合、ノードプールは作成されません。

手順

1. 次のコマンドを入力して、新しいホステッドクラスターの kubeconfig ファイルを取得します。

   $ oc extract -n <hosted_cluster_namespace> \
     secret/<hosted_cluster_name>-admin-kubeconfig --to=- \
     > kubeconfig-<hosted_cluster_name>

   Copy to Clipboard Toggle word wrap

2. kubeconfig ファイルを使用して、ホステッドクラスターのクラスター Operator を表示します。以下のコマンドを入力します。

   $ oc get co --kubeconfig=kubeconfig-<hosted_cluster_name>

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                       VERSION   AVAILABLE   PROGRESSING   DEGRADED   SINCE   MESSAGE
   console                                    4.10.26   True        False         False      2m38s
   csi-snapshot-controller                    4.10.26   True        False         False      4m3s
   dns                                        4.10.26   True        False         False      2m52s

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを入力して、ホステッドクラスター上で実行中の Pod を表示します。

   $ oc get pods -A --kubeconfig=kubeconfig-<hosted_cluster_name>

   Copy to Clipboard Toggle word wrap

   出力例

   NAMESPACE                                          NAME                                                      READY   STATUS             RESTARTS        AGE
   kube-system                                        konnectivity-agent-khlqv                                  0/1     Running            0               3m52s
   openshift-cluster-samples-operator                 cluster-samples-operator-6b5bcb9dff-kpnbc                 2/2     Running            0               20m
   openshift-monitoring                               alertmanager-main-0                                       6/6     Running            0               100s
   openshift-monitoring                               openshift-state-metrics-677b9fb74f-qqp6g                  3/3     Running            0               104s

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを入力して、カスタム証明書でシークレットを作成します。

   $ oc create secret tls sample-hosted-kas-custom-cert \
     --cert=path/to/cert.crt \
     --key=path/to/key.key \
     -n <hosted_cluster_namespace>

   Copy to Clipboard Toggle word wrap

2. 以下の例のように、カスタム証明書の詳細を使用して HostedCluster 設定を更新します。

   spec:
     configuration:
       apiServer:
         servingCerts:
           namedCertificates:
           - names: 

   1

   
             - api-custom-cert-sample-hosted.sample-hosted.example.com
             servingCertificate: 

   2

   
               name: sample-hosted-kas-custom-cert

   Copy to Clipboard Toggle word wrap

   1

   証明書が有効な DNS 名のリスト。

   2

   カスタム証明書を含むシークレットの名前。

3. 次のコマンドを入力して、HostedCluster 設定に変更を適用します。

   $ oc apply -f <hosted_cluster_config>.yaml

   Copy to Clipboard Toggle word wrap