Skip to main content

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.

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 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 denominada GitHub.
    • O nome não pode corresponder a uma categoria 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.com, 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.com, navegue até a página principal do repositório.
  2. To the right of the list of files, click Releases. Seção de versões na barra lateral direita
  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