S3Publish Identifier DependsOn Compute Type Fleet Timeout Inputs Sources Artifacts - input Variables - input Environment Name Connections Name Role Configuration SourcePath DestinationBucketName TargetPath

Ação de “publicação do Amazon S3” YAML

A seguir está a YAML definição da ação de publicação do Amazon S3. Para saber como usar essa ação, consultePublicação de arquivos no Amazon S3 com um fluxo de trabalho.

Essa definição de ação existe como uma seção dentro de um arquivo de definição de fluxo de trabalho mais amplo. Para obter mais informações sobre esse arquivo, consulte YAMLDefinição de fluxo de trabalho.

nota

A maioria das YAML propriedades a seguir tem elementos de interface de usuário correspondentes no editor visual. Para pesquisar um elemento de interface do usuário, use Ctrl+F. O elemento será listado com sua YAML propriedade associada.


# The workflow definition starts here.
# See Propriedades de nível 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

(Obrigatório)

Especifique o nome da ação. Todos os nomes das ações devem ser exclusivos no fluxo de trabalho. Os nomes das ações são limitados a caracteres alfanuméricos (a-z, A-Z, 0-9), hífens (-) e sublinhados (_). Não são permitidos espaços. Você não pode usar aspas para ativar caracteres especiais e espaços nos nomes das ações.

Padrão: S3Publish_nn.

UI correspondente: guia de configuração/nome da ação

Identifier

(Publicação S3/Identifier)

(Obrigatório)

Identifica a ação. Não altere essa propriedade, a menos que você queira alterar a versão. Para obter mais informações, consulte Especificando a versão da ação a ser usada.

Padrão: aws/s3-publish@v1.

UI correspondente: diagrama de fluxo de trabalho/ S3Publish _nn/ aws/s3-publish @v1 label

DependsOn

(Publicação S3/DependsOn)

(Optional)

Especifique uma ação, grupo de ação ou porta que deve ser executada com êxito para que essa ação seja executada.

Para obter mais informações sobre a funcionalidade “depende de”, consulte. Ações de sequenciamento

UI correspondente: guia Entradas/Depende de - opcional

Compute

(Publicação S3/Compute)

(Optional)

O mecanismo de computação usado para executar suas ações de fluxo de trabalho. Você pode especificar a computação no nível do fluxo de trabalho ou no nível da ação, mas não em ambos. Quando especificada no nível do fluxo de trabalho, a configuração computacional se aplica a todas as ações definidas no fluxo de trabalho. No nível do fluxo de trabalho, você também pode executar várias ações na mesma instância. Para obter mais informações, consulte Compartilhamento de computação entre ações.

UI correspondente: nenhuma

Type

(Publicação S3/Compute/Type)

(Obrigatório se Compute estiver incluído)

O tipo de mecanismo de computação. Você pode usar um dos seguintes valores:

EC2(editor visual) ou EC2 (YAMLeditor)

Otimizado para flexibilidade durante as corridas de ação.
Lambda (editor visual) ou Lambda (YAMLeditor)

Velocidades otimizadas de inicialização da ação.

Para obter informações sobre tipos de dados, consulte Tipos de computação.

UI correspondente: guia de configuração/tipo de computação

Fleet

(Publicação S3/Compute/Fleet)

(Optional)

Especifique a máquina ou frota que executará seu fluxo de trabalho ou ações de fluxo de trabalho. Com frotas sob demanda, quando uma ação é iniciada, o fluxo de trabalho provisiona os recursos necessários e as máquinas são destruídas quando a ação termina. Exemplos de frotas sob demanda:Linux.x86-64.Large,. Linux.x86-64.XLarge Para obter mais informações sobre frotas sob demanda, consulte. Propriedades de frota sob demanda

Com frotas provisionadas, você configura um conjunto de máquinas dedicadas para executar suas ações de fluxo de trabalho. Essas máquinas permanecem ociosas, prontas para processar ações imediatamente. Para obter mais informações sobre frotas provisionadas, consulte. Propriedades da frota provisionada

Se Fleet for omitido, o padrão será. Linux.x86-64.Large

UI correspondente: guia de configuração/frota de computação

Timeout

(Publicação S3/Timeout)

(Obrigatório)

Especifique a quantidade de tempo em minutos (YAMLeditor) ou horas e minutos (editor visual) que a ação pode ser executada antes de CodeCatalyst finalizar a ação. O mínimo é de 5 minutos e o máximo está descrito emCotas para fluxos de trabalho em CodeCatalyst. O tempo limite padrão é igual ao tempo limite máximo.

