Definición de YAML de la acción «Implementar en un clúster de Kubernetes» - Amazon CodeCatalyst
DeployToKubernetesClusterIdentifierDependsOnComputeTypeFleetTimeoutEnvironmentNameConnectionsNameRoleInputsSourcesArtifacts - inputConfigurationNamespaceRegionClusterManifests

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Definición de YAML de la acción «Implementar en un clúster de Kubernetes»

La siguiente es la definición en YAML de la acción Implementar en un clúster de Kubernetes. Para obtener información sobre cómo utilizar esta acción, consulte. Implementación de una aplicación en Amazon Elastic Kubernetes Service con un flujo de trabajo

Esta definición de acción existe como una sección dentro de un archivo de definición de flujo de trabajo más amplio. Para obtener más información acerca de este archivo, consulte Definición de flujo de trabajo YAML.

nota

La mayoría de las propiedades de YAML que aparecen a continuación tienen los elementos de interfaz de usuario correspondientes en el editor visual. Para buscar un elemento de la interfaz de usuario, usa Ctrl+F. El elemento aparecerá en la lista con su propiedad YAML asociada.

# The workflow definition starts here.
# See Propiedades de nivel superior for details.
        
Name: MyWorkflow
SchemaVersion: 1.0 
Actions:

# The action definition starts here.   
  DeployToKubernetesCluster_nn: 
    Identifier: aws/kubernetes-deploy@v1
    DependsOn:
      - build-action
    Compute:  
        - Type: EC2 | Lambda
        - Fleet: fleet-name
    Timeout: timeout-minutes
    Environment:
      Name: environment-name
      Connections:
        - Name: account-connection-name
          Role: DeployToEKS
    Inputs:
      # Specify a source or an artifact, but not both.
      Sources:
        - source-name-1
      Artifacts:
        - manifest-artifact
    Configuration:
      Namespace: namespace
      Region: us-east-1 
      Cluster: eks-cluster
      Manifests: manifest-path

DeployToKubernetesCluster

(Obligatorio)

Especifique el nombre de la acción. Todos los nombres de las acciones deben ser únicos en el flujo de trabajo. Los nombres de las acciones se limitan a caracteres alfanuméricos (a-z, A-Z, 0-9), guiones (-) y guiones bajos (_). No se permiten espacios. No puede utilizar comillas para activar los caracteres especiales y los espacios en los nombres de las acciones.

Predeterminado: DeployToKubernetesCluster_nn.

Interfaz de usuario correspondiente: pestaña de configuración o nombre para mostrar de la acción

Identifier

(DeployToKubernetesCluster/Identifier)

(Obligatorio)

Identifica la acción. No cambie esta propiedad a menos que desee cambiar la versión. Para obtener más información, consulte Especificar la versión principal, secundaria o de parche de una acción.

Predeterminado: aws/kubernetes-deploy@v1.

Interfaz de usuario correspondiente: diagrama de flujo de trabajo/ DeployToKubernetesCluster _nn/ aws/kubernetes-deploy @v1 label

DependsOn

(DeployToKubernetesCluster/DependsOn)

(Opcional)

Especifique una acción, un grupo de acciones o una puerta que debe ejecutarse correctamente para que esta acción se ejecute.

Para obtener más información sobre la funcionalidad «depende de», consulte. Configurar acciones para que dependan de otras acciones

Interfaz de usuario correspondiente: pestaña de entradas/Depende de: opcional

Compute

(DeployToKubernetesCluster/Compute)

(Opcional)

El motor informático utilizado para ejecutar las acciones del flujo de trabajo. Puede especificar el procesamiento en el nivel del flujo de trabajo o en el nivel de acción, pero no en ambos. Cuando se especifica en el nivel del flujo de trabajo, la configuración de procesamiento se aplica a todas las acciones definidas en el flujo de trabajo. En el nivel del flujo de trabajo, también puedes ejecutar varias acciones en la misma instancia. Para obtener más información, consulte Compartir el cómputo entre las acciones.

Interfaz de usuario correspondiente: ninguna

Type

(DeployToKubernetesCluster/Compute/Type)

(Obligatorio si Compute está incluido)

