Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Publicar ações no GitHub Marketplace

Você pode publicar ações em GitHub Marketplace e compartilhar as ações que você criou com a comunidade GitHub.

GitHub Actions está disponível com GitHub Free, GitHub Pro, GitHub Free para organizações, GitHub Team, GitHub Enterprise Cloud e GitHub One. GitHub Actions não está disponível para repositórios privados pertencentes a contas usando os planos de legado por repositório. Para obter mais informações, consulte "produtos de GitHub

Neste artigo

Você deve aceitar os termos de serviço para publicar ações em GitHub Marketplace.

Sobre a publicação de ações

Antes de poder publicar uma ação, você deverá criar uma ação no seu repositório. Para obter mais informações, consulte "Criar ações".

Ao planejar publicar a sua ação em GitHub Marketplace, você deverá garantir que o repositório inclui apenas o arquivo de metadados, o código e os arquivos necessários para a ação. Criar um repositório único para a ação permite que você identifique, lance e empacote o código em uma única unidade. GitHub também usa os metadados da ação na sua página GitHub Marketplace.

As ações são publicadas em GitHub Marketplace imediatamente e não são revisadas por GitHub, desde que esses requisitos sejam satisfeitos:

  • A ação deve estar em um repositório público.
  • Cada repositório deve conter uma ação única.
  • O arquivo de metadados da ação (action.yml ou action.yaml) deve estar no diretório-raiz do repositório.
  • O nome do arquivo de metadados da ação deve ser único.
    • O nome não pode corresponder ao nome de uma ação publicado em GitHub Marketplace.
    • O nome não pode corresponder a um usuário ou organização em GitHub, a menos que o usuário ou o proprietário da organização esteja publicando a ação. Por exemplo, somente GitHub a organização pode publicar uma ação denominada GitHub.
    • O nome não pode corresponder a uma categoria GitHub Marketplace.
    • GitHub reserva os nomes de recursos GitHub.

Publicar uma ação

Você pode adicionar a ação que você criou em GitHub Marketplace identificando-a como uma nova versão e publicando-a.

Para compartilhar uma nova versão e publicar a ação em GitHub Marketplace, siga essas instruções:

  1. No GitHub, navegue até a página principal do repositório.
  2. Se um repositório contiver um arquivo de metadados da ação (action.yml ou action.yaml), você verá um banner para publicar a ação em GitHub Marketplace. Clique em Elaborar uma versão.
    Publique esta ação no botão marketplace
  3. Selecione Publicar esta ação em GitHub Marketplace. Se não for possível marcar a caixa de seleção Publicar esta ação em GitHub Marketplace, você deverá ler e aceitar o Contrato GitHub Marketplace primeiro.
    Selecione publicar no "Marketplace"
  4. Se as etiquetas do seu arquivo de metadados tiverem algum problema, você receberá uma mensagem de erro.
    Veja a notificação
  5. Se você ver alguma sugestão na tela, resolva-as atualizando o arquivo de metadados. Após a conclusão, você receberá a mensagem "Tudo está OK".
    Corrigir erros
  6. Escolha uma "categoria primária" e, opcionalmente, "outra categoria", que ajudará as pessoas a encontrar a sua ação em GitHub Marketplace.
    Escolha a categoria
  7. Marque a sua Ação com uma versão e adicione um título de versão. Isso ajuda as pessoas a saber quais alterações ou recursos estão incluídos na versão. As pessoas verão a versão na página dedicada da ação GitHub Marketplace.
    Marque uma versão
  8. Preencha todos os outros campos e clique em Publicar versão. A publicação exige a utilização de uma autenticação de dois fatores. Para obter mais informações, consulte "Configurar a autenticação de dois fatores".
    Publique a versão

Remover uma ação de GitHub Marketplace

Para remover uma ação publicada de GitHub Marketplace, você deverá atualizar cada versão publicada. Realize as etapas a seguir para cada versão da ação que você publicou em GitHub Marketplace.

  1. No GitHub, navegue até a página principal do repositório.

  2. À direita da lista de arquivos, clique em Versões ou Última versão.

    Seção de versões na barra lateral direita

  3. Na página Releases (Versões), à direita da versão que deseja editar, clique em Edit (Editar).

    Botão Release edit (Edição de versão)

  4. Selecione Publicar esta ação em GitHub Marketplace para remover a seleção da caixa.

    Botão "publicar esta ação"

  5. Clique em Atualizar versão na parte inferior da página.

    Atualize o botão da versão

Esse documento ajudou você?

Privacy policy

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.