Container Registry:コンテナイメージのオンデマンドロード

制限事項

• お使いのコンテナランタイムが containerd の場合、高速化イメージリポジトリはカスタムドメイン名を使用できます。Docker の制限により、Docker ランタイムを使用する場合はサポートされていません。詳細については、「カスタムドメイン名を使用した Container Registry Enterprise Edition インスタンスへのアクセス」をご参照ください。

• インデックスのみモードは、Function Compute (FC) または Serverless App Engine (SAE) では使用できません。

• 既存のイメージは、手動で高速化イメージに変換する必要があります。

利用可能なリージョン

オンデマンドロード機能は、Alibaba Finance Cloud および Alibaba Gov Cloud リージョンでは利用できません。

高速化イメージへの変換

1. Container Registryコンソールにログインします。

2. 上部のナビゲーションバーで、リージョンを選択します。

3. 左側メニューで、インスタンス をクリックします。

4. [インスタンス] ページで、管理するEnterprise Editionインスタンスをクリックします。

5. インスタンス詳細ページの左側メニューで、リポジトリ > リポジトリ を選択します。

6. [リポジトリ] ページで、対象のリポジトリの名前をクリックするか、操作 列の 管理 をクリックします。 [基本情報] ページの左上隅で、編集 をクリックします。

7. 基本情報の変更 ダイアログボックスで、高速化イメージ を有効にし、モードを選択して、OK をクリックします。

   • [フルモード]：コンテナの起動を大幅に高速化します。生成される高速化イメージのサイズは、元のイメージサイズの約 130% です。1 GB の元のイメージから高速化イメージを生成するには、約 25 秒かかります。既存のイメージレイヤーは再生成されません。

   • インデックスのみモード：フルモードの約 70% の高速化効果を提供します。高速化イメージのサイズは、元のイメージサイズの約 3% です。1 GB の元のイメージから高速化イメージを生成するには、約 3 秒かかります。インデックスが作成済みのイメージレイヤーは再インデックスされません。

     重要

     インデックスのみモードはパブリックプレビュー中です。本番環境で使用する前に、非本番環境でテストすることを推奨します。

     説明

     • インデックスのみモードは、tar または tgz で圧縮されたイメージにのみ適用されます。このモードは、zstd などの他の方法で圧縮されたイメージには適用されません。

     • インデックスのみモードは元のイメージと一緒に使用する必要があり、元のイメージは削除できません。フルモードでは、高速化イメージは独立して使用できます。

     • インデックスのみモードは、Docker ランタイムではサポートされていません。

   イメージの高速化を設定した後、プッシュされたイメージは自動的に変換タスクをトリガーします。イメージ変換の完了時に通知を受け取りたい場合は、イベント通知を設定できます。たとえば、式を _accelerated$ に設定します。詳細については、「イベント通知の設定」をご参照ください。

8. (オプション) プリフェッチファイルリスト を指定します。このリスト内のファイルは、高速化イメージの起動時にプリフェッチされます。コンテナ起動時に大きなファイルを読み取る必要がある場合に、この機能を使用することを推奨します。

   説明

   各行には、ファイルの絶対パスを含める必要があります。ディレクトリの場合、パスはスラッシュ (/) で終わる必要があります。

イメージ高速化コンポーネントのインストール

高速化コンテナを起動するには、ワーカーノードにオンデマンドロード用のストレージプラグインをインストールする必要があります。

1. DADI 高速化イメージをサポートするには、ack-dadi コンポーネントをインストールして、ノードプールのノードでイメージ高速化を有効にします。

   1. ACK コンソールにログインします。左側メニューで、クラスターリスト をクリックします。

   2. クラスターリスト ページで、クラスターの名前をクリックします。左側メニューで、ノード > ノードプール をクリックします。

   3. ノードプール ページで、対象のノードプールをクリックし、ノードコンポーネント タブをクリックします。

   4. ノードコンポーネントのインストール をクリックし、右側に表示されるパネルで ack-dadi コンポーネントを選択し、指示に従ってインストールします。

2. イメージ高速化コンポーネントをインストールします。(v1.34 より前のクラスターでのみ必須)

   1. ACKコンソールにログインします。 左側のナビゲーションウィンドウで、[クラスター] をクリックします。

   2. クラスターリスト ページで、目的のクラスターの名前をクリックします。 左側のナビゲーションペインで、アドオン管理 をクリックします。

   3. アドオン管理 ページの さらに表示 セクションで [aliyun-acr-acceleration-suite] を見つけ、インストール をクリックします。

   4. ヒント ダイアログボックスで、OK をクリックします。

      • 左側メニューで、ワークロード > Daemon Sets を選択します。デーモンセット ページで、コンポーネントの DaemonSet のインストール詳細を表示します。

      • 左側メニューで、ワークロード > 展開 を選択します。ステートレス ページで、コンポーネントの Deployment のインストール詳細を表示します。

      すべての Pod が実行中になったら、コンポーネントのインストールは完了です。

