Migración a la imagen :stable

Si utiliza las imágenes de Docker :latest , :alpine , :emulators , :latest , :slim y :debian_component_based , le recomendamos migrar a la imagen :stable basada en Debian para obtener un tamaño de imagen más pequeño y mejoras de seguridad. Para migrar a la imagen :stable , puede extender la imagen de Docker :stable a la imagen basada en Debian que esté utilizando.

En algunos casos (por ejemplo, al instalar dependencias antiguas e incompatibles, como Python2 o JDKS antiguos), no siempre es posible extender la imagen :stable . En ese caso, podrías tener que crear tu propio Dockerfile.

Ampliación de la imagen Docker :stable

Puedes usar la imagen de Docker :stable como base e instalar componentes adicionales y paquetes apt para extenderla a otras imágenes de Docker basadas en Debian (p. ej., :latest , :emulators y :slim ). Para extender la imagen de Docker :stable , podemos realizar una de las siguientes acciones:

Ampliación de la imagen base :stable mediante personalización en tiempo de ejecución

Puede ampliar la imagen Docker :stable para usarla como imagen :latest , :emulators o :slim personalizándola en tiempo de ejecución.

Personalizar a la :latest imagen

Ejecute el siguiente comando docker run para extender la imagen Docker :stable a la imagen Docker :latest en tiempo de ejecución:

$ 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

Personalizar la imagen :emulators

Puede ejecutar el siguiente comando para extender la imagen Docker :stable a la imagen Docker :emulators en tiempo de ejecución:

$ 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

Personalizar la imagen :slim

Puede ampliar la imagen Docker :stable como la imagen Docker :slim ejecutando el siguiente comando docker run :

$ 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

Ampliación de la imagen :stable con configuración de compilación

Puedes usar tus propios archivos de configuración de compilación para ampliar la imagen de Docker :stable e instalar paquetes o componentes adicionales. Por ejemplo, si quieres ampliar tu imagen de Docker :stable para instalar los paquetes python3-google-auth y python3-requests e instalar el componente pubsub emulator , puedes usar el siguiente archivo de configuración de compilación.

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'

Ampliar la imagen base :stable creando su propio Dockerfile

Puede ampliar la imagen Docker :stable creando su propio Dockerfile con la imagen :stable como imagen base y luego construir la imagen Docker con el comando docker build .

Crea tu propia imagen :latest

Para convertir la imagen :stable en la imagen :latest , haga lo siguiente:

  1. Crea tu propio Dockerfile desde :stable instalando los componentes y paquetes necesarios:

    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. Construye el Dockerfile para obtener tu propia imagen Docker :latest :

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

Crea tu propia imagen de :emulators

Para convertir la imagen :stable en la imagen :emulators , haga lo siguiente:

  1. Cree el Dockerfile con los componentes y paquetes necesarios como:

    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. Construya el Dockerfile ejecutando el comando:

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

Crea tu propia imagen :slim

Para convertir la imagen :stable en la imagen :slim , haga lo siguiente:

  1. Cree un Dockerfile usando :stable como imagen 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. Construya el Dockerfile ejecutando el siguiente comando: 

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