El tipo de motor de cómputo. Puede usar uno de los siguientes valores:

  • EC2 (editor visual) o EC2 (editor YAML)

    Optimizado para ofrecer flexibilidad durante las ejecuciones de acción.

  • Lambda (editor visual) o Lambda (editor YAML)

    Velocidades de inicio de acciones optimizadas.

Para obtener más información sobre los tipos de computación, consulte Tipos de cómputo.

Interfaz de usuario correspondiente: pestaña de configuración/Avanzada: opcional/tipo de cálculo

Fleet

(DeployToKubernetesCluster/Compute/Fleet)

(Opcional)

Especifique la máquina o flota que ejecutará el flujo de trabajo o las acciones del flujo de trabajo. Con las flotas bajo demanda, cuando se inicia una acción, el flujo de trabajo aprovisiona los recursos que necesita y las máquinas se destruyen cuando finaliza la acción. Ejemplos de flotas bajo demanda:Linux.x86-64.Large,. Linux.x86-64.XLarge Para obtener más información sobre las flotas bajo demanda, consulte. Propiedades de la flota bajo demanda

Con las flotas aprovisionadas, puede configurar un conjunto de máquinas dedicadas para ejecutar las acciones de su flujo de trabajo. Estas máquinas permanecen inactivas y listas para procesar las acciones de forma inmediata. Para obtener más información sobre las flotas aprovisionadas, consulte. Propiedades de la flota aprovisionada

Si Fleet se omite, el valor predeterminado es. Linux.x86-64.Large

Interfaz de usuario correspondiente: pestaña de configuración/Avanzada: opcional/Flota de cómputo

Timeout

(DeployToKubernetesCluster/Timeout)

(Opcional)

Especifica la cantidad de tiempo en minutos (editor YAML) o en horas y minutos (editor visual) que la acción puede ejecutarse antes de que finalice la acción. CodeCatalyst El mínimo es de 5 minutos y el máximo se describe enCuotas para flujos de trabajo. El tiempo de espera predeterminado es el mismo que el tiempo de espera máximo.

Interfaz de usuario correspondiente: pestaña de configuración/tiempo de espera: opcional

Environment

(DeployToKubernetesCluster/Environment)

(Obligatorio)

Especifique el CodeCatalyst entorno que se va a utilizar con la acción. La acción se conecta a Cuenta de AWS la Amazon VPC opcional especificada en el entorno elegido. La acción utiliza la función de IAM predeterminada especificada en el entorno para conectarse a Cuenta de AWS, y utiliza la función de IAM especificada en la conexión de Amazon VPC para conectarse a la Amazon VPC.

nota

Si el rol de IAM predeterminado no tiene los permisos necesarios para la acción, puede configurarla para que utilice un rol diferente. Para obtener más información, consulte Asignación de una función de IAM diferente a una acción.

Para obtener más información sobre los entornos, consulte Implementación en Cuentas de AWS entornos y VPC con ellos CodeCatalyst yCreación de un entorno.

Interfaz de usuario correspondiente: pestaña de configuración/entorno

Name

(DeployToKubernetesCluster/Environment/Name)

(Obligatorio si Environment está incluido)

Especifique el nombre de un entorno existente que desee asociar a la acción.

Interfaz de usuario correspondiente: pestaña de configuración/entorno

Connections

(DeployToKubernetesCluster/Environment/Connections)

(Opcional en las versiones más recientes de la acción; obligatorio en las versiones anteriores)

Especifique la conexión de cuenta que desee asociar a la acción. Puede especificar un máximo de una conexión de cuenta por debajoEnvironment.

Si no especificas una conexión de cuenta:

  • La acción utiliza la Cuenta de AWS conexión y la función de IAM predeterminada especificadas en el entorno de la CodeCatalyst consola. Para obtener información sobre cómo añadir una conexión de cuenta y un rol de IAM predeterminado al entorno, consulte. Creación de un entorno

  • La función de IAM predeterminada debe incluir las políticas y los permisos que requiere la acción. Para determinar cuáles son esas políticas y permisos, consulta la descripción de la propiedad del rol en la documentación de definición de YAML de la acción.

