Comparteix a través de

Actualización de contenedores en Azure Container Instances

  • Article

Durante el funcionamiento normal de las instancias de contenedor, puede que sea necesario actualizar los contenedores en ejecución de un grupo de contenedores. Por ejemplo, podría querer actualizar una propiedad, como la versión de la imagen, un nombre DNS o una variable de entorno o actualizar una propiedad de un contenedor cuya aplicación se ha bloqueado.

Para actualizar los contenedores de un grupo de contenedores en ejecución, vuelva a implementar un grupo existente con al menos una propiedad modificada. Al actualizar un grupo de contenedores, todos los contenedores en ejecución en el grupo se reinician en contexto, por lo general en el mismo host de contenedor subyacente.

Nota

No se pueden actualizar los grupos de contenedores finalizados o eliminados. Una vez que un grupo de contenedores ha finalizado (se encuentra en un estado correcto o con errores) o se ha eliminado, el grupo se debe implementar como nuevo. Consulte otras limitaciones.

Actualización de un grupo de contenedores

Para actualizar un grupo de contenedores existente:

  • Emita el comando create (o use Azure Portal) y especifique el nombre de un grupo existente.
  • Modifique o agregue al menos una propiedad del grupo que admita su actualización cuando vuelva a realizar la implementación. Algunas propiedades no admiten actualizaciones.
  • Establezca otras propiedades con los valores que proporcionó anteriormente. Si no establece un valor para una propiedad, se revierte a su valor predeterminado.

Nota:

Si establece todas las propiedades en los valores proporcionados anteriormente y no modifica ni agrega ninguno, el contenedor se reiniciará en respuesta al comando create.

Sugerencia

Un archivo YAML ayuda a mantener una configuración de implementación de un grupo de contenedores y proporciona un punto inicial para implementar un grupo actualizado. Si ha utilizado un método diferente para crear el grupo, puede exportar la configuración a YAML mediante az container export.

Ejemplo

En el siguiente ejemplo de la CLI de Azure se actualiza un grupo de contenedores con una nueva etiqueta de nombre DNS. Dado la propiedad de etiqueta del nombre DNS del grupo es una de las que se pueden actualizar, se vuelve a implementar el grupo de contenedores y se reinician sus contenedores.

Implementación inicial con la etiqueta de nombre DNS myapplication-staging:

# Create container group
az container create --resource-group myResourceGroup --name mycontainer \
    --image nginx:alpine --dns-name-label myapplication-staging

Actualice el grupo de contenedores con la nueva etiqueta de nombre DNS application y establezca las demás propiedades con los valores usados previamente:

# Update DNS name label (restarts container), leave other properties unchanged
az container create --resource-group myResourceGroup --name mycontainer \
    --image nginx:alpine --dns-name-label myapplication

Ventajas de la actualización

La principal ventaja de actualizar un grupo de contenedores existente es una implementación más rápida. Al volver a implementar un grupo de contenedores existente, sus capas de imagen de contenedor se extraen de las capas almacenados en caché por la implementación anterior. En lugar de extraer todas las capas de imagen actualizadas del Registro como se hace con las nuevas implementaciones, solo se extraen las capas modificadas (si existen).

Las aplicaciones basadas en imágenes de contenedor más grandes, como Windows Server Core, pueden experimentar una considerable mejora en la velocidad de implementación al actualizarlas, en lugar de eliminarlas y volver a implementarlas.

Limitaciones

  • No todas las propiedades de un grupo de contenedores admiten actualizaciones. Para cambiar algunas propiedades de un grupo de contenedores, primero debe eliminar y volver a implementar el grupo. Consulte Propiedades que requieren la eliminación del contenedor.
  • Todos los contenedores de un grupo de contenedores se reinician al actualizar el grupo de contenedores. No se puede realizar una actualización o reinicio local de un contenedor específico en un grupo de varios contenedores.
  • La dirección IP de un grupo de contenedores normalmente se mantiene entre actualizaciones, pero no se garantiza que permanezca igual. Mientras el grupo de contenedores esté implementado en el mismo host subyacente, conservará su dirección IP. Aunque no es habitual, hay algunos eventos internos de Azure que pueden provocar una nueva implementación en un host diferente. Para mitigar este problema, se recomienda utilizar una etiqueta de nombre DNS para las instancias de contenedor.
  • No se pueden actualizar los grupos de contenedores finalizados o eliminados. Una vez que se ha detenido un grupo de contenedores (se encuentra en estado Terminado) o se ha eliminado, el grupo se implementa como nuevo.

Nota

Es posible que el comando de actualización no funcione si el Azure Container Group está conectado a un perfil de Azure Storage.

Propiedades que requieren la eliminación del contenedor

No todas las propiedades del grupo de contenedores se pueden actualizar. Por ejemplo, para cambiar la directiva de reinicio de un contenedor, primero debe eliminar el grupo de contenedores y luego volver a crearlo.

Los cambios en estas propiedades requieren la eliminación del grupo de contenedores antes de volver a implementarlo:

  • Tipo de SO
  • CPU, memoria o recursos de GPU
  • Directiva de reinicio
  • Perfil de red
  • Zona de disponibilidad

Importante

Los perfiles de red han quedado en desuso desde la versión 2021-07-01 de la API. Si usa esta versión o una versión más reciente, omita los pasos y las acciones relacionados con los perfiles de red.

Al eliminar un grupo de contenedores y volver a crearlo, no se reimplementa sino que se crea uno nuevo. Todas las capas de imagen se extraen actualizadas del Registro, y no de las capas almacenadas en caché por una implementación anterior. La dirección IP del contenedor también podría cambiar debido a que se implementa en un host subyacente diferente.

Pasos siguientes

En este artículo se menciona grupos de contenedores varias veces. Cada contenedor de Azure Container Instances se implementa en un grupo de contenedores y los grupos de contenedores pueden contener más de un contenedor. En los artículos siguientes se proporciona más información sobre los grupos de contenedores: