Container Registry:Muat gambar kontainer sesuai permintaan

Batasan

• Jika runtime kontainer Anda adalah containerd, repositori gambar terakselerasi dapat menggunakan nama domain kustom. Karena keterbatasan Docker, fitur ini tidak didukung jika Anda menggunakan runtime Docker. Untuk informasi selengkapnya, lihat Gunakan nama domain kustom untuk mengakses instans Container Registry Enterprise Edition.

• Mode index-only tidak dapat digunakan dalam skenario Function Compute (FC) atau Serverless App Engine (SAE).

• Anda harus mengonversi gambar yang sudah ada menjadi gambar terakselerasi secara manual.

Ketersediaan wilayah

Fitur pemuatan sesuai permintaan tidak tersedia di wilayah Alibaba Finance Cloud dan Alibaba Gov Cloud.

Konversi ke gambar terakselerasi

1. Masuk ke Konsol Container Registry.

2. Di bilah navigasi atas, pilih wilayah.

3. Di panel navigasi kiri, klik Instances.

4. Di halaman Instances, klik instans Enterprise Edition yang ingin Anda kelola.

5. Di halaman detail instans, di panel navigasi kiri, pilih Repository > Repositories.

6. Di halaman Repositories, klik nama repositori target atau klik Manage di kolom Actions. Di pojok kiri atas halaman Informasi Dasar, klik Edit.

7. Di kotak dialog Modify Settings, aktifkan Accelerated Image, pilih mode, lalu klik Confirm.

   • Full Mode: Memberikan akselerasi signifikan untuk startup kontainer. Ukuran gambar terakselerasi yang dihasilkan sekitar 130% dari ukuran gambar aslinya. Diperlukan waktu sekitar 25 detik untuk menghasilkan gambar terakselerasi dari gambar asli berukuran 1 GB. Layer gambar yang sudah ada tidak dibuat ulang.

   • index-only mode: Memberikan sekitar 70% efek akselerasi dari full mode. Ukuran gambar terakselerasi sekitar 3% dari ukuran gambar aslinya. Diperlukan waktu sekitar 3 detik untuk menghasilkan gambar terakselerasi dari gambar asli berukuran 1 GB. Layer gambar yang sudah memiliki indeks tidak diindeks ulang.

     Penting

     Mode index-only sedang dalam pratinjau publik. Kami menyarankan Anda mengujinya di lingkungan non-produksi sebelum menggunakannya di lingkungan produksi.

     Catatan

     • Mode index-only hanya berlaku untuk gambar yang dikompresi dengan tar atau tgz. Mode ini tidak berlaku untuk gambar yang dikompresi dengan metode lain, seperti zstd.

     • Mode index-only harus digunakan bersama gambar aslinya, dan gambar asli tidak dapat dihapus. Di mode lengkap, gambar terakselerasi dapat digunakan secara independen.

     • Mode index-only tidak didukung oleh runtime Docker.

   Setelah Anda mengonfigurasi akselerasi gambar, gambar yang didorong secara otomatis memicu tugas konversi. Jika Anda ingin menerima notifikasi saat konversi gambar selesai, Anda dapat mengonfigurasi notifikasi event. Misalnya, atur ekspresi menjadi _accelerated$. Untuk informasi selengkapnya, lihat Konfigurasikan notifikasi event.

8. (Opsional) Tentukan Prefetch File List. File dalam daftar ini akan dipra-ambil (prefetched) saat gambar terakselerasi dimulai. Kami menyarankan Anda menggunakan fitur ini ketika file besar perlu dibaca saat startup kontainer.

   Catatan

   Setiap baris harus berisi jalur mutlak ke file. Untuk direktori, jalur harus diakhiri dengan garis miring maju (/).

Instal komponen akselerasi gambar

Untuk menjalankan kontainer terakselerasi, Anda harus menginstal plugin penyimpanan untuk pemuatan sesuai permintaan pada node pekerja Anda.

1. Untuk mendukung gambar terakselerasi DADI, instal komponen ack-dadi untuk mengaktifkan akselerasi gambar pada node dalam kelompok node.

   1. Masuk ke Konsol ACK. Di panel navigasi kiri, klik Clusters.

   2. Di halaman Clusters, klik nama kluster Anda. Di panel navigasi kiri, klik Nodes > Node Pools.

   3. Di halaman Node Pools, klik kelompok node target, lalu klik tab Node Components.

   4. Klik Install Node Components, lalu di panel yang muncul di sebelah kanan, pilih komponen ack-dadi dan instal sesuai petunjuk.