Para obtener más información sobre las conexiones de cuentas, consultePermitir el acceso a AWS los recursos con conexión Cuentas de AWS. Para obtener información sobre cómo añadir una conexión de cuenta a un entorno, consulteCreación de un entorno.

Interfaz de usuario correspondiente: una de las siguientes, según la versión de la acción:

  • (Versiones más recientes) Pestaña de configuración/Entorno/¿Qué hay en mi entorno? /menú de tres puntos/ Cambiar rol

  • (Versiones anteriores) Pestaña de configuración/'Entorno/cuenta/role'/ conexión de la cuenta AWS

Name

(DeployToKubernetesCluster/Environment/Connections/Name)

(Opcional)

Especifique el nombre de la conexión de la cuenta.

Interfaz de usuario correspondiente: una de las siguientes, según la versión de la acción:

  • (Versiones más recientes) Pestaña de configuración/Entorno/¿Qué hay en mi entorno? /menú de tres puntos/ Cambiar rol

  • (Versiones anteriores) Pestaña de configuración/'Entorno/cuenta/role'/ conexión de la cuenta AWS

Role

(DeployToKubernetesCluster/Environment/Connections/Role)

Connections(Obligatorio si está incluido)

Especifique el nombre de la función de IAM a la que se accede mediante la acción Implementar en el clúster de Kubernetes. AWS Asegúrese de haber agregado el rol a su CodeCatalyst espacio y de que el rol incluya las siguientes políticas.

Si no especifica un rol de IAM, la acción utilizará el rol de IAM predeterminado que aparece en el entorno de la consola. CodeCatalyst Si usa el rol predeterminado en el entorno, asegúrese de que tenga las siguientes políticas.

  • La siguiente política de permisos:

    aviso

    Limite los permisos a los que se muestran en la siguiente política. El uso de un rol con permisos más amplios puede suponer un riesgo para la seguridad.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "eks:DescribeCluster",
                "eks:ListClusters"
            ],
            "Resource": "*"
        }
    ]
}
    nota

    La primera vez que utilice el rol, utilice el siguiente comodín en la declaración de política de recursos y, a continuación, defina la política con el nombre del recurso cuando esté disponible.

    "Resource": "*"

  • La siguiente política de confianza personalizada:

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Principal": {
                "Service":  [
                   "codecatalyst-runner.amazonaws.com",
                   "codecatalyst.amazonaws.com"
                 ]
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

Asegúrese de que este rol esté agregado a:

sugerencia

Consulte también las Tutorial: Implementación de una aplicación en Amazon EKS instrucciones sobre cómo añadir un rol de IAM a una conexión de cuenta y. ConfigMap

nota

Si lo deseas, puedes usar el CodeCatalystWorkflowDevelopmentRole-spaceName rol con esta acción. Para obtener más información acerca de este rol, consulte Crear el CodeCatalystWorkflowDevelopmentRole-spaceNamerol para su cuenta y su espacio. Ten en cuenta que el CodeCatalystWorkflowDevelopmentRole-spaceName rol tiene permisos de acceso total, lo que puede suponer un riesgo para la seguridad. Le recomendamos que utilice esta función únicamente en los tutoriales y situaciones en las que la seguridad sea un problema menor.

Interfaz de usuario correspondiente: una de las siguientes, según la versión de la acción:

  • (Versiones más recientes) Pestaña de configuración/Entorno/¿Qué hay en mi entorno? /menú de tres puntos/ Cambiar rol

  • (Versiones anteriores) Pestaña de configuración/'Entorno/cuenta/role'/ Rol

Inputs

(DeployToKubernetesCluster/Inputs)

Connections(Obligatorio si está incluido)

La Inputs sección define los datos que se DeployToKubernetesCluster necesitan durante la ejecución de un flujo de trabajo.

nota

Solo se permite una entrada (ya sea una fuente o un artefacto) por cada acción de implementación en Amazon EKS.

Interfaz de usuario correspondiente: pestaña de entradas

Sources

(DeployToKubernetesCluster/Inputs/Sources)

(Obligatorio si el archivo de manifiesto está almacenado en un repositorio de origen)

