カスタム・イメージを使用したワーカー・ノードでのUbuntuの実行

管理対象ノードのcloud-initスクリプトの作成

管理対象ノードでUbuntuを実行するcloud-initスクリプトを作成するには:

1. cloud-initでサポートされているファイル・タイプ(.yamlなど)を使用して新しいcloud-initスクリプト・ファイルを最初から作成し、次のロジックをスクリプト・ファイルに追加します。

   #cloud-config
   apt:
    sources:
      oke-node: {source: 'deb [trusted=yes] <download-url>}
   packages:                                                       
    - <oci-package-name>
   runcmd:
    - oke bootstrap

   ここでは:

   • <download-url>は、前のステップで作成したUbuntuノード・パッケージをダウンロードするURLです(ステップ2: Ubuntuノード・パッケージをダウンロードするURLの構成を参照)。たとえば、https://objectstorage.us-sanjose-1.oraclecloud.com/p/45eOeErEDZqPGiymXZwpeebCNb5lnwzkcQIhtVf6iOF44eet_efdePaF7T8agNYq/n/odx-oke/b/okn-repositories-private/o/prod/ubuntu-jammy/kubernetes-1.29 stable mainです。
   • <oci-package-name>は、管理対象ノードで実行するKubernetesのバージョンに従って、次のいずれかです:
     • oci-oke-node-all-1.27.10
     • oci-oke-node-all-1.28.10
     • oci-oke-node-all-1.29.1

     Kubernetesマイナー・バージョンは、ダウンロードURLの構築時に指定したKubernetesマイナー・バージョンと一致する必要があります(ステップ2: Ubuntuノード・パッケージのダウンロード元のURLの構成を参照)。

   たとえば、管理対象ノードでUbuntu 22.04 (jammy)およびKubernetesバージョン1.29.1を実行する場合は、次のロジックをスクリプト・ファイルに追加します:

   #cloud-config
   apt:
    sources:
      oke-node: {source: 'deb [trusted=yes] https://objectstorage.us-sanjose-1.oraclecloud.com/p/45eOeErEDZqPGiymXZwpeebCNb5lnwzkcQIhtVf6iOF44eet_efdePaF7T8agNYq/n/odx-oke/b/okn-repositories-private/o/prod/ubuntu-jammy/kubernetes-1.29 stable main}
   packages:                                                       
    - oci-oke-node-all-1.29.1
   runcmd:
    - oke bootstrap

2. cloud-initスクリプト・ファイルを保存します。

自己管理ノードのcloud-initスクリプトの作成

自己管理ノードでUbuntuを実行するcloud-initスクリプトを作成するには:

1. 自己管理ノード用のCloud-initスクリプトの作成の手順に従って、コンソールまたはCLIを使用して、自己管理ノードを追加する拡張クラスタのKubernetes APIプライベート・エンドポイントを取得します。
2. 自己管理ノード用のCloud-initスクリプトの作成の手順に従って、コンソールまたはCLIを使用して、クラスタのkubeconfigファイルからクラスタのbase64エンコードCA証明書を取得します。
3. cloud-initでサポートされているファイル・タイプ(.yamlなど)を使用して新しいcloud-initスクリプト・ファイルを最初から作成し、次のロジックをスクリプト・ファイルに追加します。

   #cloud-config
   apt:
    sources:
      oke-node: {source: 'deb [trusted=yes] <download-url>}
   packages:
    - <oci-package-name>
   write_files:
   - path: /etc/oke/oke-apiserver
    permissions: '0644'
    content: <cluster-endpoint>
   - encoding: b64
    path: /etc/kubernetes/ca.crt
    permissions: '0644'
    content: <base64-encoded-certificate>
   runcmd:
     - oke bootstrap --ca <base64-encoded-certificate> --apiserver-host <cluster-endpoint>

   ここでは:

   • <download-url>は、前のステップで作成したUbuntuノード・パッケージをダウンロードするURLです(ステップ2: Ubuntuノード・パッケージをダウンロードするURLの構成を参照)。たとえば、https://objectstorage.us-sanjose-1.oraclecloud.com/p/45eOeErEDZqPGiymXZwpeebCNb5lnwzkcQIhtVf6iOF44eet_efdePaF7T8agNYq/n/odx-oke/b/okn-repositories-private/o/prod/ubuntu-jammy/kubernetes-1.29 stable mainです。

   • <oci-package-name>は、自己管理ノードで実行するKubernetesのバージョンに従って、次のいずれかです:

     • oci-oke-node-all-1.27.10
     • oci-oke-node-all-1.28.10
     • oci-oke-node-all-1.29.1

     Kubernetesマイナー・バージョンは、ダウンロードURLの構築時に指定したKubernetesマイナー・バージョンと一致する必要があります(ステップ2: Ubuntuノード・パッケージのダウンロード元のURLの構成を参照)。

   • <cluster-endpoint>は、以前に取得したクラスタのKubernetes APIエンドポイントのIPアドレスです。
   • <base64-encoded-certificate>は、以前に取得したクラスタのbase64でエンコードされたCA証明書です(文字LS0tから開始)。

   たとえば、Ubuntu 22.04 (Jammy)およびKubernetesバージョン1.29.1を自己管理ノードで実行する場合は、次のロジックをスクリプト・ファイルに追加します。

   #cloud-config
   apt:
    sources:
      oke-node: {source: 'deb [trusted=yes] https://objectstorage.us-sanjose-1.oraclecloud.com/p/45eOeErEDZqPGiymXZwpeebCNb5lnwzkcQIhtVf6iOF44eet_efdePaF7T8agNYq/n/odx-oke/b/okn-repositories-private/o/prod/ubuntu-jammy/kubernetes-1.29 stable main}
   packages:
    - oci-oke-node-all-1.29.1
   write_files:
   - path: /etc/oke/oke-apiserver
    permissions: '0644'
    content: 10.114.0.5
   - encoding: b64
    path: /etc/kubernetes/ca.crt
    permissions: '0644'
    content: LS0tLS1...LS0tCg==
   runcmd:
     - oke bootstrap --ca LS0tLS1...LS0tCg== --apiserver-host 10.114.0.5

4. cloud-initスクリプト・ファイルを保存します。

Ubuntuワーカー・ノードを管理対象ノードとして追加しています

既存のクラスタでUbuntuを実行している管理対象ノードを追加するには

1. コマンド・プロンプトを開き、oci ce node-pool createを使用して新しいノード・プールを作成します。
2. コマンドに必要な必須パラメータ:
   1. --node-image-idパラメータを含めて、ステップ1: 必要なUbuntuリリースを実行している既存のコンピュート・インスタンスに基づいてカスタム・イメージを作成するで作成したカスタム・イメージのOCIDを指定します。
   2. --node-metadataパラメータを含めて、ステップ3: Ubuntuノード・パッケージをインストールしてワーカー・ノードをブートストラップするcloud-initスクリプトを作成するで、管理対象ノード用に作成したcloud-initスクリプトを環境に適した形式で指定します。
      • Linux: --node-metadata '{"user_data": "'$(cat <cloud-init-file> | base64 -w 0)'"}'
      • Mac: --node-metadata '{"user_data": "'$(cat <cloud-init-file> | base64- b 0)'"}'
      ここでは:

      • <cloud-init-file>は、作成したcloud-initファイルの名前です。
      • base64は、ファイルがbase64エンコードされることを指定します

   たとえば、Macワークステーションで次のコマンドを入力できます。

   oci ce node-pool create \
   --cluster-id ocid1.cluster.oc1.iad.aaaa______m4w \
   --name my-ubuntu-nodepool \
   --node-image-id ocid1.image.oc1.iad.aaaa______zpq \
   --compartment-id ocid1.tenancy.oc1..aaa______q4a \
   --kubernetes-version v1.29.1 \
   --node-shape VM.Standard2.1 \
   --placement-configs "[{\"availabilityDomain\":\"PKGK:US-ASHBURN-AD-1\", \"subnetId\":\"ocid1.subnet.oc1.iad.aaaa______kfa\"}]" \
   --size 3 \
   --region us-ashburn-1 \
   --node-metadata '{"user_data": "'$(cat my-mgd-ubuntu-cloud-init.yaml | base64 -b 0)'"}'

   Kubernetesのバージョンは、cloud-initスクリプトで指定したKubernetesのバージョンと一致する必要があります(ステップ3: Ubuntuノード・パッケージをインストールしてワーカー・ノードをブートストラップするためのcloud-initスクリプトの作成を参照)。

   --kubernetes-versionパラメータを使用して指定するKubernetesバージョンは、cloud-initスクリプトで指定したKubernetesバージョンに対応している必要があります(ステップ3: Ubuntuノード・パッケージをインストールしてワーカー・ノードをブートストラップするためのcloud-initスクリプトの作成を参照)。

Ubuntuワーカー・ノードを自己管理ノードとして追加しています

自己管理ノードを作成する前に、次のことを確認します。

• 自己管理ノードを追加するクラスタは、自己管理ノード用に適切に構成されます。Cluster Requirementsを参照してください。
• 自己管理ノードをホストするコンピュート・インスタンスが、Kubernetes Engineで作成された拡張クラスタに参加できるようにするための動的グループおよびIAMポリシーがすでに存在します。「自己管理ノードの動的グループおよびポリシーの作成」を参照してください。

コンソールの使用

1. 自己管理ノードをホストする新しいコンピュート・インスタンスを作成します:
   1. ナビゲーション・メニューを開き、「コンピュート」を選択します。「コンピュート」で、「インスタンス」を選択します。
   2. 新しいコンピュート・インスタンスを作成するには、コンピュート・サービスのドキュメントの手順に従います。新しいコンピュート・インスタンスが拡張クラスタに参加できるようにするには、適切なポリシーが存在する必要があります。「自己管理ノードの動的グループおよびポリシーの作成」を参照してください。
   3. 「イメージとシェイプ」セクションで、「イメージの変更」をクリックします。
   4. 「マイ・イメージ」をクリックし、「イメージOCID」オプションを選択して、ステップ1: 必要なUbuntuリリースを実行している既存のコンピュート・インスタンスに基づいてカスタム・イメージを作成するで作成したカスタム・イメージのOCIDを入力します。
   5. 「拡張オプションの表示」をクリックし、「管理」タブで「cloud-initスクリプトの貼付け」オプションを選択します。
   6. ステップ3: cloud-initスクリプトを作成してUbuntuノード・パッケージをインストールし、ワーカー・ノードをブートストラップするで、自己管理ノード用に作成したcloud-initスクリプトをコピーして、Cloud-initスクリプト・フィールドに貼り付けます。
   7. 「作成」をクリックして、自己管理ノードをホストするコンピュート・インスタンスを作成します。

   コンピュート・インスタンスが作成されると、cloud-initスクリプトで指定したKubernetes APIエンドポイントを使用して、自己管理ノードとしてクラスタに追加されます。

2. (オプション)自己管理ノードの作成の手順に従って、自己管理ノードがKubernetesクラスタに追加され、ラベルがノードに追加され、想定どおりに設定されていることを確認します。

CLIの使用

1. コマンド・プロンプトを開き、oci Compute instance launchコマンドおよび必要なパラメータを入力して自己管理ノードを作成します。
2. コマンドに必要な必須パラメータ:
   1. --image-idパラメータを含めて、ステップ1: 必要なUbuntuリリースを実行している既存のコンピュート・インスタンスに基づいてカスタム・イメージを作成するで作成したカスタム・イメージのOCIDを指定します。
   2. --user-data-fileパラメータを含めて、ステップ3: Ubuntuノード・パッケージをインストールしてワーカー・ノードをブートストラップするためのcloud-initスクリプトの作成で自己管理ノード用に作成したcloud-initスクリプトを指定します。

   たとえば、次のコマンドを入力できます。

   oci compute instance launch \
   --availability-domain zkJl:PHX-AD-1 \
   --compartment-id ocid1.compartment.oc1..aaaaaaa______neoq \
   --shape VM.Standard2.2 \
   --subnet-id ocid1.subnet.oc1.phx.aaaaaaa______hzia \
   --user-data-file my-selfmgd-ubuntu-cloud-init.yaml \
   --image-id ocid1.image.oc1.phx.aaaaaaa______slcr

   コンピュート・インスタンスが作成されると、cloud-initスクリプトで指定したKubernetes APIエンドポイントを使用して、自己管理ノードとしてクラスタに追加されます。