Actualiza cargas de trabajo sin estado

En este documento, se explica cómo actualizar las cargas de trabajo sin estado existentes que se ejecutan en un clúster de Kubernetes 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.

Este documento está dirigido a los desarrolladores que forman parte del grupo de operadores de aplicaciones y que son responsables de actualizar las cargas de trabajo de las aplicaciones de su organización. Para obtener más información, consulta Públicos de la documentación de Google Distributed Cloud aislado.

Antes de comenzar

Para completar las tareas de este documento, debes tener los siguientes recursos y roles:

  • Para ejecutar comandos en un clúster de Kubernetes, asegúrate de tener los siguientes recursos:

    • Busca el nombre del clúster de Kubernetes o pregúntale a un miembro del grupo de administradores de la plataforma cuál es el nombre del clúster.

    • Accede y genera el archivo kubeconfig para el clúster de Kubernetes si no tienes uno.

    • Usa la ruta de acceso de kubeconfig del clúster de Kubernetes para reemplazar KUBERNETES_CLUSTER_KUBECONFIG en estas instrucciones.

  • Para obtener los permisos necesarios para actualizar cargas de trabajo sin estado en un clúster compartido, pídele al administrador de IAM de tu organización que te otorgue el rol de administrador de espacios de nombres (namespace-admin) en el espacio de nombres de tu proyecto.

  • Para obtener los permisos necesarios para actualizar cargas de trabajo sin estado en un clúster estándar, pídele al administrador de IAM de la organización que te otorgue el rol de desarrollador de clústeres (cluster-developer) en un clúster estándar.

Actualiza la implementación

Para actualizar un objeto Deployment, ejecuta el siguiente comando:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    apply -f DEPLOYMENT_FILE

Reemplaza lo siguiente:

  • KUBERNETES_CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster que ejecuta la implementación.

  • NAMESPACE: es el espacio de nombres. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. En el caso de los clústeres estándares, puede ser cualquier espacio de nombres.

  • DEPLOYMENT_FILE: Es el nombre del archivo de manifiesto Deployment que se actualizará.

El comando kubectl apply aplica un archivo de manifiesto a un recurso. Si el recurso especificado no existe, el comando lo crea.

También existen otras formas de actualizar los recursos dentro de tu implementación.

Actualiza una imagen de contenedor

Para cambiar la imagen de un objeto Deployment, ejecuta el siguiente comando:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    set image deployment DEPLOYMENT_NAME \
    IMAGE=IMAGE:TAG

Reemplaza lo siguiente:

  • KUBERNETES_CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster que ejecuta la implementación.

  • NAMESPACE: es el espacio de nombres. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. En el caso de los clústeres estándares, puede ser cualquier espacio de nombres.

  • DEPLOYMENT_NAME: Es el nombre del objeto Deployment que contiene la imagen.

  • IMAGE por el nombre de la imagen de contenedor

  • TAG: Es la etiqueta que se actualizará para la imagen de contenedor.

Actualizar la imagen de una implementación es útil para cambiar los campos del 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 lo siguiente:

kubectl --kubeconfig /tmp/kubeconfig.yaml -n my-namespace \
    set image deployment nginx nginx=nginx:1.9.1

Revierte una actualización

Si quieres revertir una actualización, por ejemplo, cuando tu implementación se vuelve 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 progreso o completada a su revisión anterior, ejecuta el siguiente comando:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
    -n NAMESPACE \
    rollout undo deployment DEPLOYMENT_NAME

Reemplaza lo siguiente:

  • KUBERNETES_CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster que ejecuta la implementación.

  • NAMESPACE: es el espacio de nombres. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. En el caso de los clústeres estándares, puede ser cualquier espacio de nombres.

  • DEPLOYMENT_NAME: Es el nombre del objeto Deployment que se revertirá.

Para revertir a una revisión específica, ejecuta el siguiente comando:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
    -n NAMESPACE \
    rollout undo deployment DEPLOYMENT_NAME \
    --to-revision=REVISION_NUMBER

Reemplaza lo siguiente:

  • KUBERNETES_CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster que ejecuta la implementación.

  • NAMESPACE: es el espacio de nombres. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. En el caso de los clústeres estándares, puede ser cualquier espacio de nombres.

  • DEPLOYMENT_NAME: Es el nombre del objeto Deployment que se revertirá.

  • REVISION_NUMBER: Es el número entero que define la revisión a la que se revierte, como 3.

¿Qué sigue?