Acción Amazon S3 publish en YAML - Amazon CodeCatalyst

Acción Amazon S3 publish en YAML

La siguiente es la definición en YAML de la acción Amazon S3 publish. Para obtener información sobre cómo utilizar esta acción, consulte Publicación de archivos en Amazon S3 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 en YAML.

nota

La mayoría de las propiedades de YAML que se muestran a continuación tienen elementos de interfaz de usuario correspondientes en el editor visual. Para buscar un elemento de la interfaz de usuario, use Ctrl+F. El elemento aparecerá en la lista con su propiedad de 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. S3Publish_nn: Identifier: aws/s3-publish@v1 DependsOn: - build-action Compute: Type: EC2 | Lambda Fleet: fleet-name Timeout: timeout-minutes Inputs: Sources: - source-name-1 Artifacts: - artifact-name Variables: - Name: variable-name-1 Value: variable-value-1 - Name: variable-name-2 Value: variable-value-2 Environment: Name: environment-name Connections: - Name: account-connection-name Role: iam-role-name Configuration: SourcePath: my/source DestinationBucketName: amzn-s3-demo-bucket TargetPath: my/target

S3Publish

(Obligatorio)

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

Predeterminado: S3Publish_nn.

Interfaz de usuario correspondiente: pestaña Configuración/Nombre de la acción

Identifier

