{"meta":{"title":"Guia de Início Rápido do GitHub Packages","intro":"Publique em GitHub Packages com GitHub Actions.","product":"GitHub Packages","breadcrumbs":[{"href":"/pt/packages","title":"GitHub Packages"},{"href":"/pt/packages/quickstart","title":"Início Rápido"}],"documentType":"article"},"body":"# Guia de Início Rápido do GitHub Packages\n\nPublique em GitHub Packages com GitHub Actions.\n\n## Introdução\n\nNeste guia, você criará um GitHub Actions fluxo de trabalho para testar seu código e depois publicá-lo em GitHub Packages.\n\n## Publicar o seu pacote\n\n1. Crie um novo repositório no GitHub, adicionando o `.gitignore` para Node. Para saber mais, confira [Criar um repositório](/pt/repositories/creating-and-managing-repositories/creating-a-new-repository).\n\n2. Clone o repositório em seu computador local.\n\n   ```shell\n   git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.git\n   cd YOUR-REPOSITORY\n   ```\n\n3. Crie um arquivo `index.js` e adicione um alerta básico para dizer \"Olá, mundo!\"\n\n   ```javascript copy\n   console.log(\"Hello, World!\");\n   ```\n\n4. Inicialize um pacote npm com `npm init`. No assistente de inicialização do pacote, insira o pacote com o nome *`@YOUR-USERNAME/YOUR-REPOSITORY`* e defina o script de teste como `exit 0`. Isso vai gerar um arquivo `package.json` com informações sobre o pacote.\n\n   ```shell\n   $ npm init\n     ...\n     package name: @YOUR-USERNAME/YOUR-REPOSITORY\n     ...\n     test command: exit 0\n     ...\n   ```\n\n5. Execute `npm install` para gerar o `package-lock.json` arquivo e, em seguida, confirme e envie suas alterações por push para GitHub.\n\n   ```shell\n   npm install\n   git add index.js package.json package-lock.json\n   git commit -m \"initialize npm package\"\n   git push\n   ```\n\n6. Crie um diretório `.github/workflows`. Nesse diretório, crie um arquivo chamado `release-package.yml`.\n\n7. Copie o seguinte conteúdo YAML para o `release-package.yml` arquivo.\n\n   ```yaml copy\n   name: Node.js Package\n\n   on:\n     release:\n       types: [created]\n\n   jobs:\n     build:\n       runs-on: ubuntu-latest\n       steps:\n         - uses: actions/checkout@v6\n         - uses: actions/setup-node@v7\n           with:\n             node-version: 20\n         - run: npm ci\n         - run: npm test\n\n     publish-gpr:\n       needs: build\n       runs-on: ubuntu-latest\n       permissions:\n         packages: write\n         contents: read\n       steps:\n         - uses: actions/checkout@v6\n         - uses: actions/setup-node@v7\n           with:\n             node-version: 20\n             registry-url: https://npm.pkg.github.com/\n         - run: npm ci\n         - run: npm publish\n           env:\n             NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}\n   ```\n\n8. Informe ao npm os escopos e o registro nos quais os pacotes serão publicados usando um dos seguintes métodos:\n   * Adicione um arquivo de configuração do npm ao repositório criando um arquivo `.npmrc` no diretório raiz com os conteúdos:\n\n     ```shell\n     @YOUR-USERNAME:registry=https://npm.pkg.github.com\n     ```\n\n   * Edite o arquivo `package.json` e especifique a chave `publishConfig`:\n\n     ```shell\n     \"publishConfig\": {\n       \"@YOUR-USERNAME:registry\": \"https://npm.pkg.github.com\"\n     }\n     ```\n\n9. Confirme e envie suas alterações por push para GitHub.\n\n   ```shell\n   $ git add .github/workflows/release-package.yml\n   # Also add the file you created or edited in the previous step.\n   $ git add .npmrc or package.json\n   $ git commit -m \"workflow to publish package\"\n   $ git push\n   ```\n\n10. O fluxo de trabalho que você criou será executado sempre que uma nova versão for criada no seu repositório. Se os testes passarem, o pacote será publicado em GitHub Packages.\n\n    Para testar isso, procure a guia **Código** no repositório e crie uma versão. Para obter mais informações, confira [Como gerenciar as versões do repositório](/pt/repositories/releasing-projects-on-github/managing-releases-in-a-repository#creating-a-release).\n\n## Visualizar o seu pacote publicado\n\nVocê pode ver todos os pacotes que você publicou.\n\n1. Em GitHub, acesse a página principal do repositório.\n2. Na barra lateral direita do repositório, clique em **Pacotes**.\n\n   ![Captura de tela da barra lateral da página do repositório. A seção \"Pacotes\" é contornada em laranja escuro.](/assets/images/help/package-registry/packages-from-repo.png)\n3. Procure e clique no nome do pacote que deseja ver.\n\n## Instalar um pacote publicado\n\nAgora que você publicou o pacote, você vai querer usá-lo como uma dependência nos seus projetos. Para saber mais, confira [Trabalhando com o repositório npm](/pt/packages/working-with-a-github-packages-registry/working-with-the-npm-registry#installing-a-package).\n\n## Próximas etapas\n\nO fluxo de trabalho básico que você acabou de adicionar é executado sempre que uma nova versão for criada no seu repositório. Mas este é apenas o começo do que você pode fazer com GitHub Packages. Pode publicar o seu pacote em vários registros com um único fluxo de trabalho, acionar o fluxo de trabalho para ser executado em eventos diferentes, como um pull request mesclado, gerenciar contêineres, entre outros.\n\nCombinar GitHub Packages e GitHub Actions pode ajudar você a automatizar quase todos os aspectos de seus processos de desenvolvimento de aplicativos. Pronto para começar? Aqui estão alguns recursos úteis para dar os próximos passos com GitHub Packages e GitHub Actions:\n\n* [Aprenda sobre o GitHub Packages](/pt/packages/learn-github-packages) para um tutorial detalhado sobre os pacotes do GitHub\n* [Escrevendo fluxos de trabalho](/pt/actions/how-tos/write-workflows) para um tutorial detalhado sobre o GitHub Actions\n* [Trabalhar com um registro do GitHub Packages](/pt/packages/working-with-a-github-packages-registry) para casos de uso e exemplos específicos"}