Crear cargas de trabajo sin estado

En este documento se explica cómo crear y gestionar cargas de trabajo sin estado en un clúster de Kubernetes aislado de Google Distributed Cloud (GDC). Las cargas de trabajo sin estado te permiten escalar la implementación de tu aplicación en función de las demandas de la carga de trabajo, todo ello sin tener que gestionar el almacenamiento persistente en un clúster de Kubernetes para almacenar datos o el estado de la aplicación. Este documento te ayudará a empezar para que puedas optimizar y ajustar la disponibilidad de tu aplicación de forma eficiente.

Este documento está dirigido a los desarrolladores del grupo de operadores de aplicaciones, que son los responsables de crear cargas de trabajo de aplicaciones para su organización. Para obtener más información, consulta Audiencias de la documentación aislada de GDC.

Antes de empezar

Para completar las tareas de este documento, debes solicitar los permisos necesarios.

Solicitar roles de gestión de identidades y accesos

Debes tener roles específicos para obtener los permisos que necesitas para crear cargas de trabajo sin estado. Los roles que necesitas dependen de si trabajas en un clúster compartido con ámbito de organización o en un clúster estándar con ámbito de proyecto. Para obtener más información, consulta Configuraciones de clústeres de Kubernetes.

Roles de clúster compartidos

Para crear, eliminar, editar o ver cargas de trabajo sin estado en un clúster compartido, pide a tu administrador de gestión de identidades y accesos del proyecto que te conceda el rol Administrador de espacio de nombres (namespace-admin). Este rol está vinculado al espacio de nombres de tu proyecto.

Roles de clúster estándar

Para crear, eliminar, editar o ver cargas de trabajo sin reconocimiento del estado en un clúster estándar, pide al administrador de gestión de identidades y accesos de tu proyecto que te conceda el rol Desarrollador de clústeres (cluster-developer). Este rol está vinculado al espacio de nombres de tu proyecto.

Prepara tu entorno

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

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

  • Inicia sesión y genera el archivo kubeconfig del clúster de Kubernetes.

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

Crear un despliegue

Para crear una implementación, escribe un Deployment archivo de manifiesto y ejecuta kubectl apply para crear el recurso. Este método también conserva las actualizaciones realizadas en los recursos activos sin combinar los cambios en los archivos de manifiesto.

Para crear un Deployment a partir de su archivo de manifiesto, ejecuta el siguiente comando:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    apply -f - <<EOF
apiVersion: apps/v1
kind: Deployment
metadata:
  name: DEPLOYMENT_NAME
spec:
  replicas: NUMBER_OF_REPLICAS
  selector:
    matchLabels:
      run: APP_NAME
  template:
    metadata:
      labels: # The labels given to each pod in the deployment, which are used
              # to manage all pods in the deployment.
        run: APP_NAME
    spec: # The pod specification, which defines how each pod runs in the deployment.
      containers:
      - name: CONTAINER_NAME
        image: CONTAINER_IMAGE
EOF

Haz los cambios siguientes:

  • KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster de Kubernetes en el que vas a implementar las cargas de trabajo de los contenedores.

  • NAMESPACE: el espacio de nombres en el que se van a desplegar las cargas de trabajo del contenedor. En el caso de los clústeres compartidos, debe ser un espacio de nombres de proyecto. En los clústeres estándar, puede ser cualquier espacio de nombres.

  • DEPLOYMENT_NAME: el nombre del objeto Deployment.

  • APP_NAME: el nombre de la aplicación que se va a ejecutar en la implementación.

  • NUMBER_OF_REPLICAS: número de objetos Pod replicados que gestiona la implementación.

  • CONTAINER_NAME: el nombre del contenedor.

  • CONTAINER_IMAGE: el nombre de la imagen del contenedor. Debes incluir la ruta del registro de contenedores y la versión de la imagen, como REGISTRY_PATH/hello-app:1.0. Para obtener más información sobre cómo definir la ruta del registro de contenedores, consulta la descripción general del servicio Harbor gestionado.

Por ejemplo:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 3
  selector:
    matchLabels:
      run: my-app
  template:
    metadata:
      labels:
        run: my-app
    spec:
      containers:
      - name: hello-app
        image: REGISTRY_PATH/hello-app:1.0

Si vas a implementar cargas de trabajo de GPU en tus contenedores, consulta Gestionar cargas de trabajo de contenedores de GPU para obtener más información.

Siguientes pasos