{"meta":{"title":"Usando blocos de construção pré-gravados no seu fluxo de trabalho","intro":"Você pode usar e personalizar ações escritas previamente para alimentar o fluxo de trabalho.","product":"GitHub Actions","breadcrumbs":[{"href":"/pt/actions","title":"GitHub Actions"},{"href":"/pt/actions/how-tos","title":"Instruções"},{"href":"/pt/actions/how-tos/write-workflows","title":"Escrever fluxos de trabalho"},{"href":"/pt/actions/how-tos/write-workflows/choose-what-workflows-do","title":"Escolha o que os fluxos de trabalho fazem"},{"href":"/pt/actions/how-tos/write-workflows/choose-what-workflows-do/find-and-customize-actions","title":"Procurar e personalizar ações"}],"documentType":"article"},"body":"# Usando blocos de construção pré-gravados no seu fluxo de trabalho\n\nVocê pode usar e personalizar ações escritas previamente para alimentar o fluxo de trabalho.\n\n## Navegação nas ações do Marketplace no editor de fluxo de trabalho\n\nVocê pode pesquisar e navegar por ações diretamente no editor do fluxo de trabalho do seu repositório. Na barra lateral, você pode pesquisar uma ação específica, visualizar ações em destaque e pesquisar categorias em destaque. Você também pode exibir o número de estrelas que uma ação recebeu da GitHub comunidade.\n\n1. No seu repositório, pesquise o arquivo do fluxo de trabalho que você deseja editar.\n2. No canto superior direito da visualização do arquivo, para abrir o editor de fluxo de trabalho, clique em .\n\n\n\n1. À direita do editor, use a barra lateral GitHub Marketplace para navegar pelas ações. As ações com o selo indicam que GitHub verificou o criador da ação como uma organização parceira.\n\n\n\n## Adicionar uma ação ao seu fluxo de trabalho\n\nVocê pode adicionar uma ação ao seu fluxo de trabalho fazendo referência à ação no arquivo do seu fluxo de trabalho. As ações que você usa no seu fluxo de trabalho podem ser definidas em:\n\n* O mesmo repositório que o arquivo de fluxo de trabalho\n* Qualquer repositório público\n* Uma imagem de contêiner do Docker publicada no Docker Hub\n\nVocê pode exibir as ações referenciadas em seus GitHub Actions fluxos de trabalho como dependências no grafo de dependência do repositório que contém seus fluxos de trabalho. Para obter mais informações, confira \"[Grafo de dependência](/pt/code-security/concepts/supply-chain-security/dependency-graph)\".\n\n> \\[!NOTE]\n> Para aprimorar a segurança, o GitHub Actions não dá suporte a redirecionamentos de ações nem a fluxos de trabalho reutilizáveis. Isso significa que quando o proprietário, o nome do repositório de uma ação ou o nome da ação é alterado, todos os fluxos de trabalho que usarem essa ação com o nome anterior falharão.\n\n### Adicionando uma ação a partir de GitHub Marketplace\n\nUma página de listagem de ação inclui a versão da ação e a sintaxe do fluxo de trabalho necessária para usar a ação. Para manter seu fluxo de trabalho estável mesmo quando atualizações são feitas em uma ação, você pode fazer referência à versão da ação a ser usada especificando a tag do Git ou do Docker no arquivo de fluxo de trabalho.\n\n1. Navegue para a ação que você deseja usar no seu fluxo de trabalho.\n2. Clique para exibir a listagem completa do marketplace relacionada à ação.\n3. Em \"Instalação\", clique para copiar a sintaxe do fluxo de trabalho.\n\n\n\n1. Cole a sintaxe como uma nova etapa no seu fluxo de trabalho. Para saber mais, confira [Sintaxe de fluxo de trabalho para o GitHub Actions](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idsteps).\n2. Se a ação exigir que você forneça entradas, defina-as no seu fluxo de trabalho. Para obter informações sobre as entradas que uma ação pode exigir, confira [Usando blocos de construção pré-gravados no seu fluxo de trabalho](/pt/actions/how-tos/write-workflows/choose-what-workflows-do/find-and-customize-actions#using-inputs-and-outputs-with-an-action).\n\nVocê também pode habilitar Dependabot version updates para as ações que adiciona ao fluxo de trabalho. Para saber mais, confira [Manter as suas ações atualizadas com o Dependabot](/pt/code-security/how-tos/secure-your-supply-chain/secure-your-dependencies/auto-update-actions).\n\n### Adicionando uma ação do mesmo repositório\n\nSe uma ação for definida no mesmo repositório em que o arquivo de fluxo de trabalho usa a ação, você poderá referenciar a ação com a `$/path/to/dir` referência de auto repositório ou com a `{owner}/{repo}@{ref}` sintaxe ou `./path/to/dir` no arquivo de fluxo de trabalho. A `$/` sintaxe não está disponível em GitHub Enterprise Server.\n\nExemplo de estrutura de arquivo de repositório:\n\n```shell\n|-- hello-world (repository)\n| |__ .github\n| └── workflows\n| └── my-first-workflow.yml\n| └── actions\n| |__ hello-world-action\n| └── action.yml\n```\n\nRecomendamos referenciar a ação com a `$/path/to/dir` referência de auto repositório. Isso é resolvido para o mesmo repositório na confirmação em execução, portanto, você não precisa fazer check-out do repositório primeiro. Para obter mais informações sobre como `$/` se compara `{owner}/{repo}@{ref}` a e `./`, consulte [Sintaxe de fluxo de trabalho para o GitHub Actions](/pt/actions/reference/workflows-and-actions/workflow-syntax#example-using-an-action-in-the-same-repository-as-the-workflow-at-the-running-commit-recommended).\n\nExemplo de arquivo de fluxo de trabalho usando `$/`:\n\n```yaml\njobs:\n my_first_job:\n runs-on: ubuntu-latest\n steps:\n # This step references an action in the same repository at the\n # running commit. No repository checkout is required.\n - name: Use hello-world-action\n uses: $/.github/actions/hello-world-action\n```\n\nVocê também pode referenciar a ação com a sintaxe relativa `./path/to/dir` , mas ela é mais propensa a erros. O caminho é relativo (`./`) ao diretório de trabalho padrão (`github.workspace`, portanto, `$GITHUB_WORKSPACE`requer uma etapa de check-out e, se a ação verificar o repositório para um local diferente do fluxo de trabalho, o caminho relativo deverá ser atualizado.\n\nExemplo de arquivo de fluxo de trabalho usando `./`:\n\n```yaml\njobs:\n my_first_job:\n runs-on: ubuntu-latest\n steps:\n # This step checks out a copy of your repository.\n - name: My first step - check out repository\n uses: actions/checkout@v6\n # This step references the directory that contains the action.\n - name: Use local hello-world-action\n uses: ./.github/actions/hello-world-action\n```\n\nO arquivo `action.yml` é usado para fornecer metadados para a ação. Saiba mais sobre o conteúdo deste arquivo em [Referência de sintaxe de metadados](/pt/actions/reference/workflows-and-actions/metadata-syntax).\n\n### Adicionando uma ação de um repositório diferente\n\nSe uma ação for definida em um repositório diferente do arquivo de fluxo de trabalho, você poderá referenciar a ação com a sintaxe `{owner}/{repo}@{ref}` no arquivo de fluxo de trabalho.\n\nA ação deve ser armazenada em um repositório.\n\n```yaml\njobs:\n my_first_job:\n steps:\n - name: My first step\n uses: actions/setup-node@v7\n```\n\n### Referenciando um contêiner no Docker Hub\n\nSe uma ação for definida em uma imagem de contêiner do Docker publicada no Docker Hub, você deverá referenciar a ação com a sintaxe `docker://{image}:{tag}` no arquivo de fluxo de trabalho. Para proteger seu código e dados, é altamente recomendável verificar a integridade da imagem de contêiner do Docker de Docker Hub antes de usá-la em seu fluxo de trabalho.\n\n```yaml\njobs:\n my_first_job:\n steps:\n - name: My first step\n uses: docker://alpine:3.8\n```\n\nPara ver alguns exemplos de ações do Docker, confira o [fluxo de trabalho Docker-image.yml](https://github.com/actions/starter-workflows/blob/main/ci/docker-image.yml) e o [Criando uma ação de contêiner do Docker](/pt/actions/tutorials/use-containerized-services/create-a-docker-container-action).\n\n### Fortalecimento de segurança no uso de ações em seus fluxos de trabalho\n\nGitHub fornece recursos de segurança que você pode usar para aumentar a segurança de seus fluxos de trabalho. Você pode usar os recursos internos do GitHub para garantir que você seja notificado sobre vulnerabilidades nas ações que utiliza ou para automatizar o processo de manter atualizadas as ações em seus fluxos de trabalho. Para saber mais, confira [Referência de uso seguro](/pt/actions/reference/security/secure-use).\n\n## Usar o gerenciamento de versões para suas ações personalizadas\n\nOs criadores de uma ação da comunidade têm a opção de usar tags, branches ou valores do SHA para gerenciar as versões da ação. Semelhante a qualquer dependência, você deve indicar a versão da ação que gostaria de usar, com base no seu conforto em aceitar automaticamente as atualizações da ação.\n\nVocê irá designar a versão da ação no seu arquivo de fluxo de trabalho. Verifique a documentação da ação para obter informações sobre suas abordagens de gerenciamento de release e para saber qual tag, branch ou valor de SHA usar.\n\n> \\[!NOTE]\n> Recomendamos que você use um valor SHA ao usar ações de terceiros. No entanto, é importante observar que Dependabot só criará Dependabot alerts para GitHub Actions vulneráveis que usam versionamento semântico. Para saber mais, confira [Referência de uso seguro](/pt/actions/reference/security/secure-use#using-third-party-actions) e [Alertas do Dependabot](/pt/code-security/concepts/supply-chain-security/dependabot-alerts).\n\n### Usar etiquetas\n\nAs tags são úteis para permitir que você decida quando alternar entre versões maiores e menores, mas estas são mais efêmeras e podem ser movidas ou excluídas pelo mantenedor. Este exemplo demonstra como direcionar uma ação que foi marcada como `v1.0.1`:\n\n```yaml\nsteps:\n - uses: actions/javascript-action@v1.0.1\n```\n\n### Usar SHAs\n\nSe você precisar de uma versão mais confiável, você deverá usar o valor de SHA associado à versão da ação. Os SHAs são imutáveis e, portanto, mais confiáveis que tags ou branches. No entanto, esta abordagem significa que você não receberá automaticamente atualizações de uma ação, incluindo correções de bugs e atualizações de segurança importantes. Você deve usar o valor SHA completo de um commit e não um valor abreviado.\nAo selecionar um SHA, verifique se ele está no repositório da ação e não em uma bifurcação do repositório. Este exemplo tem como destino o SHA de uma ação:\n\n```yaml\nsteps:\n - uses: actions/javascript-action@a824008085750b8e136effc585c3cd6082bd575f\n```\n\n### Usar branches\n\nEspecificar um branch de destino para a ação significa que ele sempre irá executar a versão atualmente nesse branch. Essa abordagem pode criar problemas se uma atualização do branch incluir mudanças significativas. Este exemplo é direcionado a um branch chamado `@main`:\n\n```yaml\nsteps:\n - uses: actions/javascript-action@main\n```\n\nPara saber mais, confira [Como gerenciar ações personalizadas](/pt/actions/how-tos/create-and-publish-actions/manage-custom-actions#using-release-management-for-actions).\n\n## Usar entradas e saídas com uma ação\n\nUma ação geralmente aceita ou exige entradas e gera saídas que você pode usar. Por exemplo, uma ação pode exigir que você especifique um caminho para um arquivo, o nome de uma etiqueta ou outros dados que usará como parte do processamento da ação.\n\nPara ver as entradas e as saídas de uma ação, verifique o `action.yml` no diretório raiz do repositório.\n\nNeste exemplo de `action.yml`, a palavra-chave `inputs` define uma entrada obrigatória chamada `file-path` e inclui um valor padrão que será usado se nenhum for especificado. A palavra-chave `outputs` define uma saída chamada `results-file`, que informa o local em que os resultados se encontram.\n\n```yaml\nname: \"Example\"\ndescription: \"Receives file and generates output\"\ninputs:\n file-path: # id of input\n description: \"Path to test script\"\n required: true\n default: \"test-file.js\"\noutputs:\n results-file: # id of output\n description: \"Path to results file\"\n```"}