A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configuração e uso de npm
<a name="packages-npm-use"></a>

Para usar `npm` com CodeCatalyst, você deve se conectar `npm` ao seu repositório de pacotes e fornecer um token de acesso pessoal (PAT) para autenticação. Você pode ver as instruções para se conectar `npm` ao seu repositório de pacotes no CodeCatalyst console.

**Contents**
+ [Configurando o npm com CodeCatalyst](#npm-configure)
+ [Instalando pacotes npm a partir de um repositório de CodeCatalyst pacotes](#npm-install)
+ [Instalando pacotes npm do npmjs por meio de CodeCatalyst](#npm-install-npmjs)
+ [Publicando pacotes npm em seu repositório de CodeCatalyst pacotes](#npm-publish)
+ [Suporte para comandos npm](#npm-commands)
  + [Comandos compatíveis que interagem com um repositório de pacotes](#supported-commands-that-interact-with-a-repository)
  + [Comandos do lado do cliente compatíveis](#supported-client-side-commands)
  + [Comandos incompatíveis](#unsupported-commands)

## Configurando o npm com CodeCatalyst
<a name="npm-configure"></a>

As instruções a seguir explicam como se autenticar e se conectar `npm` ao seu repositório de CodeCatalyst pacotes. Para ter mais informações sobre o npm, consulte a [documentação oficial do npm](https://docs.npmjs.com/).

**Para se conectar `npm` ao seu repositório de CodeCatalyst pacotes**

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navegue até o projeto.

1. No painel de navegação, selecione **Packages (pacotes)**.

1. Escolha o repositório de pacotes na lista.

1. Selecione **Conectar ao repositório**.

1. Em **Detalhes da configuração**, no **Cliente do Package Manager**, selecione **Cliente do npm**.

1. Escolha o sistema operacional para ver as etapas de configuração correspondentes.

1. É necessário um token de acesso pessoal (PAT) para autenticar o npm com. CodeCatalyst Se você já possui um token, poderá usá-lo. Caso contrário, você pode criar um usando as etapas a seguir.

   1. **(Opcional):** atualize o **Nome do PAT** e a **Data de expiração**.

   1. Selecione **Criar token**.

   1. Copie e guarde o PAT em um local seguro.
**Atenção**  
Você não poderá ver ou copiar seu PAT novamente depois de fechar a caixa de diálogo. As credenciais devem ser de curta duração para minimizar o tempo que um invasor pode usar as credenciais após usá-las indevidamente.

1. Execute os comandos a seguir no diretório raiz do projeto para configurar o npm com seu repositório de pacotes. Os comandos farão o seguinte:
   + Crie um arquivo `.npmrc` no nível do projeto se o seu projeto não tiver um.
   + Adicione as informações do endpoint do repositório de pacotes ao arquivo `.npmrc` no nível do projeto.
   + Adicione suas credenciais (PAT) ao arquivo `.npmrc` no nível do usuário.

   Substitua os valores a seguir.
**nota**  
Se você estiver copiando as instruções do console, os valores nos comandos a seguir serão atualizados e não precisarão ser alterados.
   + {{username}}Substitua CodeCatalyst pelo seu nome de usuário.
   + {{PAT}}Substitua por seu CodeCatalyst PAT.
   + {{space\_name}}Substitua pelo nome do seu CodeCatalyst espaço.
   + {{proj\_name}}Substitua pelo nome CodeCatalyst do seu projeto.
   + {{repo\_name}}Substitua pelo nome CodeCatalyst do repositório do pacote.

   ```
   npm set registry=https://packages.{{region}}.codecatalyst.aws/npm/{{space-name}}/{{proj-name}}/{{repo-name}}/ --location project
   npm set //packages.{{region}}.codecatalyst.aws/npm/{{space-name}}/{{proj-name}}/{{repo-name}}/:_authToken={{username}}:{{PAT}}
   ```

   **Para npm 6 ou inferior:** para fazer com que o npm sempre passe o token de autenticação para CodeCatalyst, mesmo para `GET` solicitações, defina a variável de configuração always-auth da seguinte forma. `npm config set`

   ```
   npm set //packages.{{region}}.codecatalyst.aws/npm/{{space-name}}/{{proj-name}}/{{repo-name}}/:always-auth=true --location project
   ```

## Instalando pacotes npm a partir de um repositório de CodeCatalyst pacotes
<a name="npm-install"></a>

Depois de conectar o npm ao seu repositório seguindo as etapas em [Configurando o npm com CodeCatalyst](#npm-configure), você pode executar comandos `npm` no seu repositório.

Você pode instalar um pacote npm que esteja no seu repositório de CodeCatalyst pacotes ou em um de seus repositórios upstream com o comando. `npm install`

```
npm install {{lodash}}
```

## Instalando pacotes npm do npmjs por meio de CodeCatalyst
<a name="npm-install-npmjs"></a>

Você pode instalar pacotes npm do [npmjs.com](https://www.npmjs.com/) por meio de um repositório configurando o CodeCatalyst repositório com uma conexão upstream com o repositório do gateway conectado ao npmjs.com,. **npm-public-registry-gateway** Os pacotes instalados em npmjs são ingeridos e armazenados no repositório de gateway e no repositório de pacotes downstream mais distante.

**Para instalar pacotes do npmjs**

1. Se você ainda não tiver feito isso, configure `npm` com seu repositório de CodeCatalyst pacotes seguindo as etapas em[Configurando o npm com CodeCatalyst](#npm-configure). 

1. Verifique se seu repositório adicionou o repositório do gateway, **npm-public-registry-gateway**, como uma conexão upstream. Você pode verificar quais fontes upstream foram adicionadas ou adicionadas **npm-public-registry-gateway**como fonte upstream seguindo as instruções [Adição de um repositório upstream](packages-upstream-repositories-add.md) e escolhendo o **npm-public-registry-gateway**repositório.

1. Instale pacotes com o comando `npm install`.

   ```
   npm install {{package_name}}
   ```

Para ter mais informações sobre como solicitar pacotes de repositórios upstream, consulte [Solicitar uma versão do pacote com repositórios upstream](packages-upstream-repositories-request.md).

## Publicando pacotes npm em seu repositório de CodeCatalyst pacotes
<a name="npm-publish"></a>

Depois de concluir [Configurando o npm com CodeCatalyst](#npm-configure), você pode executar comandos `npm`.

Você pode publicar um pacote npm em um repositório de CodeCatalyst pacotes com o `npm publish` comando.

```
npm publish
```

Para ter informações sobre como criar pacotes do npm, consulte [Criação de módulos Node.js](https://docs.npmjs.com/getting-started/creating-node-modules) no *Documento do npm*.

## Suporte para comandos npm
<a name="npm-commands"></a>

As seções a seguir resumem os `npm` comandos que são suportados pelos repositórios de CodeCatalyst pacotes, além de listar comandos específicos que não são suportados.

**Topics**
+ [Comandos compatíveis que interagem com um repositório de pacotes](#supported-commands-that-interact-with-a-repository)
+ [Comandos do lado do cliente compatíveis](#supported-client-side-commands)
+ [Comandos incompatíveis](#unsupported-commands)

### Comandos compatíveis que interagem com um repositório de pacotes
<a name="supported-commands-that-interact-with-a-repository"></a>

Esta seção lista os comandos `npm` em que o cliente `npm` faz uma ou mais solicitações ao registro no qual foi configurado (por exemplo, `npm config set registry`). Verificou-se que esses comandos funcionam corretamente quando invocados em um repositório de CodeCatalyst pacotes.


****  

| Command | Description | 
| --- | --- | 
|  [bugs](https://docs.npmjs.com/cli/bugs)  | Adivinha a localização do URL do rastreador de bugs de um pacote e, depois, tenta abri-lo. | 
|  [ci](https://docs.npmjs.com/cli/ci)  | Instala um projeto do zero. | 
|  [deprecate](https://docs.npmjs.com/cli/deprecate)  | Deprecia uma versão de um pacote. | 
|  [dist-tag](https://docs.npmjs.com/cli/dist-tag)  | Modifica as tags de distribuição do pacote. | 
|  [docs](https://docs.npmjs.com/cli/docs)  | Adivinha a localização do URL de documentação de um pacote e, depois, tenta abri-lo usando o parâmetro de configuração `--browser`. | 
|  [doctor](https://docs.npmjs.com/cli/doctor)  | Executa um conjunto de verificações para validar se sua instalação do npm pode gerenciar seus JavaScript pacotes. | 
|  [install](https://docs.npmjs.com/cli/install)  | Instala um pacote. | 
|  [install-ci-test](https://docs.npmjs.com/cli/install-ci-test)  | Instala um projeto do zero e executa testes. Alias: `npm cit`. Esse comando executa um `npm ci`, seguido imediatamente por um `npm test`. | 
|  [install-test](https://docs.npmjs.com/cli/install-test)  | Instala o pacote e executa testes. Executa um `npm install`, seguido imediatamente por um `npm test`. | 
|  [outdated](https://docs.npmjs.com/cli/outdated)  | Verifica o registro configurado para determinar se algum pacote instalado está desatualizado. | 
|  [ping](https://docs.npmjs.com/cli/ping)  | Faz ping no registro npm configurado ou fornecido e verifica a autenticação. | 
|  [publish](https://docs.npmjs.com/cli/publish)  | Publica uma versão do pacote no registro. | 
|  [update](https://docs.npmjs.com/cli/update)  | Adivinha a localização do URL do repositório de um pacote e, depois, tenta abri-lo usando o parâmetro de configuração `--browser`. | 
|  [view](https://docs.npmjs.com/cli/view)  | Exibe os metadados do pacote. Também pode ser usado para imprimir propriedades de metadados. | 

### Comandos do lado do cliente compatíveis
<a name="supported-client-side-commands"></a>

Esses comandos não exigem nenhuma interação direta com um repositório de pacotes, portanto, CodeCatalyst não exigem nada para suportá-los.


****  

| Command | Description | 
| --- | --- | 
|  [bin (legado)](https://docs.npmjs.com/cli/v8/commands/npm-bin)  | Exibe o diretório npm `bin`. | 
|  [build](https://docs.npmjs.com/cli/v6/commands/npm-build)  | Cria um pacote. | 
|  [cache](https://docs.npmjs.com/cli/cache)  | Manipula o cache de pacotes. | 
|  [completion](https://docs.npmjs.com/cli/completion)  | Ativa o preenchimento de guias em todos os comandos npm. | 
|  [config](https://docs.npmjs.com/cli/config)  | Atualiza o conteúdo do usuário e dos arquivos `npmrc` globais. | 
|  [dedupe](https://docs.npmjs.com/cli/dedupe)  | Pesquisa a árvore de pacotes local e tenta simplificar a estrutura movendo as dependências mais para cima na árvore, onde elas podem ser compartilhadas com mais eficiência por vários pacotes dependentes. | 
|  [edit](https://docs.npmjs.com/cli/edit)  | Edita um pacote instalado. Seleciona uma dependência no diretório de trabalho atual e abre o diretório do pacote no editor padrão. | 
|  [explore](https://docs.npmjs.com/cli/explore)  | Navega por um pacote instalado. Gera um subshell no diretório do pacote instalado especificado. Se um comando for especificado, ele será executado no subshell, que será encerrado imediatamente. | 
|  [help](https://docs.npmjs.com/cli/help)  | Recebe ajuda no npm. | 
|  [help-search](https://docs.npmjs.com/cli/help-search)  | Pesquisa a documentação de ajuda do npm. | 
|  [init](https://docs.npmjs.com/cli/init)  | Cria um arquivo `package.json`. | 
|  [link](https://docs.npmjs.com/cli/link)  | Vincula um diretório de pacotes. | 
|  [ls](https://docs.npmjs.com/cli/ls)  | Lista pacotes instalados. | 
|  [pack](https://docs.npmjs.com/cli/pack)  | Cria um tarball a partir de um pacote. | 
|  [prefix](https://docs.npmjs.com/cli/prefix)  | Exibe um prefixo. Esse é o diretório pai mais próximo que contém um arquivo `package.json`, a menos que `-g` também seja especificado. | 
|  [prune](https://docs.npmjs.com/cli/prune)  | Remove pacotes que não estão listados na lista de dependências do pacote pai. | 
|  [rebuild](https://docs.npmjs.com/cli/rebuild)  | Executa o comando `npm build` nas pastas correspondentes. | 
|  [restart](https://docs.npmjs.com/cli/restart)  | Executa os scripts de parada, reinicialização e inicialização de um pacote e os scripts anteriores e posteriores associados. | 
|  [raiz](https://docs.npmjs.com/cli/root)  | Imprime o diretório `node_modules` efetivo na saída padrão. | 
|  [run-script](https://docs.npmjs.com/cli/run-script)  | Executa scripts de pacotes arbitrários. | 
|  [shrinkwrap](https://docs.npmjs.com/cli/shrinkwrap)  | Bloqueia as versões de dependência para publicação. | 
|  [uninstall](https://docs.npmjs.com/cli/uninstall)  | Desinstala um pacote. | 

### Comandos incompatíveis
<a name="unsupported-commands"></a>

Esses `npm` comandos não são compatíveis com repositórios de CodeCatalyst pacotes.


****  

| Command | Description | Observações | 
| --- | --- | --- | 
|  [access](https://docs.npmjs.com/cli/access)  | Define o nível de acesso nos pacotes publicados. | CodeCatalyst usa um modelo de permissão diferente do repositório público npmjs. | 
|  [adduser](https://docs.npmjs.com/cli/adduser)  | Adiciona uma conta de usuário de registro | CodeCatalyst usa um modelo de usuário diferente do repositório público npmjs. | 
|  [audit](https://docs.npmjs.com/cli/audit)  | Executa uma auditoria de segurança. | CodeCatalyst atualmente não vende dados de vulnerabilidade de segurança. | 
|  [hook](https://docs.npmjs.com/cli/v9/commands/npm-hook)  | Gerencia hooks do npm, incluindo adição, remoção, listagem e atualização. | CodeCatalyst atualmente não oferece suporte a nenhum mecanismo de notificação de alterações. | 
|  [login](https://docs.npmjs.com/cli-commands/adduser.html)  | Autentica um usuário. Este é um alias para `npm adduser`.  | CodeCatalyst usa um modelo de autenticação diferente do repositório público npmjs. Para mais informações, consulte [Configurando o npm com CodeCatalyst](#npm-configure). | 
|  [logout](https://docs.npmjs.com/cli/logout)  | Sai do registro. | CodeCatalyst usa um modelo de autenticação diferente do repositório público npmjs. Não há como sair de um CodeCatalyst repositório, mas os tokens de autenticação expiram após o tempo de expiração configurável. A duração padrão do token é de 12 horas.  | 
|  [owner](https://docs.npmjs.com/cli/owner)  | Gerencia proprietários de pacotes. | CodeCatalyst usa um modelo de permissões diferente do repositório público npmjs. | 
|  [profile](https://docs.npmjs.com/cli/profile)  | Altera as configurações no seu perfil de registro. | CodeCatalyst usa um modelo de usuário diferente do repositório público npmjs. | 
|  [pesquisa](https://docs.npmjs.com/cli/search)  | Pesquisa no registro por pacotes que correspondam aos termos de pesquisa. | CodeCatalyst não suporta o `search` comando. | 
|  [star](https://docs.npmjs.com/cli/star)  | Marca seus pacotes favoritos. | CodeCatalyst atualmente não suporta nenhum mecanismo de favoritos. | 
|  [stars](https://docs.npmjs.com/cli/stars)  | Exibe pacotes marcados como favoritos. | CodeCatalyst atualmente não suporta nenhum mecanismo de favoritos. | 
|  [team](https://docs.npmjs.com/cli/team)  | Gerencia equipes e associações de equipes. | CodeCatalyst usa um modelo de associação de usuário e grupo diferente do repositório público npmjs. | 
|  [token](https://docs.npmjs.com/cli/token)  | Gerencia seus tokens de autenticação. | CodeCatalyst usa um modelo diferente para obter tokens de autenticação. Para mais informações, consulte [Configurando o npm com CodeCatalyst](#npm-configure). | 
|  [unpublish](https://docs.npmjs.com/cli/unpublish)  | Remove um pacote do registro. | CodeCatalyst não suporta a remoção de uma versão de pacote de um repositório usando o cliente npm. É possível excluir um pacote no console. | 
|  [whoami](https://docs.npmjs.com/cli/whoami)  | Exibe o nome do usuário npm. | CodeCatalyst usa um modelo de usuário diferente do repositório público npmjs. |