Elastic Container Instance:イメージキャッシュのアノテーション

イメージキャッシュを作成するときに追加できるアノテーション

次の表は、イメージキャッシュを作成するときに追加できるアノテーションについて説明しています。

マルチゾーン機能を使用してイメージキャッシュを作成する

イメージキャッシュを作成すると、システムは一時的なエラスティックコンテナインスタンスを作成します。イメージキャッシュが確実に作成されるように、異なるゾーンにある複数のvSwitchを指定できます。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/vswitch-ids: "vsw-bp1dktddjsg5nktv****,vsw-bp1xpiowfm5vo8o3c****"  # 複数のvSwitchを指定します。
spec:
  images:
  - centos:latest
  - busybox:latest
  imageCacheSize:
   25
  retentionDays:
   7

CPUアーキテクチャを指定する

Armアーキテクチャのイメージをプルしてイメージキャッシュを作成する場合は、CPUアーキテクチャを指定する必要があります。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/imc-cpu-arch: "arm64" # CPUアーキテクチャをArmとして指定します。
spec:
  images:
  -arm64v8/centos:7.9.2009 # Armアーキテクチャを使用するコンテナイメージを指定します。
  imageCacheSize:
   25
  retentionDays:
   7

オペレーティングシステムを指定する

Windows イメージをプルしてイメージキャッシュを作成する場合は、オペレーティングシステムを指定する必要があります。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/imc-os-type: "windows" # オペレーティングシステムを Windows として指定します。
spec:
  images:
  -mcr.microsoft.com/windows/nanoserver:ltsc2022 # オペレーティングシステムを含むコンテナーイメージを指定します。
  imageCacheSize:
   25
  retentionDays:
   7

セキュリティグループとリソースグループを構成する

デフォルトでは、イメージキャッシュを作成するときに、eci-profile で構成されているセキュリティグループとリソースグループが使用されます。ビジネス要件に基づいて、セキュリティグループとリソースグループを構成できます。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/security-group-id: "sg-bp1dktddjsg5nktv****" # セキュリティグループを指定します。
    k8s.aliyun.com/resource-group-id: "rg-aek2z3elfs4****"      # リソースグループを指定します。
spec:
  images:
  - centos:latest
  - busybox:latest
  imageCacheSize:
   25
  retentionDays:
   7

コンテナーレジストリインスタンスからシークレットを使用せずにイメージをプルする

次の表は、Secrets を使用せずにコンテナーレジストリインスタンスからイメージをプルできるシナリオを示しています。

詳細については、シークレットを使用せずにコンテナーレジストリインスタンスからイメージをプルする を参照してください。

セルフマネージドイメージリポジトリの使用

セルフマネージドイメージリポジトリでイメージリポジトリ内のイメージを使用してイメージキャッシュを作成する際に、HTTPプロトコルまたは自己署名証明書を使用する場合、イメージのプル失敗を防ぐためにアノテーションを設定する必要があります。

• セルフマネージドイメージリポジトリがHTTPプロトコルを使用している場合。

  デフォルトでは、エラスティックコンテナインスタンスはHTTPSプロトコルを介してイメージをプルします。イメージキャッシュを作成する場合は、k8s.aliyun.com/plain-http-registry アノテーションを追加する必要があります。これにより、エラスティックコンテナインスタンスはHTTPプロトコルを介してイメージリポジトリと対話できます。

  apiVersion: eci.alibabacloud.com/v1
  kind: ImageCache
  metadata:
    name: imagecache-sample
    annotations:
      k8s.aliyun.com/plain-http-registry: "192.168.XX.XX:5000"  # HTTPプロトコルを介してイメージをプルするために使用するセルフマネージドイメージリポジトリのアドレスを指定します。
  spec:
    images:
    - 192.168.XX.XX:5000/test/nginx:latest
    imagePullSecrets:
    - default:secret1
    - default:secret2
    - kube-system:secret3
    imageCacheSize:
     25
    retentionDays:
     7

• セルフマネージドイメージリポジトリが自己署名証明書を使用している場合。

  セルフマネージドイメージリポジトリが自己発行証明書を使用している場合、システムがイメージリポジトリからイメージをプルしようとすると、証明書の認証が失敗します。証明書の認証をスキップするには、k8s.aliyun.com/insecure-registry アノテーションを追加する必要があります。

  apiVersion: eci.alibabacloud.com/v1
  kind: ImageCache
  metadata:
    name: imagecache-sample
    annotations:
      k8s.aliyun.com/insecure-registry: "harbor***.pre.com"  # セルフマネージドイメージリポジトリのアドレスを指定します。システムがポッドを作成するためにイメージリポジトリからイメージをプルしようとすると、証明書の認証がスキップされます。
  spec:
    images:
    - harbor***.pre.com/test/nginx:latest
    imagePullSecrets:
    - default:secret1
    - default:secret2
    - kube-system:secret3
    imageCacheSize:
     25
    retentionDays:
     7

