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á. # Começando com CodePipeline Se você não conhece CodePipeline, pode seguir os tutoriais deste guia depois de seguir as etapas deste capítulo para configurar. O CodePipeline console inclui informações úteis em um painel dobrável que você pode abrir a partir do ícone de informações ou de qualquer ** link de ** informações na página. (![Image showing the lower-case letter i that is used as the console info icon](https://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/console-info-icon.png)). Você pode fechar esse painel a qualquer momento. O CodePipeline console também fornece uma maneira de pesquisar rapidamente seus recursos, como repositórios, projetos de compilação, aplicativos de implantação e pipelines. Selecione **Go to resource (Acessar recurso)** ou pressione a tecla `/` e digite o nome do recurso. Qualquer correspondência aparecerá na lista. As pesquisas não diferenciam letras maiúsculas de minúsculas. Só é possível ver recursos para os quais você tem permissão de visualizar. Para obter mais informações, consulte [Visualizar recursos no console](security-iam-resources-console.md). Antes de poder usar AWS CodePipeline pela primeira vez, você deve criar seu Conta da AWS e criar seu primeiro usuário administrativo. **Topics** + [Inscreva-se em um Conta da AWS](#sign-up-for-aws) + [Aplique uma política gerenciada para acesso administrativo ao CodePipeline](#assign-permissions) + [Instale o   AWS CLI](#install-cli) + [Abra o console para CodePipeline](#open-codepipeline-console) + [Próximas etapas](#next-steps) ## Inscreva-se em um Conta da AWS Para começar AWS, você precisa de um Conta da AWS. Para obter informações sobre como criar um Conta da AWS, consulte [ Introdução a um Conta da AWS](https://docs.aws.amazon.com/accounts/latest/reference/getting-started.html) no Guia de *AWS Gerenciamento de contas referência*. ## Aplique uma política gerenciada para acesso administrativo ao CodePipeline Você deve conceder permissões para interagir com CodePipeline. A maneira mais rápida de fazer isso é aplicando a política gerenciada `AWSCodePipeline_FullAccess` ao usuário administrativo. **nota** A `AWSCodePipeline_FullAccess` política inclui permissões que permitem que o usuário do console transmita uma função do IAM para CodePipeline ou outra Serviços da AWS. Isso permite que o serviço assuma a função e execute ações em seu nome. As permissões `iam:PassRole` são aplicadas quando você anexa a política a um usuário, função ou grupo. Certifique-se de que a política só é aplicada a usuários confiáveis. Quando os usuários com essas permissões usam o console para criar ou editar um pipeline, as seguintes opções ficam disponíveis: Crie uma função CodePipeline de serviço ou escolha uma existente e passe a função para CodePipeline Pode optar por criar uma regra de CloudWatch Eventos para detecção de alterações e passar a função de serviço de CloudWatch CloudWatch Eventos para Eventos Para obter mais informações, consulte [ Conceder permissões a um usuário para passar uma função para um AWS service (Serviço da AWS)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html). **nota** A `AWSCodePipeline_FullAccess` política fornece acesso a todas as CodePipeline ações e recursos aos quais o usuário do IAM tem acesso, bem como a todas as ações possíveis ao criar estágios em um pipeline, como criar estágios que incluem CodeDeploy o Elastic Beanstalk ou o Amazon S3. Como uma das melhores práticas, você deve conceder a indivíduos apenas as permissões de que precisam para executar suas tarefas. Para obter mais informações sobre como restringir os usuários do IAM a um conjunto limitado de CodePipeline ações e recursos, consulte[Remover permissões da função CodePipeline de serviço](how-to-custom-role.md#remove-permissions-from-policy). Para conceder acesso, adicione as permissões aos seus usuários, grupos ou perfis: + Usuários e grupos em Centro de Identidade do AWS IAM: Crie um conjunto de permissões. Siga as instruções em [Criação de um conjunto de permissões](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtocreatepermissionset.html) no *Guia do usuário do Centro de Identidade do AWS IAM *. + Usuários gerenciados no IAM com provedor de identidades: Crie um perfil para a federação de identidades. Siga as instruções em [Criando um perfil para um provedor de identidades de terceiros (federação)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp.html) no *Guia do Usuário do IAM*. + Usuários do IAM: + Crie um perfil que seu usuário possa assumir. Siga as instruções em [Criação de um perfil para um usuário do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html) no *Guia do usuário do IAM*. + (Não recomendado) Vincule uma política diretamente a um usuário ou adicione um usuário a um grupo de usuários. Siga as instruções em [Adição de permissões a um usuário (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) no *Guia do usuário do IAM*. ## Instale o   AWS CLI Para chamar CodePipeline comandos da AWS CLI em uma máquina de desenvolvimento local, você deve instalar a AWS CLI. Essa etapa é opcional se você pretende começar usando somente as etapas deste guia para o CodePipeline console. **Para instalar e configurar o AWS CLI** 1. Em sua máquina local, baixe e instale AWS CLI o. Isso permitirá que você interaja a CodePipeline partir da linha de comando. Para obter mais informações, consulte [ Como configurar a interface de linha de AWS comando](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html). **nota** CodePipeline funciona somente com AWS CLI as versões 1.7.38 e posteriores. Para determinar qual versão do AWS CLI que você pode ter instalado, execute o comando**aws --version**. Para atualizar uma versão mais antiga do AWS CLI para a versão mais recente, siga as instruções em [ Desinstalando o e AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-uninstall.html), em seguida, siga as instruções em [ Instalando o. AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) 1. Configure o AWS CLI com o **configure** comando, 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 CodePipeline as quais você usará. Quando solicitado o nome da região padrão, especifique a região em que você criará o funil, como`us-east-2`. Quando solicitado pelo formato de saída padrão, especifique `json`. Por exemplo: ``` AWS Access Key ID [None]: {{Type your target AWS access key ID here, and then press Enter}} AWS Secret Access Key [None]: {{Type your target AWS secret access key here, and then press Enter}} Default region name [None]: {{Type}} us-east-2 {{here, and then press Enter}} Default output format [None]: {{Type}} json {{here, and then press Enter}} ``` **nota** Para obter mais informações sobre o IAM, chaves de acesso e chaves secretas, consulte [Gerenciamento de chaves de acesso para usuários do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingCredentials.html) e [Como obter as credenciais?](https://docs.aws.amazon.com/IAM/latest/UserGuide/IAM_Introduction.html#IAM_SecurityCredentials) Para obter mais informações sobre as regiões e os endpoints disponíveis CodePipeline, consulte [AWS CodePipeline Endpoints e cotas. ](https://docs.aws.amazon.com/general/latest/gr/codepipeline.html) ## Abra o console para CodePipeline + Faça login no Console de gerenciamento da AWS e abra o CodePipeline console em [ http://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home). ## Próximas etapas Você concluiu os pré-requisitos. Você pode começar a usar CodePipeline. Para começar a trabalhar com o CodePipeline, consulte [CodePipeline tutoriais](tutorials.md).