Bermigrasi ke image :stable

Jika Anda menggunakan image Docker :latest, :alpine, :emulators, :latest, :slim, dan :debian_component_based, sebaiknya Anda bermigrasi ke image :stable berbasis Debian untuk ukuran image yang lebih kecil dan perbaikan keamanan yang lebih baik. Untuk bertransisi ke penggunaan image :stable, Anda dapat memperluas image Docker :stable ke image berbasis debian yang Anda gunakan.

Dalam beberapa kasus (yaitu menginstal dependensi lama yang tidak kompatibel seperti python2 atau JDK lama, dll.), memperluas image :stable tidak selalu memungkinkan. Dalam hal ini, Anda mungkin harus membuat Dockerfile sendiri.

Memperluas image Docker :stable

Anda dapat menggunakan image Docker :stable sebagai image dasar dan menginstal komponen tambahan dan paket apt untuk memperluasnya ke image Docker berbasis debian lainnya (yaitu :latest, :emulators, dan :slim). Untuk memperluas image Docker :stable, kita dapat melakukan salah satu hal berikut:

• Memperluas image dasar :stable dengan menyesuaikan saat runtime
• Memperluas image dasar :stable dengan membangun Dockerfile Anda sendiri

Memperluas image dasar :stable dengan menyesuaikan saat runtime

Anda dapat memperluas image Docker :stable untuk digunakan sebagai image :latest, :emulators atau :slim dengan menyesuaikannya saat runtime.

Menyesuaikan Gambar :latest

Jalankan perintah docker run berikut untuk memperluas image Docker :stable menjadi image Docker :latest saat runtime:

$ docker run -e APT_PACKAGES='curl python3-crcmod apt-transport-https lsb-release openssh-client git make gnupg' \
-e COMPONENTS='google-cloud-cli-datastore-emulator google-cloud-cli-pubsub-emulator google-cloud-cli-bigtable-emulator google-cloud-cli-firestore-emulator google-cloud-cli-spanner-emulator google-cloud-cli-cbt google-cloud-cli-kpt google-cloud-cli-local-extract google-cloud-cli-gke-gcloud-auth-plugin kubectl' \
gcr.io/google.com/cloudsdktool/google-cloud-cli:stable gcloud version

Catatan: Jika Anda memerlukan mesin Docker yang diinstal di image Docker, Anda dapat memperluas image :stable dengan menggunakannya di Dockerfile. Untuk mengetahui langkah-langkahnya, lihat Memperluas image dasar :stable dengan membuat Dockerfile Anda sendiri.

Menyesuaikan Gambar :emulators

Anda dapat menjalankan perintah berikut untuk memperluas image Docker :stable menjadi image Docker :emulators saat runtime:

$ docker run -e APT_PACKAGES='curl python3-crcmod lsb-release gnupg bash' \
-e COMPONENTS='google-cloud-cli-datastore-emulator google-cloud-cli-pubsub-emulator google-cloud-cli-bigtable-emulator google-cloud-cli-firestore-emulator google-cloud-cli-spanner-emulator' \
gcr.io/google.com/cloudsdktool/google-cloud-cli:stable gcloud version

Menyesuaikan Gambar :slim

Anda dapat memperluas image Docker :stable sebagai image Docker :slim dengan menjalankan perintah docker run berikut:

$ docker run -e APT_PACKAGES='curl gcc python3-crcmod python3-pip apt-transport-https lsb-release openssh-client git gnupg' \
gcr.io/google.com/cloudsdktool/google-cloud-cli:stable gcloud version

Catatan: Jika Anda memerlukan penginstalan mesin Docker di image Docker, Anda dapat membangun image dari Dockerfile yang sudah ada. Untuk mengetahui langkah-langkahnya, lihat Memperluas image dasar :stable dengan membuat Dockerfile Anda sendiri.

Memperluas image :stable dengan konfigurasi build

Anda dapat menggunakan file konfigurasi build kustom sendiri untuk memperluas image Docker :stable guna menginstal paket atau komponen tambahan. Misalnya, jika Anda ingin memperluas image Docker :stable untuk menginstal paket python3-google-auth dan python3-requests serta menginstal komponen pubsub emulator, Anda dapat menggunakan file konfigurasi build berikut.

steps:
  - id: 'extend-stable'
    name: gcr.io/google.com/cloudsdktool/google-cloud-cli:499.0.0-stable
    args:
      - gcloud
      - version
    env:
      - 'APT_PACKAGES=python3-google-auth python3-requests'
      - 'COMPONENTS=google-cloud-cli-pubsub-emulator'

Memperluas image dasar :stable dengan membuat Dockerfile Anda sendiri

Anda dapat memperluas image Docker :stable dengan membuat Dockerfile Anda sendiri dengan image :stable sebagai image dasar, lalu membangun image Docker dengan perintah docker build.

