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á. # Configurando com AWS CodeArtifact Se já tiver se cadastrado na Amazon Web Services (AWS), você poderá começar a usar o AWS CodeArtifact imediatamente. Você pode abrir o CodeArtifact console, escolher **Criar um domínio e repositório** e seguir as etapas no assistente de inicialização para criar seu primeiro domínio e repositório. Se você ainda não se inscreveu ou precisa de ajuda para AWS criar seu primeiro domínio e repositório, conclua as seguintes tarefas para se preparar para usar CodeArtifact: **Topics** + [Inscreva-se para AWS](get-set-up-sign-up-for-aws.md) + [Instale ou atualize e, em seguida, configure o AWS CLI](get-set-up-install-cli.md) + [Provisionar um usuário do IAM](get-set-up-provision-user.md) + [Instalar o gerenciador de pacotes ou ferramenta de compilação](getting-started-install-package-manager.md) # Inscreva-se para AWS Quando você se inscreve no Amazon Web Services (AWS), você é cobrado somente pelos serviços e recursos que usa, inclusive AWS CodeArtifact. Se você já tem um Conta da AWS, vá para a próxima tarefa,[Instale ou atualize e, em seguida, configure o AWS CLI](get-set-up-install-cli.md). Se você não tiver um Conta da AWS, use o procedimento a seguir para criar um. **Para criar um Conta da AWS** 1. Abra a [https://portal.aws.amazon.com/billing/inscrição.](https://portal.aws.amazon.com/billing/signup) 1. Siga as instruções online. Parte do procedimento de inscrição envolve receber uma chamada telefônica ou uma mensagem de texto e inserir um código de verificação pelo teclado do telefone. Quando você se inscreve em um Conta da AWS, um *Usuário raiz da conta da AWS*é criado. O usuário-raiz tem acesso a todos os Serviços da AWS e recursos na conta. Como prática recomendada de segurança, atribua o acesso administrativo a um usuário e use somente o usuário-raiz para executar [tarefas que exigem acesso de usuário-raiz](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks). # Instale ou atualize e, em seguida, configure o AWS CLI Para chamar CodeArtifact comandos do AWS Command Line Interface (AWS CLI) em uma máquina de desenvolvimento local, você deve instalar AWS CLI o. Se você tiver uma versão mais antiga do AWS CLI instalado, deverá atualizá-la para que os CodeArtifact comandos estejam disponíveis. CodeArtifact os comandos estão disponíveis nas seguintes AWS CLI versões: 1. **AWS CLI 1:** 1.18.77 e versões mais recentes 1. **AWS CLI 2:** 2.0.21 e versões mais recentes Para verificar a versão, use o comando `aws --version`. **Para instalar e configurar o AWS CLI** 1. Instale ou atualize o AWS CLI com as instruções em [Instalando AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) o. 1. Configure o AWS CLI, com o comando **configure**, da seguinte forma. ``` aws configure ``` Quando solicitado, especifique a chave de AWS acesso e a chave de acesso AWS secreta do usuário do IAM com CodeArtifact o qual você usará. Quando o nome da região padrão Região da AWS for solicitado, especifique a região onde você criará o pipeline, por exemplo, `us-east-2`. Quando solicitado pelo formato de saída padrão, especifique `json`. **Importante** Ao configurar o AWS CLI, você será solicitado a especificar um Região da AWS. Escolha uma das regiões com suporte listada em [Região e endpoints](https://docs.aws.amazon.com/general/latest/gr/codeartifact.html) na *Referência geral da AWS*. Para obter mais informações, consulte [Configurar a AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) e [Gerenciamento de chaves de acesso para usuários do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingCredentials.html). 1. Para verificar a instalação ou atualização, chame o seguinte comando na AWS CLI. ``` aws codeartifact help ``` Se for bem-sucedido, esse comando exibirá uma lista dos CodeArtifact comandos disponíveis. Em seguida, você pode criar um usuário do IAM e conceder acesso a esse usuário CodeArtifact a. Para obter mais informações, consulte [Provisionar um usuário do IAM](get-set-up-provision-user.md). # Provisionar um usuário do IAM Siga estas instruções para preparar um usuário do IAM para usar CodeArtifact. **Para provisionar um usuário do IAM** 1. Crie um usuário do IAM ou use um associado à sua conta da Conta da AWS. Para obter mais informações, consulte [Criação de um usuário do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html#Using_CreateUser_console) e [Visão geral das políticas AWS do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html) *no Guia do usuário do IAM*. 1. Conceda ao usuário do IAM acesso CodeArtifact a. + **Opção 1:** criar uma política do IAM personalizada. Com uma política do IAM personalizada, você pode fornecer as permissões mínimas necessárias e alterar a duração dos tokens de autenticação. Para obter mais informações e políticas de exemplo, consulte [Exemplos de políticas baseadas em identidade para AWS CodeArtifact](security_iam_id-based-policy-examples.md). + **Opção 2:** Usar a política `AWSCodeArtifactAdminAccess` AWS gerenciada. O trecho a seguir mostra o conteúdo dessa política. **Importante** Essa política concede acesso a todos CodeArtifact APIs. Recomendamos que você sempre use as permissões mínimas necessárias para realizar sua tarefa. Para obter mais informações, consulte [Práticas recomendadas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) no *Guia do usuário do IAM*. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "codeartifact:*" ], "Effect": "Allow", "Resource": "*" }, { "Effect": "Allow", "Action": "sts:GetServiceBearerToken", "Resource": "*", "Condition": { "StringEquals": { "sts:AWSServiceName": "codeartifact.amazonaws.com" } } } ] } ``` ------ **nota** A permissão `sts:GetServiceBearerToken` deve ser adicionada à política de usuário ou perfil do IAM. Embora possa ser adicionada a uma política de recursos de CodeArtifact domínio ou repositório, a permissão não terá efeito nas políticas de recursos. A `sts:GetServiceBearerToken` permissão é necessária para chamar a CodeArtifact `GetAuthorizationToken` API. Essa API retorna um token que deve ser usado ao usar um gerenciador de pacotes, como `npm` ou `pip` com CodeArtifact. Para usar um gerenciador de pacotes com um CodeArtifact repositório, seu usuário ou função do IAM deve permitir, `sts:GetServiceBearerToken` conforme mostrado no exemplo de política anterior. Se você não instalou o gerenciador de pacotes ou a ferramenta de compilação com a qual planeja usar CodeArtifact, consulte[Instalar o gerenciador de pacotes ou ferramenta de compilação](getting-started-install-package-manager.md). # Instalar o gerenciador de pacotes ou ferramenta de compilação Para publicar ou consumir pacotes do CodeArtifact, você deve usar um gerenciador de pacotes. Há gerenciadores de pacotes diferentes para cada tipo de pacote. A lista a seguir contém alguns gerenciadores de pacotes com os quais você pode usar CodeArtifact. Caso ainda não tenha feito, instale os gerenciadores de pacotes para o tipo de pacote que você deseja usar. + Para npm, use a [CLI do npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) ou o [pnpm](https://pnpm.io/installation). + Para o Maven, use o [Apache Maven (`mvn`)](https://maven.apache.org/install.html) ou o [Gradle](https://gradle.org/install/). + Para Python, use [pip](https://pip.pypa.io/en/stable/installation/) para instalar pacotes e [twine](https://twine.readthedocs.io/en/stable/#installation) para publicar pacotes. + [Para NuGet, use o [Toolkit for Visual Studio no Visual](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/setup.html) Studio ou [o nuget ou dotnet](https://learn.microsoft.com/en-us/nuget/reference/nuget-exe-cli-reference).](https://learn.microsoft.com/en-us/dotnet/core/install/) CLIs + Para pacotes [genéricos](using-generic.md), use o [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) ou SDK para publicar e baixar o conteúdo do pacote. ## Próximas etapas Suas próximas etapas dependerão do tipo ou tipos de pacote com CodeArtifact os quais você está usando e do estado dos seus CodeArtifact recursos. Se você está começando CodeArtifact a usar pela primeira vez para si mesmo, sua equipe ou organização, consulte a documentação a seguir para obter informações gerais sobre como começar e ajudar a criar os recursos necessários. + [Conceitos básicos que usam o console](getting-started-console.md) + [Conceitos básicos do uso da AWS CLI](getting-started-cli.md) Se seus recursos já tiverem sido criados e você estiver pronto para configurar seu gerenciador de pacotes para enviar pacotes para ou instalar pacotes de um CodeArtifact repositório, consulte a documentação que corresponde ao seu tipo de pacote ou gerenciador de pacotes. + [Usando o CodeArtifact com npm](using-npm.md) + [Usando CodeArtifact com Python](using-python.md) + [Usando o CodeArtifact com Maven](using-maven.md) + [Usando o CodeArtifact com NuGet](using-nuget.md) + [Usando CodeArtifact com pacotes genéricos](using-generic.md)