UI correspondente: guia de configuração/tempo limite - opcional

Inputs

(Publicação S3/Inputs)

(Optional)

A Inputs seção define os dados S3Publish necessários durante a execução de um fluxo de trabalho.

nota

São permitidas no máximo quatro entradas (uma fonte e três artefatos) para cada ação de AWS CDK implantação. As variáveis não contam para esse total.

Se você precisar se referir a arquivos que residem em entradas diferentes (digamos, uma fonte e um artefato), a entrada de origem é a entrada primária e o artefato é a entrada secundária. As referências a arquivos em entradas secundárias usam um prefixo especial para diferenciá-las das primárias. Para obter detalhes, consulte Exemplo: referenciando arquivos em vários artefatos.

UI correspondente: guia Entradas

Sources

(Publicação S3/Inputs/Sources)

(Obrigatório se os arquivos que você deseja publicar no Amazon S3 estiverem armazenados em um repositório de origem)

Se os arquivos que você deseja publicar no Amazon S3 estiverem armazenados em um repositório de origem, especifique o rótulo desse repositório de origem. Atualmente, o único rótulo compatível éWorkflowSource.

Se os arquivos que você deseja publicar no Amazon S3 não estiverem contidos em um repositório de origem, eles devem residir em um artefato gerado por outra ação.

Para obter mais informações sobre fontes, consulte Conectando repositórios de origem aos fluxos de trabalho.

UI correspondente: guia Entradas/Fontes - opcional

Artifacts - input

(Publicação S3/Inputs/Artifacts)

(Obrigatório se os arquivos que você deseja publicar no Amazon S3 estiverem armazenados em um artefato de saída de uma ação anterior)

Se os arquivos que você deseja publicar no Amazon S3 estiverem contidos em um artefato gerado por uma ação anterior, especifique esse artefato aqui. Se seus arquivos não estiverem contidos em um artefato, eles devem residir no seu repositório de origem.

Para obter mais informações sobre artefatos, incluindo exemplos, consulteCompartilhamento de artefatos e arquivos entre ações.

UI correspondente: guia de configuração/artefatos - opcional

Variables - input

(Publicação S3/Inputs/Variables)

(Optional)

Especifique uma sequência de pares de nome/valor que definam as variáveis de entrada que você deseja disponibilizar para a ação. Os nomes das variáveis são limitados a caracteres alfanuméricos (a-z, A-Z, 0-9), hífens (-) e sublinhados (_). Não são permitidos espaços. Você não pode usar aspas para habilitar caracteres especiais e espaços em nomes de variáveis.

Para obter mais informações sobre variáveis, incluindo exemplos, consulteUsando variáveis em fluxos de trabalho.

UI correspondente: guia de entradas/variáveis - opcional

Environment

(Publicação S3/Environment)

(Obrigatório)

Especifique o CodeCatalyst ambiente a ser usado com a ação. A ação se conecta Conta da AWS à Amazon opcional VPC especificada no ambiente escolhido. A ação usa a IAM função padrão especificada no ambiente para se conectar ao Conta da AWS e usa a IAM função especificada na VPCconexão da Amazon para se conectar à AmazonVPC.

nota

Se a IAM função padrão não tiver as permissões exigidas pela ação, você poderá configurar a ação para usar uma função diferente. Para obter mais informações, consulte Mudando o IAM papel de uma ação.

Para obter mais informações sobre ambientes, consulte Implantação em e Contas da AWS VPCs Criar um ambiente e.

UI correspondente: guia de configuração/ambiente

Name

(Publicação S3/Environment/Name)

(Obrigatório se Environment estiver incluído)

Especifique o nome de um ambiente existente que você deseja associar à ação.

UI correspondente: guia de configuração/ambiente

Connections

(Publicação S3/Environment/Connections)

(Opcional nas versões mais recentes da ação; obrigatório nas versões mais antigas)

Especifique a conexão da conta a ser associada à ação. Você pode especificar no máximo uma conexão de conta emEnvironment.

Se você não especificar uma conexão de conta:

A ação usa a Conta da AWS conexão e a IAM função padrão especificadas no ambiente no CodeCatalyst console. Para obter informações sobre como adicionar uma conexão de conta e uma IAM função padrão ao ambiente, consulteCriar um ambiente.
A IAM função padrão deve incluir as políticas e permissões exigidas pela ação. Para determinar quais são essas políticas e permissões, consulte a descrição da propriedade Role na documentação de YAML definição da ação.

