Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Atlas Kubernetes Operator Dry ejecutar

Con la funcionalidad del Atlas Kubernetes Operator Dry Run, puedes ver qué va a cambiar Atlas Kubernetes Operator en Atlas cuando se apliquen esos recursos personalizados al clúster de K8S. Atlas Kubernetes Operator emite eventos para cada recurso que se va a crear/actualizar/borrar en Atlas. Los eventos emitidos por el Atlas Kubernetes Operator ejecutándose en modo de Dry Run pueden filtrarse por la razón "Dry Run". Esta funcionalidad es útil para actualizar tus recursos de Atlas Operator.

Para usar la función Dry Run de Atlas Kubernetes Operator, necesitas:

  • Tener acceso a un nuevo clúster de Kubernetes u OpenShift.

  • Aplica los recursos personalizados del Atlas Kubernetes Operator en tu nuevo clúster de Kubernetes. Cuando apliques tus recursos, asegúrate de proporcionar un secreto con credenciales. Necesitas un nuevo clúster, porque actualizar los CRDs en tu clúster de Kubernetes existente podría dejar al Atlas Kubernetes Operator incapaz de reconciliar los recursos personalizados existentes. Además, los CRDs que se aplican pueden ser una versión más reciente con posibles cambios disruptivos.

    Nota

    Solo puede existir una versión de los CRD de AKO en un clúster específico de Kubernetes. Esto significa que para probar la actualización a una nueva versión del Atlas Kubernetes Operator, se debe implementar un nuevo clúster de Kubernetes (posiblemente un clúster temporal) para ejecutar la prueba seca.

  • Instale CRD en su clúster para la versión de Atlas Kubernetes Operator con la que desee ejecutar dry-run.

  • Cree una cuenta de servicio mongodb-atlas-operator en su clúster de Kubernetes.

  • Crea un rol y un rolebinding para tu cuenta de servicio con los siguientes permisos relacionados con los recursos personalizados de Atlas Kubernetes Operator. Puedes crear estos recursos manualmente o con la CLI de Atlas.

    • list

    • get

    • create

    • update

    • delete

El proceso de ejecución en seco emite cualquiera de los siguientes tipos de mensajes, cada uno de los cuales puede ser de tipo Normal o Warning:

  • Would [verb] ([HTTP-Method]) [Atlas resource URL]

    • Una descripción de un recurso determinado de Atlas Kubernetes Operator y el proceso necesario de Kubernetes para la aplicación de cambios en tu entorno de Atlas. Cuando está en modo Dry Run, Atlas Kubernetes Operator solo emite eventos de simulación para verbos HTTP que crearían/actualizarían/eliminarían recursos en Atlas, como POST, PATCH, PUT, DELETE.
  • Done

    • No se reportarán más eventos de ejecución de prueba.
  • Finished

    • La tarea de Kubernetes que ejecuta el proceso dry-run se ha completado.
1

Guarde el siguiente ejemplo en un archivo llamado dry-run-job.yaml y aplíquelo a su clúster ejecutando kubectl apply -f dry-run-job.yaml. Esto iniciará el Atlas Kubernetes Operator como una tarea de Kubernetes con el parámetro --dry-run. Cada reconciliación en Atlas Kubernetes Operator se ejecutará solo una vez, emitiendo eventos para cada recurso si hay cambios entre las especificaciones del recurso y su estado en Atlas.

Puede ejecutar este comando varias veces sin realizar ningún cambio en sus recursos de Atlas.

apiVersion: batch/v1kind: Jobmetadata: name: ako-dry-run namespace: mongodb-atlas-systemspec: backoffLimit: 1 template: spec: containers: - args: - --atlas-domain=https://cloud.mongodb.com/ - --log-level=info - --log-encoder=json - --dry-run command: - /manager env: - name: OPERATOR_POD_NAME value: ako-dry-run - name: OPERATOR_NAMESPACE value: mongodb-atlas-system - name: WATCH_NAMESPACE value: mongodb-atlas-system - name: JOB_NAME value: ako-dry-run image: quay.io/mongodb/mongodb-atlas-kubernetes-operator:2.8.0 imagePullPolicy: Always livenessProbe: failureThreshold: 3 httpGet: path: /healthz port: 8081 scheme: HTTP initialDelaySeconds: 15 periodSeconds: 20 successThreshold: 1 timeoutSeconds: 1 name: ako-dry-run restartPolicy: Never serviceAccountName: mongodb-atlas-operator
2

Cuando se termine la tarea de Kubernetes, puedes listar los eventos emitidos ejecutando el siguiente comando:

kubectl -n mongodb-atlas-system get events --field-selector reason=DryRun

Este comando devolverá una salida similar a la siguiente:

LAST SEEN TYPE REASON OBJECT MESSAGE103s Normal DryRun atlasproject/my-project Would delete (DELETE) /api/atlas/v1.0/groups/6558f184beba40022cbb2043/integrations/SLACK101s Warning DryRun atlasproject/my-project finished dry run

Cuando --log-level se configura en debug, el Atlas Kubernetes Operator proporciona una diferencia detallada de los cambios que realices en los recursos de Atlas gestionados por el Atlas Kubernetes Operator. Este diff es especialmente útil cuando se utiliza junto con la funcionalidad Ejecución en seco, ya que permite ver las diferencias entre el estado actual de los recursos personalizados de su Atlas Kubernetes Operator y el estado que el Atlas Kubernetes Operator aplicaría a su entorno Atlas.

Esta funcionalidad de diferencia está informada por la comparación del resultado de cualquier solicitud PUT o PATCH enviada a Atlas con el estado actual de los recursos personalizados de Atlas Kubernetes Operator en tu entorno de Atlas.

Nota

Para facilitar esta comparación, el Atlas Kubernetes Operator realiza una solicitud GET a Atlas para aprender el estado actual de los recursos en Atlas. Por lo tanto, recomendamos que solo se establezca el nivel de registro en depuración en entornos que no sean de producción, ya que esta funcionalidad puede aumentar la carga en Atlas.

Para ver las diferencias, debes configurar la bandera --log-level=debug al ejecutar el comando del Atlas Kubernetes Operator. Como Atlas Kubernetes Operator utiliza registros estructurados, recomendamos analizar el diff JSON en un visor de registros estructurados para una mejor legibilidad humana. El siguiente ejemplo muestra una línea de registro del Atlas Kubernetes Operator DEBUG procesada en formato YAML, tal como se muestra en un visor de registro estructurado:

apiVersion: atlas.mongodb.com/v1kind: AtlasDeploymentmetadata: name: test namespace: flexspec: flexSpec: name: test providerSettings: backingProviderName: AWS regionName: US_EAST_1 terminationProtectionEnabled: true -> false projectRef: name: test