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 "Compartilhar automações".
Ao planejar a publicação da ação no GitHub Marketplace, verifique se o repositório inclui apenas o arquivo de metadados, o código e os arquivos necessários para ela. 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.
- Cada repositório não deve conter nenhum arquivo de fluxo de trabalho.
- O arquivo de metadados da ação (
action.yml
ouaction.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 chamadagithub
. - O
name
não pode corresponder a uma categoria existente do GitHub Marketplace. - GitHub reserva os nomes de recursos GitHub.
- O
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:
-
No GitHub.com, navegue até a página principal do repositório.
-
Navegue até o arquivo de metadados da ação em seu repositório (
action.yml
ouaction.yaml
) e você verá um banner para publicar a ação no GitHub Marketplace. Clique em Criar rascunho de uma versão. -
Selecione Publicar esta Ação no GitHub Marketplace em "Ação de Versão".
Observação: a caixa de seleção "Publicar" será desabilitada se a conta que possui o repositório ainda não tiver aceitado o Contrato de Desenvolvedor do GitHub Marketplace. Se você tiver o repositório ou for um proprietário da organização, clique no link para "aceitar o Contrato de Desenvolvedor do GitHub Marketplace" e aceite o contrato. Se não houver nenhum link, envie um link para o proprietário da organização para esta página "Ação de Liberação" e solicite que ele aceite o contrato.
-
Se as etiquetas do seu arquivo de metadados tiverem algum problema, você receberá uma mensagem de erro. Resolva-os atualizando o arquivo de metadados. Após a conclusão, você verá a mensagem "Está tudo certo!" .
-
Selecione o menu suspenso Categoria Primária e clique em uma categoria que ajudará as pessoas a encontrar sua ação no GitHub Marketplace.
-
Opcionalmente, selecione o menu suspenso Outra Categoria e clique em uma categoria secundária.
-
No campo de tag, digite uma versão para a açã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.
-
No campo de título, digite um título de versão.
-
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 "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.
-
À direita da lista de arquivos, clique em Versões.
-
Ao lado da versão que você deseja editar, clique em .
-
Selecione Publicar esta ação no GitHub Marketplace para remover a seleção da caixa.
-
Clique em Atualizar versão na parte inferior da página.
Transferência de um repositório de ações
É possível transferir um repositório de ações para outro usuário ou organização. Para obter mais informações, confira "Transferir um repositório".
Quando um administrador de repositório transfere um repositório de ações, o GitHub cria automaticamente um redirecionamento da URL anterior para a nova URL, o que significa que os fluxos de trabalho que usam a ação afetada não precisam ser atualizados.
As ações publicadas no GitHub Marketplace são vinculadas a um repositório por seu identificador exclusivo name
, o que significa que você pode publicar novas versões de uma ação do repositório transferido na mesma listagem do GitHub Marketplace. Se um repositório de ações for excluído, a listagem do GitHub Marketplace também será excluída, e o identificador exclusivo name
ficará disponível.
Observação: o selo "Verificado" visto no perfil do GitHub de uma organização é diferente do selo de criador verificado no GitHub Marketplace. Se você transferir um repositório de ações, a listagem do GitHub Marketplace perderá o selo de criador verificado, a menos que o novo proprietário também seja um criador verificado.
Sobre notificações no GitHub Marketplace
Ações com o ou com o selo de criador verificado indicam que o GitHub verificou o criador da ação como uma organização parceira. Os parceiros podem enviar um email para partnerships@github.com a fim de solicitar o selo de criador verificado.