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

制限事項

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

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

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

利用可能なリージョン

遅延読み込み機能は、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. ACK マネージドおよび専用クラスター

   新しいノードプールで有効化

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

   2. クラスター名をクリックします。左側のナビゲーションウィンドウで、[ノード] > [ノードプール] を選択します。

   3. ノードプールを作成する際に、[詳細オプション] を展開し、[コンテナイメージの高速化] を有効にします。

   既存のノードプールで有効化

   重要

   [コンテナイメージの高速化] への変更は、変更後に追加されたノードにのみ適用されます。既存のノードは影響を受けません。この機能を既存のノードに適用するには、それらを削除してから再度追加してください。「ノードの削除」および「既存ノードの追加」をご参照ください。

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

   2. クラスター名をクリックします。左側のナビゲーションウィンドウで、[ノード] > [ノードプール] を選択します。

   3. ノードプールを見つけ、[操作] 列の [編集] をクリックします。[詳細オプション] セクションで、[コンテナイメージの高速化] を有効にし、画面の指示に従ってノードプールの ConfigMap を更新します。[ステータス] 列には、更新中は [更新中]、完了すると [アクティブ] と表示されます。

   その他のクラスタータイプ

   alibabacloud.com/image-accelerate-enabled: true イメージ高速化ラベルをノードに追加する必要があります。この操作により、ノードの初期化中にイメージ高速化機能が自動的に有効になり、イメージストレージプラグインがインストールされます。

   ラベルを追加する方法はクラスタータイプによって異なります。

   クラスタータイプ	設定ガイド
   ACK Serverless クラスター	ノードプールの作成 ノードプールの設定変更
   ACK Edge クラスター	クラウド側ノードプールについては、「ノードプールの作成と管理」をご参照ください。 エッジノードプールについては、「エッジノードプールの作成」をご参照ください。
   ACK Lingjun クラスター	Lingjun ノードプール
   Alibaba Cloud Container Compute Service (ACS)	ノードのラベルと Taint の管理

2. イメージ高速化コンポーネントをインストールします。

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

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

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

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

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

      • 左側のナビゲーションウィンドウで、ワークロード > 展開 を選択します。ステートレス ページで、コンポーネントの Deployment のインストール詳細を表示します。

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

高速化イメージの有効化

1. リポジトリのアクセス認証情報を設定します。

   警告

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

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

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

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

   • オプション 2：イメージプルシークレットにラベルを追加する。

     説明

     この方法は、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 を追加します。