Publicar ações no GitHub Marketplace

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, confira "Como 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 precisa estar em um repositório público.
• Cada repositório precisa conter uma única ação.
• O arquivo de metadados da ação (action.yml ou action.yaml) precisa estar no diretório raiz do repositório.
• O arquivo de metadados da ação name precisa ser exclusivo.
  • O name não pode corresponder a um nome de ação existente publicado no GitHub Marketplace.
  • O name não pode corresponder a um usuário ou a uma organização do GitHub, a menos que o usuário ou o proprietário da organização esteja publicando a ação. Por exemplo, somente a organização do GitHub pode publicar uma ação chamada github.
  • O name não pode corresponder a uma categoria existente do GitHub Marketplace.
  • GitHub reserva os nomes de recursos GitHub.

Publicando 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.com, navegue até a página principal do repositório.

2. Navegue até o arquivo de metadados da ação em seu repositório (action.yml ou action.yaml) e você verá um banner para publicar a ação no GitHub Marketplace. Clique em Criar rascunho de uma versão.

   

3. Em "Ação de liberar", selecione a caixa de seleção para publicar a ação no GitHub Marketplace. Se você não puder selecionar a caixa de seleção, primeiro clique no link para ler e aceitar o Contrato de Desenvolvedor do GitHub Marketplace.

4. Se as etiquetas do seu arquivo de metadados tiverem algum problema, você receberá uma mensagem de erro.

5. Se você ver alguma sugestão na tela, resolva-as atualizando o arquivo de metadados. Após a conclusão, você verá a mensagem "Está tudo certo!" . ](/assets/images/help/repository/marketplace_actions_looksgood.png)Correção de erros![

6. Escolha uma "categoria primária" e, opcionalmente, "outra categoria", que ajudará as pessoas a encontrar a sua ação em GitHub Marketplace.

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.

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, confira "Como configurar a autenticação de dois fatores".

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.com, navegue até a página principal do repositório. 1. À direita da lista de arquivos, clique em Versões.
2. Na página Versões, à direita da versão que deseja editar, clique em Editar.
3. Selecione Publicar esta ação no GitHub Marketplace para remover a seleção da caixa.
4. Clique em Atualizar versão na parte inferior da página.