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, 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.
   
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.
   
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ê receberá a mensagem "Tudo está OK".
   
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, consulte "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, navegue até a página principal do repositório.
2. Under your repository name, click Releases.
   
3. Na página Releases (Versões), à direita da versão que deseja editar, clique em Edit (Editar).
   
4. Selecione Publicar esta ação em GitHub Marketplace para remover a seleção da caixa.
   
5. Clique em Atualizar versão na parte inferior da página.