Membangun :latest Gambar Anda sendiri

Untuk mengonversi gambar :stable menjadi gambar :latest, lakukan langkah-langkah berikut:

1. Buat Dockerfile Anda sendiri dari :stable dengan menginstal komponen dan paket yang diperlukan:

   FROM docker:27.1.1 as static-docker-source
   
   FROM gcr.io/google.com/cloudsdktool/google-cloud-cli:stable
   COPY --from=static-docker-source /usr/local/bin/docker /usr/local/bin/docker
   COPY --from=static-docker-source /usr/local/libexec/docker/cli-plugins/docker-buildx /usr/local/libexec/docker/cli-plugins/docker-buildx
   
   RUN apt-get update -qqy && apt-get -qqy upgrade && apt-get install -qqy \
         curl \
         python3-crcmod \
         apt-transport-https \
         lsb-release \
         openssh-client \
         git \
         make \
         gnupg && \
      export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)" && \
      export CLOUD_SDK_VERSION=$(gcloud version | grep "Google Cloud SDK" | grep -oE '[^ ]+$') && \
      echo "deb https://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" > /etc/apt/sources.list.d/google-cloud-sdk.list && \
      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key add - && \
      apt-get update && \
      apt-get install -y google-cloud-cli-datastore-emulator=${CLOUD_SDK_VERSION}-0 \
         google-cloud-cli-pubsub-emulator=${CLOUD_SDK_VERSION}-0 \
         google-cloud-cli-bigtable-emulator=${CLOUD_SDK_VERSION}-0 \
         google-cloud-cli-firestore-emulator=${CLOUD_SDK_VERSION}-0 \
         google-cloud-cli-spanner-emulator=${CLOUD_SDK_VERSION}-0 \
         google-cloud-cli-cbt=${CLOUD_SDK_VERSION}-0 \
         google-cloud-cli-kpt=${CLOUD_SDK_VERSION}-0 \
         google-cloud-cli-local-extract=${CLOUD_SDK_VERSION}-0 \
         google-cloud-cli-gke-gcloud-auth-plugin=${CLOUD_SDK_VERSION}-0 \
         kubectl
   

2. Buat Dockerfile untuk mendapatkan image Docker :latest Anda sendiri:

   $ docker build -t my-cloud-sdk-docker:latest .
   

Membangun :emulators Gambar Anda sendiri

Untuk mengonversi gambar :stable menjadi gambar :emulators, lakukan langkah-langkah berikut:

1. Buat Dockerfile dengan komponen dan paket yang diperlukan sebagai:

   FROM gcr.io/google.com/cloudsdktool/google-cloud-cli:stable
   
   RUN apt-get update -qqy && apt-get -qqy upgrade && apt-get install -qqy \
         curl \
         python3-crcmod \
         lsb-release \
         gnupg \
         bash && \
      export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)" && \
      export CLOUD_SDK_VERSION=$(gcloud version | grep "Google Cloud SDK" | grep -oE '[^ ]+$') && \
      echo "deb https://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" > /etc/apt/sources.list.d/google-cloud-sdk.list && \
      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key add - && \
      apt-get update && \
      apt-get install -y google-cloud-cli-datastore-emulator=${CLOUD_SDK_VERSION}-0 \
         google-cloud-cli-pubsub-emulator=${CLOUD_SDK_VERSION}-0 \
         google-cloud-cli-bigtable-emulator=${CLOUD_SDK_VERSION}-0 \
         google-cloud-cli-firestore-emulator=${CLOUD_SDK_VERSION}-0 \
         google-cloud-cli-spanner-emulator=${CLOUD_SDK_VERSION}-0
   

2. Bangun Dockerfile dengan menjalankan perintah:

   $ docker build -t my-cloud-sdk-docker:emulators .
   

Membangun :slim Gambar Anda sendiri

Untuk mengonversi gambar :stable menjadi gambar :slim, lakukan langkah-langkah berikut:

1. Buat Dockerfile menggunakan :stable sebagai image dasar:

   FROM docker:27.1.1 as static-docker-source
   
   FROM gcr.io/google.com/cloudsdktool/google-cloud-cli:stable
   COPY --from=static-docker-source /usr/local/bin/docker /usr/local/bin/docker
   COPY --from=static-docker-source /usr/local/libexec/docker/cli-plugins/docker-buildx /usr/local/libexec/docker/cli-plugins/docker-buildx
   
   RUN apt-get update -qqy && apt-get -qqy upgrade && apt-get install -qqy \
         curl \
         python3-crcmod \
         apt-transport-https \
         lsb-release \
         openssh-client \
         git \
         make \
         gnupg
   

2. Buat Dockerfile dengan menjalankan perintah berikut:

   $ docker build -t my-cloud-sdk-docker:slim .