(S3Publish/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 Especificación de la versión de la acción que se va a utilizar.

Predeterminado: aws/s3-publish@v1.

Interfaz de usuario correspondiente: diagrama de flujo de trabajo/S3Publish_nn/etiqueta aws/s3-publish@v1

DependsOn

(S3Publish/DependsOn)

(Opcional)

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

Para obtener más información sobre la funcionalidad depende de, consulte Secuenciación de acciones.

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

Compute

(S3Publish/Compute)

(Opcional)

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

Interfaz de usuario correspondiente: ninguna

Type

(S3Publish/Compute/Type)

(Obligatorio si se incluye Compute)

El tipo de motor de computación. Puede utilizar uno de los siguientes valores:

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

    Optimizado para ofrecer flexibilidad durante las ejecuciones de acciones.

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

    Velocidades de inicio de acciones optimizadas.

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

Interfaz de usuario correspondiente: pestaña Configuración/Tipo de computación

Fleet

(S3Publish/Compute/Fleet)

(Opcional)

Especifique la máquina o la 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 las flotas bajo demanda.

Con las flotas aprovisionadas, configura un conjunto de máquinas dedicadas para ejecutar las acciones del flujo de trabajo. Estas máquinas permanecen inactivas, listas para procesar acciones de forma inmediata. Para obtener más información sobre las flotas aprovisionadas, consulte Propiedades de flotas aprovisionadas.

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

Interfaz de usuario correspondiente: pestaña Configuración/Flota de computación

Timeout

(S3Publish/Timeout)

(Obligatorio)

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

Interfaz de usuario correspondiente: pestaña Configuración/Tiempo de espera (opcional)

Inputs

(S3Publish/Inputs)

(Opcional)

La sección Inputs define los datos que necesita la acción S3Publish durante la ejecución de un flujo de trabajo.

nota

Se permite un máximo de cuatro entradas (un origen y tres artefactos) en cada acción AWS CDK deploy. Las variables no se contabilizan en este total.

Si necesita hacer referencia a archivos que se encuentran en entradas diferentes (por ejemplo, un código fuente y un artefacto), la entrada de código fuente es la entrada principal y el artefacto es la entrada secundaria. Las referencias a los archivos en las entradas secundarias llevan un prefijo especial para distinguirlas de las principales. Para obtener más información, consulte Ejemplo: Referencia a archivos en varios artefactos.

Interfaz de usuario correspondiente: pestaña Entradas

Sources

(S3Publish/Inputs/Sources)

(Obligatorio si los archivos que quiera publicar en Amazon S3 están almacenados en un repositorio de código fuente)

Si los archivos que quiera publicar en Amazon S3 están almacenados en un repositorio de código fuente, especifique la etiqueta de ese repositorio de código fuente. Actualmente, la única etiqueta admitida es WorkflowSource.

Si los archivos que quiera publicar en Amazon S3 no están incluidos en un repositorio de código fuente, deben residir en un artefacto generado por otra acción.

Para obtener más información sobre orígenes, consulte Conexión de repositorios de código fuente a flujos de trabajo.

Interfaz de usuario correspondiente: pestaña Entradas/Orígenes (opcional)

Artifacts - input

(S3Publish/Inputs/Artifacts)

(Obligatorio si los archivos que quiera publicar en Amazon S3 están almacenados en un artefacto de salida de una acción anterior)

Si los archivos que quiera publicar en Amazon S3 están contenidos en un artefacto generado por una acción anterior, especifique ese artefacto aquí. Si los archivos no están incluidos en un artefacto, deben residir en el repositorio de código fuente.

Para obtener más información sobre los artefactos, incluidos ejemplos, consulte Cómo compartir artefactos y archivos entre acciones.

Interfaz de usuario correspondiente: pestaña Configuración/Artefactos (opcional)

Variables - input

(S3Publish/Inputs/Variables)

(Opcional)

Especifique una secuencia de pares de nombre/valor que definan las variables de entrada que desee que estén disponibles para la acción. Los nombres de variables están limitados a caracteres alfanuméricos (a-z, A-Z y 0-9), guiones (-) y guiones bajos (_). No se permiten espacios. No puede utilizar comillas para permitir caracteres especiales ni espacios en los nombres de variables.

Para obtener más información sobre las variables, incluidos ejemplos, consulte Uso de variables en flujos de trabajo.

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

Environment

(S3Publish/Environment)

(Obligatorio)

Especifique el entorno de CodeCatalyst que se utilizará con la acción. La acción se conecta a la Cuenta de AWS y a la VPC de Amazon especificada en el entorno elegido. La acción utiliza el rol de IAM predeterminado especificado en el entorno para conectarse a la Cuenta de AWS, y utiliza el rol de IAM especificado en la conexión a la VPC de Amazon para conectarse a la VPC de Amazon.

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 Cambio del rol de IAM de una acción.

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

Interfaz de usuario correspondiente: pestaña Configuración/Entorno

Name

(S3Publish/Environment/Name)

(Obligatorio si se incluye Environment)

Especifique el nombre del entorno existente que desea asociar a la acción.

Interfaz de usuario correspondiente: pestaña Configuración/Entorno

Connections

(S3Publish/Environment/Connections)

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

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

Si no especifica una conexión de cuenta:

  • La acción utiliza la conexión de la Cuenta de AWS y el rol de IAM predeterminado especificado en el entorno de la consola de CodeCatalyst. 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.

  • El rol de IAM predeterminado debe incluir las políticas y los permisos que requiere la acción. Para determinar cuáles son esas políticas y permisos, consulte la descripción de la propiedad Role en la documentación de la definición de YAML de la acción.

Para obtener más información sobre las conexiones de cuenta, consulte Permisos de acceso a recursos de AWS con Cuentas de AWS conectadas. Para obtener más información sobre cómo añadir una conexión de cuenta a un entorno, consulte Creació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 Configuración/Entorno/¿Qué hay en mi-entorno?/menú de tres puntos/Cambiar rol

  • (Versiones más antiguas) pestaña Configuración/'Entorno/cuenta/rol'/Conexión de cuenta de AWS

Name

(S3Publish/Environment/Connections/Name)

(Obligatorio si se incluye Connections)

Especifique el nombre de la conexión de cuenta.

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

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

  • (Versiones más antiguas) pestaña Configuración/'Entorno/cuenta/rol'/Conexión de cuenta de AWS

Role

(S3Publish/Environment/Connections/Role)

(Obligatorio si se incluye Connections)

Especifique el nombre del rol de IAM que la acción de Amazon S3 publish utiliza para acceder a AWS y copiar los archivos a Amazon S3. Asegúrese de haber añadido el rol a su espacio de CodeCatalyst 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 en la consola de 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 de seguridad.

    { "Version": "2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "s3:PutObject", "s3:ListBucket", "s3:DeleteObject" ], "Resource": [ "arn:aws:s3:::bucket-name", "arn:aws:s3:::bucket-name/*" ] } ] }
  • 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" } ] }
nota

Puede usar el rol CodeCatalystWorkflowDevelopmentRole-spaceName con esta acción, si así lo desea. Para obtener más información acerca de este rol, consulte Creación del rol CodeCatalystWorkflowDevelopmentRole-spaceName para su cuenta y su espacio. Tenga en cuenta que el rol CodeCatalystWorkflowDevelopmentRole-spaceName tiene permisos de acceso total, lo que puede suponer un riesgo para la seguridad. Le recomendamos que utilice este rol solo en tutoriales y situaciones en las que la seguridad no sea un problema.

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

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

  • (Versiones más antiguas) Pestaña Configuración/'Entorno/cuenta/rol'/Rol

Configuration

(S3Publish/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 Configuración

SourcePath

(S3Publish/Configuration/SourcePath)

(Obligatorio)

Especifique el nombre y la ruta del directorio o archivo que quiera publicar en Amazon S3. El directorio o archivo puede residir en un repositorio de código fuente o en un artefacto de una acción anterior y son relativas a la raíz del repositorio de código fuente o del artefacto.

Ejemplos:

La especificación de ./myFolder/ copia el contenido de /myFolder en Amazon S3 y conserva la estructura de directorios subyacente.

La especificación de ./myFolder/myfile.txt copia únicamente myfile.txt en Amazon S3. (Se elimina la estructura de directorios).

No puede utilizar caracteres comodín.

nota

Puede que tenga que añadir un prefijo al directorio o ruta del archivo para indicar en qué artefacto u origen debe encontrarlo. Para obtener más información, consulte Referencia a los archivos del repositorio de código fuente y Referencia a archivos en un artefacto.

Interfaz de usuario correspondiente: pestaña Configuración/Ruta de origen

DestinationBucketName

(S3Publish/Configuration/DestinationBucketName)

(Obligatorio)

Especifique el nombre del bucket de Amazon S3 donde quiera publicar los archivos.

Interfaz de usuario correspondiente: pestaña Configuración/Bucket de destino (opcional)

TargetPath

(S3Publish/Configuration/TargetPath)

(Opcional)

Especifique el nombre y la ruta del directorio de Amazon S3 donde quiera publicar los archivos. Si el directorio no existe, se creará. La ruta del directorio no debe incluir el nombre del bucket.

Ejemplos:

myS3Folder

./myS3Folder/myS3Subfolder

Interfaz de usuario correspondiente: pestaña Configuración/Directorio de destino (opcional)