Busca de dependências do CodeCatalyst Busca de pacotes de repositórios de pacotes externos por meio do CodeCatalyst Publicar pacotes no CodeCatalyst Publicação de pacotes de terceiros

Configuração e uso de mvn

É possível usar o comando mvn para executar compilações do Maven. Você deve configurar mvn para usar seu repositório de pacotes e fornecer um token de acesso pessoal (PAT) para autenticação.

Sumário

Busca de dependências do CodeCatalyst

Para configurar o mvn para buscar dependências de um repositório do CodeCatalyst, você deve editar o arquivo de configuração do Maven, settings.xml e, opcionalmente, o arquivo de objeto de modelo (POM) do seu projeto. O arquivo POM contém informações sobre o projeto e informações de configuração do Maven para criar o projeto, como dependências, diretório de criação, diretório de origem, diretório de origem de teste, plug-in e metas.

Para usar o `mvn` para buscar dependências no repositório de pacotes do CodeCatalyst

Abra o console do CodeCatalyst em https://codecatalyst.aws/.
Na página de visão geral do projeto, selecione Pacotes.
Escolha seu repositório de pacotes na lista de repositórios de pacotes.
Selecione Conectar ao repositório.
Na caixa de diálogo Conectar ao repositório, selecione mvn na lista de clientes do gerenciador de pacotes.
Você precisará de um token de acesso pessoal (PAT) para a autenticação do mvn com o CodeCatalyst. Se você já tiver um, pode usá-lo. Caso contrário, você pode criar um aqui.
1. Selecione Criar token.
2. Para copiar o PAT, selecione Copiar.
  
  Atenção
  Você não poderá ver ou copiar seu PAT novamente depois de fechar a caixa de diálogo.
Adicione um perfil contendo seu repositório ao arquivo settings.xml. Substitua os valores a seguir.

nota
Se estiver copiando as instruções do console, os valores a seguir devem ser atualizados para você e não devem ser alterados.
- Substitua space_name pelo nome do espaço do CodeCatalyst.
- Substitua proj_name pelo nome do projeto do CodeCatalyst.
- Substitua repo_name pelo nome do seu repositório de pacotes do CodeCatalyst.
```
<profiles>
  <profile>
    <id>repo_name</id>
    <activation>
        <activeByDefault>true</activeByDefault>
    </activation>
    <repositories>
        <repository>
          <id>repo_name</id>
          <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url>
        </repository>
    </repositories>
  </profile>
</profiles>
```
Adicione seu servidor à lista de servidores no arquivo settings.xml. Substitua os valores a seguir.

nota
Se estiver copiando as instruções do console, os valores a seguir devem ser atualizados para você e não devem ser alterados.
- Substitua repo_name pelo nome do seu repositório de pacotes do CodeCatalyst.
- Substitua nome de usuário pelo seu nome de usuário do CodeCatalyst.
- Substitua o PAT pelo seu PAT do CodeCatalyst.
```
<servers>
  <server>
    <id>repo_name</id>
    <username>username</username>
    <password>PAT</password>
  </server>
</servers>
```
(Opcional) Defina um espelho no arquivo settings.xml que capture todas as conexões e as encaminhe para seu repositório em vez de um repositório de gateway.

nota
Se estiver copiando as instruções do console, os valores a seguir devem ser atualizados para você e não devem ser alterados.
- Substitua space_name pelo nome do espaço do CodeCatalyst.
- Substitua proj_name pelo nome do projeto do CodeCatalyst.
- Substitua repo_name pelo nome do seu repositório de pacotes do CodeCatalyst.
```
<mirrors>
  <mirror>
    <id>repo_name</id>
    <name>repo_name</name>
    <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url>
    <mirrorOf>*</mirrorOf>
  </mirror>
</mirrors>
```

Importante

Você pode usar qualquer valor no elemento <id>, mas ele deve ser o mesmo nos elementos <server> e <repository>. Isso permite que as credenciais especificadas sejam incluídas nas solicitações para o CodeCatalyst.

Depois de fazer essas alterações na configuração, você pode criar o projeto.


mvn compile

Busca de pacotes de repositórios de pacotes externos por meio do CodeCatalyst

Você pode instalar pacotes do Maven de repositórios públicos por meio de um repositório do CodeCatalyst configurando-o com uma conexão upstream com o gateway que representa o repositório do gateway. Os pacotes instalados no repositório de gateway são ingeridos e armazenados no repositório do CodeCatalyst.

Atualmente, o CodeCatalyst suporta os seguintes repositórios de pacotes públicos do Maven.

maven-central-gateway
google-android-gateway
gradle-plugins-gateway
commonsware-gateway

Para instalar pacotes de repositórios de pacotes públicos do Maven

Se você ainda não tiver feito isso, configure o mvn com seu repositório de pacotes do CodeCatalyst seguindo as etapas em Busca de dependências do CodeCatalyst.
Certifique-se de que seu repositório tenha adicionado o repositório de gateway a partir do qual você deseja instalar como uma conexão upstream. Para verificar quais fontes upstream foram adicionadas ou para adicionar um repositório de gateway como fonte upstream, siga as instruções em Adição de um repositório upstream.

Para ter mais informações sobre como solicitar pacotes de repositórios upstream, consulte Solicitar uma versão do pacote com repositórios upstream.

Publicar pacotes no CodeCatalyst

