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_KUBECONFIGen 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 objetoDeployment.APP_NAME: el nombre de la aplicación que se ejecutará en el despliegue.NUMBER_OF_REPLICAS: el número de objetosPodreplicados 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, comoREGISTRY_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
- Inspeccionar cargas de trabajo sin reconocimiento del estado
- Actualizar cargas de trabajo sin estado
- Gestionar pools de nodos