As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Ao criar uma condição, você pode adicionar a CodeBuild regra. Esta seção fornece uma referência para os parâmetros da regra. Para ter mais informações sobre regras e condições, consulte Como funcionam as condições do estágio?.
Você pode usar a CodeBuild regra para criar uma condição em que a execução bem-sucedida do seu projeto de compilação atenda aos critérios da regra, como a execução bem-sucedida da compilação para uma condição BeforeEntry.
nota
Para condições BeforeEntry configuradas com o resultado Skip, somente as seguintes regras estão disponíveis: e. LambdaInvoke VariableCheck
Tópicos
Permissões de política de perfil de serviço
Para obter permissões para essa regra, adicione o seguinte à sua declaração de política CodePipeline de função de serviço. Reduza o escopo das permissões até o nível do recurso.
{ "Effect": "Allow", "Action": [ "codebuild:BatchGetBuilds", "codebuild:StartBuild" ], "Resource": "resource_ARN" },
Tipo de regra
-
Categoria:
Rule -
Proprietário:
AWS -
Fornecedor:
CodeBuild -
Versão:
1
Parâmetros de configuração
- ProjectName
-
Obrigatório: sim
ProjectNameé o nome do projeto de construção em CodeBuild. - PrimarySource
-
Obrigatório: condicional
O valor do
PrimarySourceparâmetro deve ser o nome de um dos artefatos de entrada para a ação. CodeBuild procura o arquivo buildspec e executa os comandos buildspec no diretório que contém a versão descompactada desse artefato.Esse parâmetro será necessário se vários artefatos de entrada forem especificados para uma ação do CodeBuild . Quando houver apenas um artefato de origem para a ação, o artefato
PrimarySourceassumirá esse artefato como padrão. - BatchEnabled
-
Obrigatório: não
O valor booleano do parâmetro
BatchEnabledpermite que a ação execute várias compilações na mesma execução de compilação.Quando esta opção está habilitada, a opção
CombineArtifactsestá disponível.Para exemplos de funis com compilações em lote ativadas, consulte CodePipeline integração com CodeBuild e compilações em lote.
- CombineArtifacts
-
Obrigatório: não
O valor booleano do parâmetro
CombineArtifactscombina todos os artefatos de uma compilação em lote em um único arquivo de artefato para a ação de compilação.Para usar esta opção, o parâmetro
BatchEnableddeve estar ativado. - EnvironmentVariables
-
Obrigatório: não
O valor desse parâmetro é usado para definir variáveis de ambiente para a ação do CodeBuild no pipeline. O valor do parâmetro
EnvironmentVariablesassume a forma de uma matriz JSON de objetos de variáveis de ambiente. Consulte o parâmetro de exemplo em Declaração de ação (exemplo do CodeBuild).Cada objeto tem três partes, todas são strings:
-
name: o nome ou a chave da variável de ambiente. -
value: o valor da variável de ambiente. Ao usar oSECRETS_MANAGERtipoPARAMETER_STOREou, esse valor deve ser o nome de um parâmetro que você já armazenou no AWS Systems Manager Parameter Store ou um segredo que você já armazenou no AWS Secrets Manager, respectivamente.nota
Nós desencorajamos fortemente o uso de variáveis de ambiente para armazenar valores confidenciais, especialmente AWS credenciais. Quando você usa o CodeBuild console ou a AWS CLI, as variáveis de ambiente são exibidas em texto sem formatação. Para valores confidenciais, recomendamos usar o tipo
SECRETS_MANAGER. -
type: (opcional) o tipo da variável de ambiente. Os valores válidos sãoPARAMETER_STORE,SECRETS_MANAGERouPLAINTEXT. Se não especificado, assumirá como padrãoPLAINTEXT.
nota
Ao inserir o
namevalue, etypepara sua configuração de variáveis de ambiente, especialmente se a variável de ambiente contiver a sintaxe da variável de CodePipeline saída, não exceda o limite de 1000 caracteres para o campo de valor da configuração. Um erro de validação será retornado quando esse limite for excedido.Para obter mais informações, consulte EnvironmentVariablea Referência AWS CodeBuild da API. Para obter um exemplo de CodeBuild ação com uma variável de ambiente que é resolvida com o nome da GitHub ramificação, consulteExemplo: use uma BranchName variável com variáveis de CodeBuild ambiente.
-
Exemplo de configuração de regra
name: codebuild-rule
ruleTypeId:
category: Rule
owner: AWS
provider: CodeBuild
version: '1'
configuration:
ProjectName: my-buildproject
EnvironmentVariables: '[{"name":"VAR1","value":"variable","type":"PLAINTEXT"}]'
inputArtifacts:
- name: SourceArtifact
region: us-east-1Consulte também
Os recursos relacionados a seguir podem ajudar você a trabalhar com essa regra.
-
Para obter mais informações sobre regras e condições, consulte Condição e RuleExecutionno Guia da CodePipeline API. RuleTypeId
