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 el despliegue de tu aplicación en función de las demandas de la carga de trabajo, 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 se encargan de crear cargas de trabajo de aplicaciones para su organización. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.

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 de la organización o en un clúster estándar del 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 de proyectos que te asigne 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 estado en un clúster estándar, pide a tu administrador de proyectos de gestión de identidades y accesos que te conceda el rol de 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 que tienes 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.

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

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

Crear un despliegue

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

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

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 desplegar las cargas de trabajo de contenedores.

  • NAMESPACE: el espacio de nombres en el que se desplegarán las cargas de trabajo de los contenedores. En el caso de los clústeres compartidos, debe ser un espacio de nombres de proyecto. En el caso de 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 ejecutará en el despliegue.

  • NUMBER_OF_REPLICAS: el número de objetos Pod replicados que gestiona el despliegue.

  • CONTAINER_NAME: el nombre del contenedor.

  • CONTAINER_IMAGE: el nombre de la imagen de contenedor. Debes incluir la ruta del Container Registry 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 información general de Managed Harbor Service.

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 desplegar cargas de trabajo de GPUs en tus contenedores, consulta Gestionar cargas de trabajo de contenedores de GPUs para obtener más información.

Siguientes pasos