Para obter mais informações sobre conexões de conta, consultePermitindo acesso a AWS recursos com conexão Contas da AWS. Para obter informações sobre como adicionar uma conexão de conta a um ambiente, consulteCriar um ambiente.

UI correspondente: uma das seguintes, dependendo da versão da ação:

(Versões mais recentes) Guia de configuração/Ambiente/O que está incluído my-environment? /menu de três pontos/ Mudar função
(Versões mais antigas) Guia de configuração/'Ambiente/Conta/Função'/ conexão AWS de conta

Name

(Publicação S3/Environment/Connections/Name)

(Obrigatório se Connections estiver incluído)

Especifique o nome da conexão da conta.

UI correspondente: uma das seguintes, dependendo da versão da ação:

(Versões mais recentes) Guia de configuração/Ambiente/O que está incluído my-environment? /menu de três pontos/ Mudar função
(Versões mais antigas) Guia de configuração/'Ambiente/Conta/Função'/ conexão AWS de conta

Role

(Publicação S3/Environment/Connections/Role)

(Obrigatório se Connections estiver incluído)

Especifique o nome da IAM função que a ação de publicação do Amazon S3 usa para acessar AWS e copiar arquivos para o Amazon S3. Certifique-se de ter adicionado a função ao seu CodeCatalyst espaço e de que a função inclua as seguintes políticas.

Se você não especificar uma IAM função, a ação usará a IAM função padrão listada no ambiente no CodeCatalyst console. Se você usar a função padrão no ambiente, verifique se ela tem as seguintes políticas.

A seguinte política de permissões:

Atenção

Limite as permissões às mostradas na política a seguir. Usar uma função com permissões mais amplas pode representar um risco de segurança.


{
    "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/*"
            ]
        }
    ]
}

A seguinte política de confiança personalizada:


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

nota

Você pode usar a CodeCatalystWorkflowDevelopmentRole-spaceName função com essa ação, se quiser. Para obter mais informações sobre essa função, consulte Criando a CodeCatalystWorkflowDevelopmentRole-spaceNamefunção para sua conta e espaço. Entenda que a CodeCatalystWorkflowDevelopmentRole-spaceName função tem permissões de acesso completas, o que pode representar um risco de segurança. Recomendamos que você use essa função somente em tutoriais e cenários em que a segurança seja menos preocupante.

UI correspondente: uma das seguintes, dependendo da versão da ação:

(Versões mais recentes) Guia de configuração/Ambiente/O que está incluído my-environment? /menu de três pontos/ Mudar função
(Versões mais antigas) Guia de configuração/'Ambiente/Conta/Função'/ Função

Configuration

(Publicação S3/Configuration)

(Obrigatório)

Uma seção na qual você pode definir as propriedades de configuração da ação.

UI correspondente: guia Configuração

SourcePath

(Publicação S3/Configuration/SourcePath)

(Obrigatório)

Especifique o nome e o caminho de um diretório ou arquivo que você deseja publicar no Amazon S3. O diretório ou arquivo pode residir em um repositório de origem ou em um artefato de uma ação anterior e é relativo ao repositório de origem ou à raiz do artefato.

Exemplos:

A especificação ./myFolder/ copia o conteúdo do /myFolder para o Amazon S3 e preserva a estrutura de diretórios subjacente.

Especificando ./myFolder/myfile.txt cópias somente myfile.txt para o Amazon S3. (A estrutura de diretórios foi removida.)

Você não pode usar curingas.

nota

Talvez seja necessário adicionar um prefixo ao diretório ou ao caminho do arquivo para indicar em qual artefato ou fonte encontrá-lo. Para ter mais informações, consulte Fazendo referência aos arquivos do repositório de origem e Fazendo referência a arquivos em um artefato.

UI correspondente: guia de configuração/caminho de origem

DestinationBucketName

(Publicação S3/Configuration/DestinationBucketName)

(Obrigatório)

Especifique o nome do bucket do Amazon S3 em que você deseja publicar os arquivos.

UI correspondente: guia de configuração/bucket de destino - opcional

TargetPath

(Publicação S3/Configuration/TargetPath)

(Optional)

Especifique o nome e o caminho do diretório no Amazon S3 onde você deseja publicar seus arquivos. Se o diretório não existir, ele será criado. O caminho do diretório não deve incluir o nome do bucket.

Exemplos:

myS3Folder

./myS3Folder/myS3Subfolder

UI correspondente: guia de configuração/diretório de destino - opcional

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Adicionando a ação “Publicar no Amazon S3”

Implantação em e Contas da AWS VPCs