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
ouaction.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 denominadaGitHub
. - O
nome
não pode corresponder a uma categoria GitHub Marketplace. - GitHub reserva os nomes de recursos GitHub.
- O
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:
- No GitHub.com, navegue até a página principal do repositório.
- Se um repositório contiver um arquivo de metadados da ação (
action.yml
ouaction.yaml
), você verá um banner para publicar a ação em GitHub Marketplace. Clique em Elaborar uma versão. - 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.
- Se as etiquetas do seu arquivo de metadados tiverem algum problema, você receberá uma mensagem de erro.
- 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".
- Escolha uma "categoria primária" e, opcionalmente, "outra categoria", que ajudará as pessoas a encontrar a sua ação em GitHub Marketplace.
- 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.
- 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.
- No GitHub.com, navegue até a página principal do repositório.
- To the right of the list of files, click Releases.
- Na página Releases (Versões), à direita da versão que deseja editar, clique em Edit (Editar).
- Selecione Publicar esta ação em GitHub Marketplace para remover a seleção da caixa.
- Clique em Atualizar versão na parte inferior da página.