イメージキャッシュレイヤーの再利用を有効にする

イメージキャッシュの作成に必要な時間は、イメージサイズやネットワークの状態など、いくつかの要因によって異なります。イメージキャッシュレイヤーの再利用機能を有効にすることで、イメージキャッシュの作成に必要な時間を短縮できます。

この機能を有効にすると、イメージキャッシュを作成する際に、システムは既存のイメージキャッシュを検査します。既存のイメージキャッシュに使用したいイメージレイヤーが含まれている場合、システムはそのイメージレイヤーを再利用して、イメージキャッシュの作成に必要な時間を短縮します。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/imc-enable-reuse: "true"   # イメージキャッシュレイヤーの再利用を有効にします。
spec:
  images:
  - centos:latest
  - busybox:latest
  imageCacheSize:
   25
  retentionDays:
   7

インスタントイメージキャッシュ機能を有効にする

イメージキャッシュの作成に必要な時間は、イメージサイズやネットワークの状態など、さまざまな要因によって異なります。インスタントイメージキャッシュ機能を有効にすることで、イメージキャッシュの作成に必要な時間を短縮できます。

インスタントイメージキャッシュ機能を有効にすると、イメージキャッシュの作成中に、一時的なエラスティックコンテナインスタンスのディスクの一時的なロカールスナップショットが作成されます。ロカールスナップショットが作成されると、イメージキャッシュを使用できるようになります。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/imc-enable-flash: "true"   # インスタントイメージキャッシュ機能を有効にします。
spec:
  images:
  - centos:latest
  - busybox:latest
  imageCacheSize:
   25
  retentionDays:
   7

イメージキャッシュのサイズと保持期間の設定

デフォルトでは、手動で作成されたイメージキャッシュのサイズは 20 GiB で、作成後は永続的に保持されます。イメージキャッシュのサイズと保持期間を指定する場合は、spec セクションで imageCacheSize パラメーターと retentionDays パラメーターを指定するか、アノテーションを追加します。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/imc-retention-days: "7"   # イメージキャッシュの保持期間を指定します。
    k8s.aliyun.com/imc-size: "25"            # イメージキャッシュのサイズを指定します。
spec:
  images:
  - centos:latest
  - busybox:latest

インターネット経由でイメージをプルするためのEIPの設定

EIPは、独立したリソースとして購入して使用できるパブリックIPアドレスです。EIPをクラウド・リソースに関連付けると、クラウド・リソースはEIPを使用してインターネットに接続できます。詳細については、エラスティックIPアドレスとは を参照してください。

イメージ・キャッシュを作成する場合は、インターネット経由でイメージをプルする前に、インターネットに接続されていることを確認してください。インターネットへの接続は、NATゲートウェイを設定するか、EIPを設定することで行うことができます。仮想プライベートクラウド（VPC）がNATゲートウェイに関連付けられていない場合は、インターネット経由でイメージをプルするためにEIPを設定できます。EIPを設定するには、次のいずれかの方法を使用できます。

• 既存のEIPを一時的なエラスティック・コンテナ・インスタンスに関連付ける

  apiVersion: eci.alibabacloud.com/v1
  kind: ImageCache
  metadata:
    name: imagecache-sample
    annotations:
      k8s.aliyun.com/eip-instance-id: "eip-bp1q5n8cq4p7f6dzu****"   # 既存のEIPを一時的なエラスティックコンテナインスタンスに関連付けます。
  spec:
    images:
    - centos:latest
    - busybox:latest
    imageCacheSize:
     25
    retentionDays:
     7

• EIPを自動的に作成し、一時的なエラスティック・コンテナ・インスタンスに関連付ける

  apiVersion: eci.alibabacloud.com/v1
  kind: ImageCache
  metadata:
    name: imagecache-sample
    annotations:
      k8s.aliyun.com/auto-create-eip: "true"                                       # EIPを自動的に作成し、一時的なエラスティックコンテナインスタンスに関連付けます。
      k8s.aliyun.com/eip-bandwidth: "10"                                           # EIPの帯域幅制限を指定します。単位：Mbit/s。
      k8s.aliyun.com/eip-internet-charge-type: PayByBandwidth                      # EIPの従量課金方式を指定します。
      k8s.aliyun.com/eip-common-bandwidth-package-id: "cbwp-2zeukbj916scmj51m****" # EIP帯域幅プランのIDを指定します。
  spec:
    images:
    - centos:latest
    - busybox:latest
    imageCacheSize:
     25
    retentionDays:
     7