Migrer vers l'image :stable

Si vous utilisez les images Docker :latest, :alpine, :emulators, :latest, :slim et :debian_component_based, nous vous recommandons de migrer vers l'image :stable basée sur Debian pour réduire la taille de l'image et améliorer les correctifs de sécurité. Pour passer à l'utilisation de l'image :stable, vous pouvez étendre l'image Docker :stable à l'image basée sur Debian que vous utilisez.

Dans certains cas (par exemple, lors de l'installation d'anciennes dépendances incompatibles telles que python2 ou d'anciennes JDK, etc.), il n'est pas toujours possible d'étendre l'image :stable. Dans ce cas, vous devrez peut-être créer votre propre fichier Dockerfile.

Étendre l'image Docker :stable

Vous pouvez utiliser l'image Docker :stable comme image de base et installer des composants et des packages apt supplémentaires pour l'étendre aux autres images Docker basées sur Debian (par exemple, :latest, :emulators et :slim). Pour étendre l'image Docker :stable, vous pouvez effectuer l'une des opérations suivantes :

• Étendre l'image de base :stable en la personnalisant au moment de l'exécution
• Étendre l'image de base :stable en créant votre propre fichier Dockerfile

Étendre l'image de base :stable en la personnalisant lors de l'exécution

Vous pouvez étendre l'image Docker :stable pour l'utiliser comme image :latest, :emulators ou :slim en la personnalisant au moment de l'exécution.

Personnaliser l'image :latest

Exécutez la commande docker run suivante pour étendre l'image Docker :stable à l'image Docker :latest au moment de l'exécution :

$ 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

Remarque : Si vous avez besoin d'un moteur Docker installé dans votre image Docker, vous pouvez étendre votre image :stable en l'utilisant dans un fichier Dockerfile. Pour obtenir la procédure à suivre, consultez Étendre l'image de base :stable en créant votre propre fichier Dockerfile.

Personnaliser l'image :emulators

Vous pouvez exécuter la commande suivante pour étendre l'image Docker :stable dans l'image Docker :emulators au moment de l'exécution :

$ 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

Personnaliser l'image :slim

Vous pouvez étendre l'image Docker :stable en tant qu'image Docker :slim en exécutant la commande docker run suivante :

$ 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

Remarque : Si vous avez besoin d'un moteur Docker installé dans votre image Docker, vous pouvez créer votre image à partir des fichiers Dockerfile préexistants. Pour obtenir la procédure à suivre, consultez Étendre l'image de base :stable en créant votre propre fichier Dockerfile.

Étendre l'image :stable avec la configuration de compilation

Vous pouvez utiliser vos propres fichiers de configuration de compilation personnalisés pour étendre l'image Docker :stable et installer des packages ou des composants supplémentaires. Par exemple, si vous souhaitez étendre votre image Docker :stable pour installer les packages python3-google-auth et python3-requests, et installer le composant pubsub emulator, vous pouvez utiliser le fichier de configuration de compilation suivant.

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'

Étendre l'image de base :stable en créant votre propre fichier Dockerfile

Vous pouvez étendre l'image Docker :stable en créant votre propre fichier Dockerfile avec l'image :stable comme image de base, puis en créant l'image Docker avec la commande docker build.

Créer votre propre :latest Image

Pour convertir l'image :stable en image :latest, procédez comme suit :

1. Créez votre propre Dockerfile à partir de :stable en installant les composants et packages requis :

   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. Créez le fichier Dockerfile pour obtenir votre propre image Docker :latest :

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

Créer votre propre :emulators Image

Pour convertir l'image :stable en image :emulators, procédez comme suit :

1. Créez le fichier Dockerfile avec les composants et packages requis comme suit :

   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. Créez le fichier Dockerfile en exécutant la commande suivante :

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

Créer votre propre :slim Image

Pour convertir l'image :stable en image :slim, procédez comme suit :

1. Créez un fichier Dockerfile à l'aide de :stable comme image de base :

   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. Créez le fichier Dockerfile en exécutant la commande suivante :

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