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á.
Você pode usar o Cargo para publicar e baixar caixas de CodeArtifact repositórios ou para buscar caixas em crates.io
Configure o Cargo com CodeArtifact
Para usar o Cargo para instalar e publicar caixas AWS CodeArtifact, primeiro você precisa configurá-las com as informações do seu CodeArtifact repositório. Siga as etapas em um dos procedimentos a seguir para configurar o Cargo com as informações e CodeArtifact credenciais do endpoint do repositório.
Configure o Cargo usando as instruções do console
Você pode usar as instruções de configuração no console para conectar o Cargo ao seu CodeArtifact repositório. As instruções do console fornecem uma configuração do Cargo personalizada para seu CodeArtifact repositório. Você pode usar essa configuração personalizada para configurar o Cargo sem precisar encontrar e preencher suas CodeArtifact informações.
-
Abra o AWS CodeArtifact console em https://console.aws.amazon.com/codesuite/codeartifact/home
. -
No painel de navegação, escolha Repositórios e, em seguida, escolha um repositório para se conectar ao Cargo.
-
Escolha Exibir instruções de conexão.
-
Escolha seu sistema operacional.
-
Escolha Cargo.
-
Siga as instruções geradas para conectar o Cargo ao seu CodeArtifact repositório.
Configurar o Cargo manualmente
Se você não puder ou não quiser usar as instruções de configuração do console, você pode usar as instruções a seguir para conectar o Cargo ao seu CodeArtifact repositório manualmente.
Para configurar o Cargo com CodeArtifact, você precisa definir seu CodeArtifact repositório como um registro na configuração do Cargo e fornecer credenciais.
my_registry
Substitua pelo nome do seu registro.my_domain
Substitua pelo seu nome de CodeArtifact domínio.111122223333
Substitua pelo ID da AWS conta do proprietário do domínio. Se você estiver acessando um repositório em um domínio de sua propriedade, não será necessário incluir--domain-owner
. Para obter mais informações, consulte Domínios entre contas.my_repo
Substitua pelo nome CodeArtifact do seu repositório.
Copie a configuração para publicar e baixar pacotes Cargo em seu repositório e salve-a no ~/.cargo/config.toml
arquivo para uma configuração em nível de sistema ou .cargo/config.toml
para uma configuração em nível de projeto:
[registries.
my_registry
] index = "sparse+https://my_domain
-111122223333
.d.codeartifact.us-west-2
.amazonaws.com/cargo/my_repo
/" credential-provider = "cargo:token-from-stdout aws codeartifact get-authorization-token --domainmy_domain
--domain-owner111122223333
--regionus-west-2
--query authorizationToken --output text" [registry] default = "my_registry
" [source.crates-io] replace-with = "my_registry
"
A [registries.
seção no exemplo anterior define um registro com my_registry
]my_registry
index
e fornece credential-provider
informações.
-
index
especifica a URL do índice do seu registro, que é o endpoint do CodeArtifact repositório que termina com a./
Osparse+
prefixo é obrigatório para registros que não são repositórios Git.nota
Para usar um endpoint de pilha dupla, use o endpoint.
codeartifact.
region
.on.aws -
credential-provider
especifica o provedor de credenciais para o registro em questão. Secredential-provider
não estiver definido, os provedores emregistry.global-credential-providers
serão usados. Aocredential-provider
configurar comocargo:token-from-stdout
, o cliente Cargo buscará o novo token de autorização automaticamente ao publicar ou fazer o download do seu CodeArtifact repositório, portanto, você não precisa atualizar manualmente o token de autorização a cada 12 horas.
A [registry]
seção define o registro padrão usado.
-
default
especifica o nome do registro definido em[registries.
, para usar por padrão ao publicar ou baixar do seu CodeArtifact repositório.my_registry
]
A [source.crates-io]
seção define o registro padrão usado quando um não é especificado.
-
replace-with = "
substitui o registro público, crates.io, pelo seu CodeArtifact repositório definido em.my_registry
"[registries.
Essa configuração é recomendada se você precisar solicitar pacotes da conexão externa, como crates.io.my_registry
]Para obter todos os benefícios CodeArtifact, como o controle de origem do pacote que evita ataques de confusão de dependências, é recomendável usar a substituição de origem. Com a substituição da fonte, faz o CodeArtifact proxy de todas as solicitações para a conexão externa e copia o pacote da conexão externa para o seu repositório. Sem a substituição da fonte, o cliente Cargo recuperará diretamente o pacote com base na configuração em seu
Cargo.toml
arquivo em seu projeto. Se uma dependência não estiver marcada comregistry=
, o cliente Cargo a recuperará diretamente do crates.io sem se comunicar com seu repositório. CodeArtifactmy_registry
nota
Se você começar a usar a substituição de origem e depois atualizar seu arquivo de configuração para não usar a substituição de origem, poderá encontrar erros. O cenário oposto também pode levar a erros. Portanto, é recomendável evitar alterar a configuração do seu projeto.
Instalação de caixas de carga
Instale caixas de carga a partir de CodeArtifact
Você pode usar a CLI Cargo (cargo
) para instalar rapidamente uma versão específica de uma caixa Cargo do seu repositório. CodeArtifact
Para instalar caixas de carga a partir de um CodeArtifact repositório com cargo
Caso contrário, siga as etapas Configure e use o Cargo com CodeArtifact para configurar a
cargo
CLI para usar seu CodeArtifact repositório com as credenciais adequadas.-
Use o comando a seguir para instalar caixas de carga a partir de CodeArtifact:
cargo add my_cargo_package@
1.0.0
Para obter mais informações, consulte cargo add
no The Cargo Book.
Publicando caixas de carga para CodeArtifact
Use o procedimento a seguir para publicar caixas de carga em um CodeArtifact repositório usando a CLIcargo
.
Caso contrário, siga as etapas Configure e use o Cargo com CodeArtifact para configurar a
cargo
CLI para usar seu CodeArtifact repositório com as credenciais adequadas.-
Use o comando a seguir para publicar caixas de carga em um CodeArtifact repositório:
cargo publish
Para obter mais informações, consulte cargo publish
no The Cargo Book.