高速化イメージの有効化

1. リポジトリアクセス資格情報を設定します。

   警告

   最小権限の原則に従って、イメージプル Secret を設定します。クラスターが使用するサービスイメージをプルするために必要な権限のみを付与します。詳細については、「RAM ユーザーへのカスタムポリシーの付与」をご参照ください。

   • オプション 1：aliyun-acr-credential-helper コンポーネントを使用します。

     • aliyun-acr-credential-helper コンポーネントをインストールし、Container Registry Enterprise Edition インスタンス用に正しく設定している場合は、追加の操作は不要です。

     • コンポーネントをインストールしていない場合は、今すぐインストールできます。詳細については、「aliyun-acr-credential-helper コンポーネントを使用した Secret なしのコンテナイメージのプル」をご参照ください。

   • オプション 2：イメージプル Secret にラベルを追加します。

     説明

     この方法は、aliyun-acr-acceleration-suite コンポーネントのバージョン 0.2.6 以降でのみサポートされます。

     kubernetes.io/dockerconfigjson タイプの Secret を作成し、images.alibabacloud.com/accelerated: true ラベルを Secret に追加します。

     kubectl create secret docker-registry <SecretName> --docker-server=<RegistryVpcDomain> --docker-username=<UserName> --docker-password=<Password>

     kubectl label secrets <SecretName> images.alibabacloud.com/accelerated="true"

2. イメージ高速化ラベルを追加します。

   ACK または ACK Serverless クラスターのワークロード (Pod や Deployment など) 、または名前空間全体に、イメージアクセラレーションラベルを追加できます。名前空間にラベルを付けると、その名前空間内のすべての対象ワークロードでオンデマンドローディングが有効になり、各ワークロードの YAML ファイルを変更する必要がなくなります。要件に最も適した方法を選択してください。

   説明

   ラベルキーは k8s.aliyun.com/image-accelerate-mode で、値は on-demand です。

   • ワークロードにイメージ高速化ラベルを追加します。

     次の例は、Deployment によって管理される Pod にラベルを追加する方法を示しています。次のコマンドを実行して Deployment を編集します。

     kubectl edit deployment <DeploymentName> -n <DeploymentNamespace>

     Deployment の YAML ファイルに、 k8s.aliyun.com/image-accelerate-mode: on-demand ラベルを追加します。

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: nginx-deployment
       labels:
         app: nginx
     spec:
       replicas: 1
       selector:
         matchLabels:
           app: nginx
       template:
         metadata:
           labels:
             app: nginx
             # オンデマンドモードを有効化
             k8s.aliyun.com/image-accelerate-mode: on-demand
         spec:
           containers:
            # ACR インスタンスのイメージ
            - image: test-registry-vpc.cn-hangzhou.cr.aliyuncs.com/test/nginx:latest
              name: test
              command: ["sleep", "3600"]

   • 名前空間にイメージ高速化ラベルを追加します。

     • コンソールでイメージ高速化ラベルを追加します。

       1. ACK コンソールにログインし、左側のナビゲーションバーで クラスターリスト を選択します。

       2. [クラスター] ページで、管理するクラスターの名前をクリックします。 左側のナビゲーションウィンドウで、[名前空間とクォータ] をクリックします。

       3. 名前空間 ページで、対象の名前空間を見つけ、操作 列の 編集 をクリックします。

       4. 名前空間の編集 ダイアログボックスで、タグ の 変数名 を k8s.aliyun.com/image-accelerate-mode に、タグ の 可変値 を on-demand に設定し、OK をクリックします。

     • コマンドラインを使用してイメージ高速化ラベルを追加します。

   kubectl label namespaces <YOUR-NAMESPACE> k8s.aliyun.com/image-accelerate-mode=on-demand

   高速化ラベルを追加し、元のイメージを高速化イメージに変換すると、高速化コンポーネントは自動的に元のイメージアドレスを高速化イメージアドレスに置き換え、Pod の作成または更新時に Pod を高速化ノードにスケジュールするための nodeSelector を名前空間内に追加します。