Amazon ya no CodeCatalyst está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cómo migrar desde CodeCatalyst](migration.md).
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.
# Publicación de archivos en Amazon S3 con un flujo de trabajo
En esta sección se describe cómo publicar archivos en Amazon S3 mediante un CodeCatalyst flujo de trabajo. Para ello, debe añadir la acción **Amazon S3 publish** a su flujo de trabajo. La acción **Amazon S3 publish** copia los archivos desde un directorio de origen a un bucket de Amazon S3. El directorio de origen puede residir en:
+ un [repositorio de código fuente](source.md); o
+ un [artefacto de salida](workflows-working-artifacts.md) generado por otra acción del flujo de trabajo.
**Topics**
+ [Cuándo utilizar la acción Amazon S3 publish](#s3-pub-action-when-to-use)
+ [Imagen de tiempo de ejecución utilizada por la acción Amazon S3 publish](#s3-pub-action-runtime)
+ [Ejemplo: Publicación de archivos en Amazon S3](s3-pub-action-example-workflow.md)
+ [Cómo añadir la acción Amazon S3 publish](s3-pub-action-add.md)
+ [Acción Amazon S3 publish en YAML](s3-pub-action-ref.md)
## Cuándo utilizar la acción Amazon S3 publish
Esta acción se usa si:
+ Tiene un flujo de trabajo que genere los archivos que quiera almacenar en Amazon S3.
Por ejemplo, es posible que tenga un flujo de trabajo que cree un sitio web estático que quiera alojar en Amazon S3. En este caso, su flujo de trabajo incluiría una [acción de compilación](build-add-action.md) para crear el HTML y los archivos auxiliares del sitio, y una acción **Amazon S3 publish** para copiar los archivos en Amazon S3.
+ Tiene un repositorio de código fuente que contenga los archivos que quiera almacenar en Amazon S3.
Por ejemplo, puede tener un repositorio de código fuente con archivos de código fuente de las aplicaciones que quiera archivar todas las noches en Amazon S3.
## Imagen de tiempo de ejecución utilizada por la acción Amazon S3 publish
La acción **Amazon S3 publish** se ejecuta en una [imagen de noviembre de 2022](build-images.md#build.previous-image). Para obtener más información, consulte [Imágenes activas](build-images.md#build-curated-images).
# Ejemplo: Publicación de archivos en Amazon S3
El siguiente flujo de trabajo de ejemplo incluye la acción **Amazon S3 publish**, junto con una acción de compilación. El flujo de trabajo crea un sitio web de documentación estática y después lo publica en Amazon S3, donde está alojado. El flujo de trabajo consta de los siguientes componentes que se ejecutarán en orden:
+ Un **desencadenador**: este desencadenador inicia la ejecución automática del flujo de trabajo cuando se introduce un cambio en el repositorio de código fuente. Para obtener más información acerca de los desencadenadores, consulte [Inicio de un flujo de trabajo y ejecución automática mediante desencadenadores](workflows-add-trigger.md).
+ Una acción de **compilación** (`BuildDocs`): al activarla, la acción crea un sitio web de documentación estática (`mkdocs build`) y añade los archivos HTML asociados y los metadatos auxiliares a un artefacto llamado `MyDocsSite`. Para obtener más información sobre la acción de compilación, consulte [Compilación con flujos de trabajo](build-workflow-actions.md).
+ Una acción **Amazon S3 publish** (`PublishToS3`): al finalizar la acción de compilación, esta acción copia el sitio del artefacto `MyDocsSite` a Amazon S3 para su alojamiento.
**nota**
El siguiente ejemplo de flujo de trabajo tiene fines ilustrativos y no funcionará sin una configuración adicional.
**nota**
En el código de YAML que aparece a continuación, puede omitir la sección `Connections:` si lo desea. Si omite esta sección, debe asegurarse de que el rol especificado en el campo **Rol de IAM predeterminado** de su entorno incluya los permisos y las políticas de confianza requeridos por la acción **Amazon S3 publish**. Para obtener más información sobre cómo configurar un entorno con un rol de IAM predeterminado, consulte [Creación de un entorno](deploy-environments-creating-environment.md). Para obtener más información sobre los permisos y las políticas de confianza que requiere la acción **Amazon S3 publish**, consulte la descripción de la propiedad [Role](s3-pub-action-ref.md#s3.pub.environment.connections.role) en la [Acción Amazon S3 publish en YAML](s3-pub-action-ref.md).
```
Name: codecatalyst-s3-publish-workflow
SchemaVersion: 1.0
Triggers:
- Type: PUSH
Branches:
- main
Actions:
BuildDocs:
Identifier: aws/build@v1
Inputs:
Sources:
- WorkflowSource
Configuration:
Steps:
- Run: echo BuildDocs started on `date`
- Run: pip install --upgrade pip
- Run: pip install mkdocs
- Run: mkdocs build
- Run: echo BuildDocs completed on `date`
Outputs:
Artifacts:
- Name: MyDocsSite
Files:
- "site/**/*"
PublishToS3:
Identifier: aws/s3-publish@v1
Environment:
Name: codecatalyst-s3-publish-environment
Connections:
- Name: codecatalyst-account-connection
Role: codecatalyst-s3-publish-build-role
Inputs:
Sources:
- WorkflowSource
Artifacts:
- MyDocsSite
Configuration:
DestinationBucketName: amzn-s3-demo-bucket
SourcePath: /artifacts/PublishToS3/MyDocSite/site
TargetPath: my/docs/site
```
# Cómo añadir la acción Amazon S3 publish
Siga estas instrucciones para añadir la acción **Amazon S3 publish** a su flujo de trabajo.
------
#### [ Visual ]
**Cómo añadir la acción Amazon S3 publish con el editor visual**
1. [Abra la CodeCatalyst consola en https://codecatalyst.aws/.](https://codecatalyst.aws/)
1. Elija el proyecto.
1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.
1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo.
1. Elija **Edit (Edición de)**.
1. Elija **Visual**.
1. En la parte superior izquierda, seleccione **\$1 Acciones** para abrir el catálogo de acciones.
1. En la lista desplegable, selecciona **Amazon CodeCatalyst**.
1. Busque la acción **Amazon S3 publish** y realice una de las siguientes opciones:
+ Elija el signo más (**\$1**) para añadir la acción al diagrama de flujo de trabajo y abrir su panel de configuración.
O
+ Elija **Amazon S3 publish**. Aparecerá el cuadro de diálogo de detalles de la acción. En este cuadro de diálogo:
+ (Opcional) Seleccione **Ver código fuente** para [ver el código fuente de la acción](workflows-view-source.md#workflows-view-source.title).
+ Seleccione **Añadir al flujo de trabajo** para añadir la acción al diagrama de flujo de trabajo y abrir su panel de configuración.
1. En las pestañas **Entradas**, **Configuración** y **Salidas**, complete los campos según sus necesidades. Para obtener una descripción de cada uno de los campos, consulte la [Acción Amazon S3 publish en YAML](s3-pub-action-ref.md). Esta referencia proporciona información detallada sobre cada campo (y el valor de la propiedad de YAML correspondiente) tal como aparece en el editor visual y el de YAML.
1. (Opcional) Seleccione **Validar** para validar el código de YAML del flujo de trabajo antes de confirmarlo.
1. Seleccione **Confirmar**, introduzca un mensaje de confirmación y vuelva a seleccionar **Confirmar**.
------
#### [ YAML ]
**Cómo añadir la acción Amazon S3 publish con el editor de YAML**
1. Abre la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Elija el proyecto.
1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.
1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo.
1. Elija **Edit (Edición de)**.
1. Elija **YAML**.
1. En la parte superior izquierda, seleccione **\$1 Acciones** para abrir el catálogo de acciones.
1. En la lista desplegable, selecciona **Amazon CodeCatalyst**.
1. Busque la acción **Amazon S3 publish** y realice una de las siguientes opciones:
+ Elija el signo más (**\$1**) para añadir la acción al diagrama de flujo de trabajo y abrir su panel de configuración.
O
+ Elija **Amazon S3 publish**. Aparecerá el cuadro de diálogo de detalles de la acción. En este cuadro de diálogo:
+ (Opcional) Seleccione **Ver código fuente** para [ver el código fuente de la acción](workflows-view-source.md#workflows-view-source.title).
+ Seleccione **Añadir al flujo de trabajo** para añadir la acción al diagrama de flujo de trabajo y abrir su panel de configuración.
1. Modifique las propiedades del código de YAML en función de sus necesidades. Encontrará una explicación de todas las propiedades disponibles en la [Acción Amazon S3 publish en YAML](s3-pub-action-ref.md).
1. (Opcional) Seleccione **Validar** para validar el código de YAML del flujo de trabajo antes de confirmarlo.
1. Seleccione **Confirmar**, introduzca un mensaje de confirmación y vuelva a seleccionar **Confirmar**.
------
# 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](s3-pub-action.md).
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](workflow-reference.md).
**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\$1F**. 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\$1nn:
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 (\$1). 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](workflows-action-versions.md).
Predeterminado: `aws/s3-publish@v1`.
Interfaz de usuario correspondiente: diagrama de flujo de trabajo/S3Publish\$1nn/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](workflows-depends-on.md).
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](compute-sharing.md).
Interfaz de usuario correspondiente: *ninguna*
## Type
(*S3Publish*/Compute/**Type**)
(Obligatorio si se incluye [Compute](#s3.pub.computename))
El tipo de motor de computación. Puede utilizar uno de los siguientes valores:
+ **EC2**(editor visual) o (editor YAML`EC2`)
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](workflows-working-compute.md#compute.types).
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](workflows-working-compute.md#compute.on-demand).
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](workflows-working-compute.md#compute.provisioned-fleets).
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 YAML) o en horas y minutos (editor visual) que la acción puede ejecutarse antes de que CodeCatalyst finalice la acción. El mínimo es 5 minutos y el máximo se describe en [Cuotas para flujos de trabajo en CodeCatalyst](workflows-quotas.md). 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](workflows-working-artifacts-ex.md#workflows-working-artifacts-ex-ref-file).
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](workflows-sources.md).
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](workflows-working-artifacts-output.md) 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](workflows-working-artifacts.md).
Interfaz de usuario correspondiente: pestaña Configuración/**Artefactos (opcional)**
## Variables - input
(*S3Publish*/Inputs/**Variables**)
(Opcional)
Especifique una secuencia de name/value pares que defina las variables de entrada que desea 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 (\$1). 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](workflows-working-with-variables.md).
Interfaz de usuario correspondiente: pestaña Entradas/**Variables (opcional)**
## Environment
(*S3Publish*/**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](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) 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 [Cambio del rol de IAM de una acción](deploy-environments-switch-role.md).
Para obtener más información sobre los entornos, consulte [Implementación en Cuentas de AWS y VPCs](deploy-environments.md) y [Creación de un entorno](deploy-environments-creating-environment.md).
Interfaz de usuario correspondiente: pestaña Configuración/**Entorno**
## Name
(*S3Publish*/Environment/**Name**)
(Obligatorio si se incluye [Environment](#s3.pub.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 Cuenta de AWS conexión y la función de IAM predeterminada especificadas en el entorno de la consola. 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](deploy-environments-creating-environment.md).
+ 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 [Permitir el acceso a AWS los recursos con conexión Cuentas de AWS](ipa-connect-account.md). 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](deploy-environments-creating-environment.md).
Interfaz de usuario correspondiente: una de las siguientes, según la versión de la acción.
+ (Versiones más recientes) ¿tab/Environment/WhatLa configuración está lista? *my-environment* **/menú de tres puntos/ Cambiar rol**
+ **(Versiones anteriores) Pestaña de configuración/' '/ conexión de cuenta Environment/account/role AWS **
## Name
(*S3Publish*/Environment/Connections/**Name**)
(Obligatorio si se incluye [Connections](#s3.pub.environment.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) ¿La configuración está lista? tab/Environment/What *my-environment* **/menú de tres puntos/ Cambiar rol**
+ **(Versiones anteriores) Pestaña de configuración/' '/ conexión de cuenta Environment/account/role AWS **
## Role
(*S3Publish*/Environment/Connections/**Role**)
(Obligatorio si se incluye [Connections](#s3.pub.environment.connections))
Especifique el nombre de la función de IAM que la acción de **publicación de Amazon S3** utiliza para acceder a los archivos de Amazon S3 AWS y copiarlos. Asegúrese de haber [agregado el rol a su CodeCatalyst espacio](ipa-connect-account-addroles.md) 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](deploy-environments.md) 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 de seguridad.
------
#### [ JSON ]
****
```
{
"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:
**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](ipa-iam-roles.md#ipa-iam-roles-service-create). 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) ¿tab/Environment/WhatLa configuración está lista? *my-environment* **/menú de tres puntos/ Cambiar rol**
+ **(Versiones anteriores) Pestaña de configuración/' '/ Rol Environment/account/role**
## 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](workflows-sources-reference-files.md) y [Referencia a archivos en un artefacto](workflows-working-artifacts-refer-files.md).
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)**