En esta página se explica cómo actualizar las cargas de trabajo sin estado que se ejecutan en un clúster de Kubernetes de un dispositivo aislado de Google Distributed Cloud (GDC). A medida que tu aplicación evoluciona en función del uso de recursos y las optimizaciones de configuración, debes actualizar la especificación del pod subyacente en el clúster de Kubernetes para reflejar esos cambios en la carga de trabajo.
Esta página está dirigida a los desarrolladores del grupo de operadores de aplicaciones, que son responsables de actualizar las cargas de trabajo de las aplicaciones de su organización.
Antes de empezar
Para ejecutar comandos en el clúster de Kubernetes de Bare Metal preconfigurado, asegúrate de tener los siguientes recursos:
Busca el nombre del clúster de Kubernetes o pregunta al administrador de la plataforma cuál es.
Inicia sesión y genera el archivo kubeconfig del clúster de Kubernetes si no tienes uno.
Usa la ruta kubeconfig del clúster de Kubernetes para sustituir
CLUSTER_KUBECONFIGen estas instrucciones.
Para obtener los permisos necesarios para actualizar las cargas de trabajo sin estado, pide a tu administrador de gestión de identidades y accesos de la organización que te conceda el rol Administrador de espacio de nombres (namespace-admin) en el espacio de nombres de tu proyecto.
Actualizar el despliegue
Para actualizar un objeto Deployment, ejecuta el siguiente comando:
kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
apply -f DEPLOYMENT_FILE
Haz los cambios siguientes:
CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster de Kubernetes que ejecuta la implementación.NAMESPACE: el espacio de nombres del proyecto.DEPLOYMENT_FILE: el nombre delDeploymentarchivo de manifiesto que se va a actualizar.
El comando kubectl apply aplica un archivo de manifiesto a un recurso. Si el recurso especificado no existe, lo crea el comando.
También hay otras formas de actualizar los recursos de tu implementación.
Actualizar una imagen de contenedor
Para cambiar la imagen de un objeto Deployment, ejecuta el siguiente comando:
kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
set image deployment DEPLOYMENT_NAME \
IMAGE=IMAGE:TAG
Haz los cambios siguientes:
CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster de Kubernetes que ejecuta la implementación.NAMESPACE: el espacio de nombres del proyecto.DEPLOYMENT_NAME: el nombre del objetoDeploymentque contiene la imagen.IMAGE: el nombre de la imagen del contenedor.TAG: la etiqueta que se va a actualizar en la imagen del contenedor.
Actualizar la imagen de una implementación es útil para cambiar los campos de selector o los recursos, como las solicitudes o los límites.
Por ejemplo, para actualizar un objeto Deployment llamado nginx para que use la versión 1.9.1, ejecuta el siguiente comando:
kubectl --kubeconfig /tmp/kubeconfig.yaml -n my-namespace \
set image deployment nginx nginx=nginx:1.9.1
Restaurar una actualización
Si quieres restaurar una versión anterior de una actualización, por ejemplo, cuando tu implementación se vuelva inestable, usa la CLI de kubectl. El historial de lanzamiento de un objeto Deployment se conserva en el sistema para que puedas revertir el lanzamiento en cualquier momento.
Para revertir una actualización en curso o completada a su revisión anterior, ejecuta el siguiente comando:
kubectl --kubeconfig CLUSTER_KUBECONFIG \
-n NAMESPACE \
rollout undo deployment DEPLOYMENT_NAME
Haz los cambios siguientes:
CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster de Kubernetes que ejecuta la implementación.NAMESPACE: el espacio de nombres del proyecto.DEPLOYMENT_NAME: el nombre del objetoDeploymental que se va a revertir.
Para volver a una revisión específica, ejecuta el siguiente comando:
kubectl --kubeconfig CLUSTER_KUBECONFIG \
-n NAMESPACE \
rollout undo deployment DEPLOYMENT_NAME \
--to-revision=REVISION_NUMBER
Haz los cambios siguientes:
CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster de Kubernetes que ejecuta la implementación.NAMESPACE: el espacio de nombres del proyecto.DEPLOYMENT_NAME: el nombre del objetoDeploymental que se va a revertir.REVISION_NUMBER: el número entero que define la revisión a la que se va a revertir, como3.