Para publicar um pacote do Maven com mvn em um repositório do CodeCatalyst, você também deve editar ~/.m2/settings.xml e o POM do projeto.

Para usar o `mvn` para publicar pacotes em um repositório de pacotes do CodeCatalyst

Abra o console do CodeCatalyst em https://codecatalyst.aws/.
Na página de visão geral do projeto, selecione Pacotes.
Escolha seu repositório de pacotes na lista de repositórios de pacotes.
Selecione Conectar ao repositório.
Na caixa de diálogo Conectar ao repositório, selecione mvn na lista de clientes do gerenciador de pacotes.
Você precisará de um token de acesso pessoal (PAT) para a autenticação do mvn com o CodeCatalyst. Se você já tiver um, pode usá-lo. Caso contrário, você pode criar um aqui.
1. Selecione Criar token.
2. Para copiar o PAT, selecione Copiar.
  
  Atenção
  Você não poderá ver ou copiar seu PAT novamente depois de fechar a caixa de diálogo.
Configure uma variável de ambiente na máquina local com seu PAT. Você usará essa variável de ambiente no arquivo setting.xml.
```
export CODECATALYST_ARTIFACTS_TOKEN=your_PAT
```

Adicione uma seção <servers> a settings.xml com uma referência à variável de ambiente CodeCatalyst_ARTIFACTS_TOKEN para que o Maven passe o token nas solicitações HTTP.


<settings>
...
    <servers>
        <server>
            <id>repo-name</id>
            <username>username</username>
            <password>${env.CodeCatalyst_ARTIFACTS_TOKEN}</password>
        </server>
    </servers>
...
</settings>

Adicione uma seção <distributionManagement> ao pom.xml do seu projeto.


<project>
...
     <distributionManagement>
         <repository>
             <id>repo_name</id>
             <name>repo_name</name>
             <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url>
         </repository>
     </distributionManagement>
...
</project>

Depois de fazer essas alterações na configuração, você pode criar o projeto e publicá-lo no repositório específico.


mvn deploy

Você pode navegar até o repositório do pacote no console do CodeCatalyst para verificar se o pacote foi publicado.

Publicação de pacotes de terceiros

Você pode publicar pacotes do Maven de terceiros em um repositório do CodeCatalyst com mvn deploy:deploy-file. Isso pode ser útil para usuários que desejam publicar pacotes e têm somente arquivos JAR e não têm acesso ao código-fonte do pacote ou aos arquivos POM.

O comando mvn deploy:deploy-file gerará um arquivo POM com base nas informações passadas na linha de comando.

Primeiro, crie um PAT se você não tiver um.

Para criar um token de acesso pessoal (PAT)

Na barra de menu superior, escolha seu selo de perfil e escolha Minhas configurações.

dica
Você também pode encontrar seu perfil de usuário acessando a página de membros de um projeto ou espaço e escolhendo seu nome na lista de membros.
Em Nome do PAT, insira um nome descritivo para o seu PAT.
Em Data de expiração, mantenha a data padrão ou escolha o ícone do calendário para selecionar uma data personalizada. A data de vencimento é padronizada para um ano a contar da data atual.
Escolha Criar.

Você também pode criar esse token ao escolher Clonar repositório para um repositório de origem.
Salve o segredo do PAT em um local seguro.

Importante
O segredo do PAT só é exibido uma vez. Não é possível recuperá-lo depois de fechar a janela.

Publicação de pacotes do Maven de terceiros

Crie um arquivo ~/.m2/settings.xml com o seguinte conteúdo:



<settings>
    <servers>
        <server>
            <id>repo_name</id>
            <username>username</username>
            <password>PAT}</password>
        </server>
    </servers>
</settings>

Execute o comando mvn deploy:deploy-file:


mvn deploy:deploy-file -DgroupId=commons-cli          \
-DartifactId=commons-cli       \
-Dversion=1.4                  \
-Dfile=./commons-cli-1.4.jar   \
-Dpackaging=jar                \
-DrepositoryId=repo-name      \
-Durl=https://packages.region.codecatalyst.aws/maven/space-name/proj-name/repo-name/

nota

O exemplo anterior publica commons-cli 1.4. Modifique os argumentos groupID, artifactID, version e file para publicar um JAR diferente.

Essas instruções têm como base os exemplos no Guia para implantação de JARs de terceiros em repositórios remotos da documentação do Apache Maven.

Para ter mais informações, consulte esses tópicos no site do Apache Maven Project:

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Configuração e uso do Gradle Groovy

Publicação de pacotes com curl

Configuração e uso de mvn

Sumário

Busca de dependências do CodeCatalyst

Para usar o mvn para buscar dependências no repositório de pacotes do CodeCatalyst

Atenção

nota

nota

nota

Importante

Busca de pacotes de repositórios de pacotes externos por meio do CodeCatalyst

Para instalar pacotes de repositórios de pacotes públicos do Maven

Publicar pacotes no CodeCatalyst

Para usar o mvn para publicar pacotes em um repositório de pacotes do CodeCatalyst

Atenção

Publicação de pacotes de terceiros

Para criar um token de acesso pessoal (PAT)

dica

Importante

Publicação de pacotes do Maven de terceiros

nota

Para usar o `mvn` para buscar dependências no repositório de pacotes do CodeCatalyst

Para usar o `mvn` para publicar pacotes em um repositório de pacotes do CodeCatalyst