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. O GitHub Actions não está disponível para repositórios privados de contas que utilizam planos antigos por-repositório. Para obter mais informações, consulte os "produtos do 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 a um nome de uma ação existente 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 existente 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. Under your repository name, click Releases.
    Releases tab
  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

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato