Actions personalizadas e Marketplace
Explore o Marketplace do GitHub Actions em busca de actions prontas e aprenda a criar suas próprias actions personalizadas.
Actions personalizadas e Marketplace é uma aula grátis de Git & GitHub Professional Workflow no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Git & GitHub Professional Workflow, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Git & GitHub Professional Workflow inclui 4 aulas no total.
Descubra o Marketplace do GitHub Actions
Boas-vindas ao Marketplace do GitHub Actions! Ele é um centro dinâmico onde você pode encontrar milhares de ações pré-criadas por GitHub, colaboradores de código aberto e parceiros comerciais.
Essas ações podem ser facilmente integradas aos seus fluxos de trabalho, economizando tempo e esforço ao reutilizar soluções existentes para tarefas comuns.
Encontrando a ação certa
Navegar pelo Marketplace é simples. Você pode pesquisar ações por palavras-chave, filtrar por categoria, como "CI/CD" ou "Publicação", e ordenar por popularidade.
- Procure ações com muitas avaliações em estrelas e manutenção ativa.
- Consulte a documentação da ação para obter instruções de uso, entradas e saídas.
- Verifique quantas vezes uma ação foi usada em repositórios públicos como prova de aceitação pela comunidade.
Integrando uma ação pronta
Usar uma ação do Marketplace é simples. Você faz referência a ela usando a palavra-chave uses no YAML do seu fluxo de trabalho, seguida por owner/repo@version da ação.
Um exemplo comum é actions/checkout, que faz o checkout do código do seu repositório para que o fluxo de trabalho possa acessá-lo.
name: Marketplace Demo
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4
- name: Say hello
run: echo "Hello from workflow!"Entradas e saídas de ações
Muitas ações aceitam entradas para personalizar seu comportamento, especificadas usando a palavra-chave with. Elas também podem produzir saídas que outras etapas do seu fluxo de trabalho podem usar.
Por exemplo, a ação actions/setup-node pode receber a entrada node-version.
name: Node Setup Demo
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Node.js 18.x
uses: actions/setup-node@v3
with:
node-version: '18.x'
- name: Install dependencies
run: npm installQuando criar sua própria ação
Embora o Marketplace ofereça muitas opções, às vezes você precisa de algo específico. É nesse momento que as ações personalizadas são úteis!
Você pode criar uma ação personalizada para:
- Automatizar ferramentas internas da empresa.
- Integrar uma API exclusiva que não é atendida pelas ações existentes.
- Realizar tarefas altamente especializadas específicas do processo de compilação do seu projeto.
Tipos de ações personalizadas
Há dois tipos principais de ações personalizadas que você pode criar:
- Ações JavaScript: são executadas diretamente na máquina do executor usando Node.js. Em geral, são mais rápidas de desenvolver e mais fáceis de compartilhar.
- Ações de contêiner Docker: são executadas dentro de um contêiner Docker. Elas são ótimas para encapsular ambientes e dependências, garantindo uma execução consistente em diferentes executores.
Para simplificar, vamos nos concentrar nas ações JavaScript.
O arquivo `action.yml`
Toda ação personalizada precisa de um arquivo action.yml. Esse arquivo define os metadados da ação, incluindo seu nome, descrição, entradas aceitas, saídas produzidas e a forma como ela é executada.
Ele funciona como o manifesto da sua ação, informando ao GitHub Actions tudo o que é necessário saber.
name: 'My Custom Greeting Action'
description: 'Greets a person with a custom message.'
inputs:
who-to-greet:
description: 'Who to greet'
required: true
default: 'World'
outputs:
time:
description: 'The time we greeted you'
runs:
using: 'node16'
main: 'index.js'Criando uma ação JavaScript simples
Vamos criar uma ação JavaScript muito básica. Você precisará de um arquivo index.js, especificado em action.yml, e normalmente de um package.json para as dependências.
O pacote @actions/core é essencial para interagir com o fluxo de trabalho, por exemplo, obtendo entradas e definindo saídas.
const core = require('@actions/core');
async function run() {
try {
const nameToGreet = core.getInput('who-to-greet');
console.log(`Hello ${nameToGreet}!`);
const time = (new Date()).toTimeString();
core.setOutput("time", time);
} catch (error) {
core.setFailed(error.message);
}
}
run();Integrando sua ação personalizada
Para usar sua ação personalizada, coloque seus arquivos, como action.yml, index.js etc., em um subdiretório do seu repositório. Em seguida, faça referência a ela no seu fluxo de trabalho usando um caminho relativo com uses: ./path/to/your/action.
Isso permite testar sua ação localmente antes de possivelmente publicá-la no Marketplace.
name: Use Custom Action Demo
on: [push]
jobs:
greet:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run my custom action
uses: ./my-custom-action # Path to action directory
with:
who-to-greet: 'CoddyKit User'
- name: Get the output time
run: echo "The greeting time was ${{ steps.run-my-custom-action.outputs.time }}"Componentes de uma ação personalizada
Você aprendeu sobre os principais elementos envolvidos na criação e no uso de ações personalizadas do GitHub. Vamos verificar seu entendimento!
Recapitulação: Marketplace e ações personalizadas
Parabéns! Você explorou o potencial tanto do Marketplace do GitHub Actions quanto das ações personalizadas.
- O Marketplace oferece uma grande variedade de ações prontas para uso, simplificando seus fluxos de trabalho.
- As ações personalizadas permitem ampliar o GitHub Actions para atender às necessidades específicas de projetos ou organizações.
Ao combinar esses recursos, você pode criar pipelines de automação extremamente poderosos e personalizados!
Perguntas Frequentes
A aula “Actions personalizadas e Marketplace” é grátis?
Sim — o texto completo de “Actions personalizadas e Marketplace” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Git & GitHub Professional Workflow, atualize para CoddyKit PRO. O curso de Git & GitHub Professional Workflow inclui 4 aulas no total.
O que vou aprender em “Actions personalizadas e Marketplace”?
Explore o Marketplace do GitHub Actions em busca de actions prontas e aprenda a criar suas próprias actions personalizadas. Você pratica Git & GitHub Professional Workflow com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Git & GitHub Professional Workflow?
Nenhuma experiência prévia é necessária. Git & GitHub Professional Workflow no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “Actions personalizadas e Marketplace”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Git & GitHub Professional Workflow?
Sim. Cada aula de Git & GitHub Professional Workflow inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Introdução ao GitHub Actions
- Criando fluxos de trabalho de CI/CD
- Actions personalizadas e Marketplace
- Segredos e Variáveis de Ambiente nas Actions