2. Instal komponen akselerasi gambar. (Hanya diperlukan untuk kluster versi sebelum v1.34.)

   1. Masuk ke Konsol ACK. Di panel navigasi kiri, klik Clusters.

   2. Di halaman Clusters, klik nama kluster target. Di panel navigasi kiri, klik Add-ons.

   3. Di halaman Add-ons, temukan aliyun-acr-acceleration-suite di bagian More lalu klik Install.

   4. Di kotak dialog Tips, klik OK.

      • Di panel navigasi kiri, pilih Workloads > DaemonSets. Di halaman DaemonSets, lihat detail instalasi DaemonSet komponen.

      • Di panel navigasi kiri, pilih Workloads > Deployments. Di halaman Deployments, lihat detail instalasi Deployment komponen.

      Instalasi komponen selesai ketika semua pod-nya berstatus Berjalan.

Aktifkan gambar terakselerasi

1. Konfigurasikan kredensial akses repositori.

   Peringatan

   Konfigurasikan rahasia pull gambar Anda sesuai prinsip hak istimewa minimal. Berikan hanya izin yang diperlukan untuk menarik gambar layanan yang digunakan oleh kluster. Untuk informasi selengkapnya, lihat Berikan kebijakan kustom kepada Pengguna RAM.

   • Opsi 1: Gunakan komponen aliyun-acr-credential-helper.

     • Jika Anda telah menginstal komponen aliyun-acr-credential-helper dan mengonfigurasikannya dengan benar untuk instans Container Registry Enterprise Edition Anda, tidak diperlukan tindakan tambahan.

     • Jika Anda belum menginstal komponen tersebut, Anda dapat menginstalnya sekarang. Untuk informasi selengkapnya, lihat Gunakan komponen aliyun-acr-credential-helper untuk menarik gambar kontainer tanpa rahasia.

   • Opsi 2: Tambahkan label ke rahasia pull gambar.

     Catatan

     Metode ini hanya didukung oleh komponen aliyun-acr-acceleration-suite versi 0.2.6 atau lebih baru.

     Buat Secret bertipe kubernetes.io/dockerconfigjson dan tambahkan label images.alibabacloud.com/accelerated: true ke Secret tersebut.

     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. Tambahkan label akselerasi gambar.

   Anda dapat menambahkan label akselerasi gambar ke beban kerja, seperti Pod atau Deployment, atau ke seluruh namespace di kluster ACK atau kluster ACK Serverless Anda. Saat Anda memberi label pada namespace, pemuatan sesuai permintaan diaktifkan untuk semua beban kerja yang memenuhi syarat dalam namespace tersebut, sehingga tidak perlu memodifikasi file YAML untuk setiap beban kerja. Pilih metode yang paling sesuai dengan kebutuhan Anda.

   Catatan

   Kunci label adalah k8s.aliyun.com/image-accelerate-mode dan nilainya adalah on-demand.

   • Tambahkan label akselerasi gambar ke beban kerja.

     Contoh berikut menunjukkan cara menambahkan label ke Pod yang dikelola oleh Deployment. Jalankan perintah berikut untuk mengedit Deployment:

     kubectl edit deployment <DeploymentName> -n <DeploymentNamespace>

     Dalam file YAML Deployment, tambahkan label 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
             # aktifkan mode on-demand
             k8s.aliyun.com/image-accelerate-mode: on-demand
         spec:
           containers:
            # gambar instans ACR Anda
            - image: test-registry-vpc.cn-hangzhou.cr.aliyuncs.com/test/nginx:latest
              name: test
              command: ["sleep", "3600"]

   • Tambahkan label akselerasi gambar ke namespace.

     • Tambahkan label akselerasi gambar di konsol.

       1. Masuk ke Konsol ACK, lalu di bilah navigasi kiri, pilih Clusters.

       2. Di halaman Clusters, klik nama kluster Anda. Di panel navigasi kiri, klik Namespaces and Quotas.

       3. Di halaman Namespace, temukan namespace target lalu klik Edit di kolom Actions.

       4. Di kotak dialog Edit Namespace, atur Variable Key dari Tag menjadi k8s.aliyun.com/image-accelerate-mode dan Variable Value dari Tag menjadi on-demand, lalu klik Confirm.

     • Tambahkan label akselerasi gambar menggunakan command line.

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

   Setelah Anda menambahkan label akselerasi dan mengonversi gambar asli menjadi gambar terakselerasi, komponen akselerasi secara otomatis mengganti alamat gambar asli dengan alamat gambar terakselerasi dan menambahkan nodeSelector untuk menjadwalkan Pod ke node terakselerasi selama pembuatan atau pembaruan Pod dalam namespace tersebut.