Si tu archivo o archivos de manifiesto de Kubernetes están almacenados en un repositorio de origen, especifica la etiqueta de ese repositorio de origen. Actualmente, la única etiqueta admitida es. WorkflowSource

Si los archivos de manifiesto no están contenidos en un repositorio de origen, deben residir en un artefacto generado por otra acción.

Para obtener más información sobre orígenes, consulte Conexión de un flujo de trabajo a un repositorio de origen.

Interfaz de usuario correspondiente: pestaña Entradas/Fuentes (opcional)

Artifacts - input

(DeployToKubernetesCluster/Inputs/Artifacts)

(Obligatorio si el archivo de manifiesto está almacenado en un artefacto de salida de una acción anterior)

Si el archivo o los archivos de manifiesto de Kubernetes están contenidos en un artefacto generado por una acción anterior, especifique ese artefacto aquí. Si tus archivos de manifiesto no están contenidos en un artefacto, deben residir en tu repositorio de origen.

Para obtener más información sobre los artefactos, incluidos ejemplos, consulteCompartir datos entre acciones de un flujo de trabajo mediante artefactos.

Interfaz de usuario correspondiente: pestaña de configuración/Artefactos: opcional

Configuration

(DeployToKubernetesCluster/Configuration)

(Obligatorio)

Una sección en la que puede definir las propiedades de configuración de la acción.

Interfaz de usuario correspondiente: pestaña de configuración

Namespace

(DeployToKubernetesCluster/Configuration/Namespace)

(Opcional)

Especifique el espacio de nombres de Kubernetes en el que se desplegará la aplicación de Kubernetes. Úselo default si no utiliza espacios de nombres con su clúster. Para obtener más información sobre los espacios de nombres, consulta Subdividir el clúster mediante espacios de nombres de Kubernetes en la documentación de Kubernetes.

Si omites el espacio de nombres, se usará el valor de. default

Interfaz de usuario correspondiente: pestaña de configuración/espacio de nombres

Region

(DeployToKubernetesCluster/Configuration/Region)

(Obligatorio)

Especifique la AWS región en la que residen el clúster y el servicio de Amazon EKS. Para obtener una lista de los códigos de región, consulte los puntos de enlace regionales en. Referencia general de AWS

Interfaz de usuario correspondiente: pestaña de configuración/región

Cluster

(DeployToKubernetesCluster/Configuration/Cluster)

(Obligatorio)

Especifique el nombre de un clúster de Amazon EKS existente. La acción Implementar en un clúster de Kubernetes desplegará la aplicación contenerizada en este clúster. Para obtener más información sobre los clústeres de Amazon EKS, consulte Clústeres en la Guía del usuario de Amazon EKS.

Interfaz de usuario correspondiente: pestaña de configuración/clúster

Manifests

(DeployToKubernetesCluster/Configuration/Manifests)

(Obligatorio)

Especifique la ruta a sus archivos de manifiesto de Kubernetes con formato YAML, que se denominan archivos de configuración, archivos de configuración o, simplemente, configuraciones, en la documentación de Kubernetes.

Si utilizas varios archivos de manifiesto, colócalos en una sola carpeta y haz referencia a esa carpeta. Kubernetes procesa los archivos de manifiesto de forma alfanumérica, así que asegúrate de anteponer números o letras crecientes a los nombres de los archivos para controlar el orden de procesamiento. Por ejemplo:

00-namespace.yaml

01-deployment.yaml

Si los archivos de manifiesto se encuentran en el repositorio de origen, la ruta es relativa a la carpeta raíz del repositorio de origen. Si los archivos residen en un artefacto de una acción de flujo de trabajo anterior, la ruta es relativa a la carpeta raíz del artefacto.

Ejemplos:

Manifests/

deployment.yaml

my-deployment.yml

No utilice caracteres comodín (). *

nota

No se admiten los gráficos de Helm ni los archivos de personalización.

Para obtener más información sobre los archivos de manifiesto, consulte Organizar las configuraciones de los recursos en la documentación de Kubernetes.

Interfaz de usuario correspondiente: pestaña de configuración/manifiestos