Buscando dependências de CodeCatalyst Buscando pacotes de repositórios de pacotes externos por meio de CodeCatalyst Publicando pacotes em CodeCatalyst Publicação de pacotes de terceiros

Configurando e usando mvn

Você usa o mvn comando 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

Buscando dependências de CodeCatalyst

Para configurar mvn para buscar dependências de um CodeCatalyst repositório, você deve editar o arquivo de configuração do Maven settings.xml e, opcionalmente, o arquivo Project Model Object () do seu projeto. POM O POM arquivo 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 compilação, diretório de origem, diretório de origem de teste, plug-in e metas.

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

Abra o CodeCatalyst console em https://codecatalyst.aws/.
Na página de visão geral do seu projeto, escolha Pacotes.
Escolha seu repositório de pacotes na lista de repositórios de pacotes.
Escolha Conectar ao repositório.
Na caixa de diálogo Conectar ao repositório, escolha mvn na lista de clientes do gerenciador de pacotes.
Você precisará de um token de acesso pessoal (PAT) para se mvn autenticar CodeCatalyst. Se você já tem um, pode usá-lo. Caso contrário, você pode criar um aqui.
1. Escolha Criar token.
2. Escolha Copiar para copiar seuPAT.
  
  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 seu settings.xml arquivo. 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.
- Substituir space_name com o nome CodeCatalyst do seu espaço.
- Substituir proj_name com o nome CodeCatalyst do seu projeto.
- Substituir repo_name com o nome CodeCatalyst do repositório do pacote.
```
<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 em seu settings.xml arquivo. 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.
- Substituir repo_name com o nome CodeCatalyst do repositório do pacote.
- Substituir username com seu nome CodeCatalyst de usuário.
- Substituir PAT com o seu CodeCatalystPAT.
```
<servers>
  <server>
    <id>repo_name</id>
    <username>username</username>
    <password>PAT</password>
  </server>
</servers>
```
(Opcional) Defina um espelho em seu settings.xml arquivo 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.
- Substituir space_name com o nome CodeCatalyst do seu espaço.
- Substituir proj_name com o nome CodeCatalyst do seu projeto.
- Substituir repo_name com o nome CodeCatalyst do repositório do pacote.
```
<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 CodeCatalyst.

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


mvn compile

Buscando pacotes de repositórios de pacotes externos por meio de CodeCatalyst

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

Atualmente, CodeCatalyst oferece suporte aos seguintes repositórios públicos de pacotes Maven.

maven-central-gateway
google-android-gateway
gradle-plugins-gateway
gateway de software comum

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

Se você ainda não o fez, configure mvn com seu repositório de CodeCatalyst pacotes seguindo as etapas emBuscando dependências de 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. Adicionar um repositório upstream

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

Publicando pacotes em CodeCatalyst

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

Para usar `mvn` para publicar pacotes em seu repositório de CodeCatalyst pacotes

Abra o CodeCatalyst console em https://codecatalyst.aws/.
Na página de visão geral do seu projeto, escolha Pacotes.
Escolha seu repositório de pacotes na lista de repositórios de pacotes.
Escolha Conectar ao repositório.
Na caixa de diálogo Conectar ao repositório, escolha mvn na lista de clientes do gerenciador de pacotes.
Você precisará de um token de acesso pessoal (PAT) para se mvn autenticar CodeCatalyst. Se você já tem um, pode usá-lo. Caso contrário, você pode criar um aqui.
1. Escolha Criar token.
2. Escolha Copiar para copiar seuPAT.
  
  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 em sua máquina local com seuPAT. Você usará essa variável de ambiente em seu setting.xml arquivo.
```
export CODECATALYST_ARTIFACTS_TOKEN=your_PAT
```

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


<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 de pacotes no CodeCatalyst console para verificar se o pacote foi publicado com sucesso.

Publicação de pacotes de terceiros

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

O mvn deploy:deploy-file comando gerará um POM arquivo 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 PATnome, insira um nome descritivo para seuPAT.
Em Data de expiração, deixe a data padrão ou escolha o ícone do calendário para selecionar uma data personalizada. A data de expiração é padronizada para um ano a partir 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 PAT segredo em um local seguro.

Importante
O PAT segredo só é exibido uma vez. Você não pode recuperá-lo depois de fechar a janela.

Para publicar pacotes 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 publicacommons-cli 1.4. Modifique os argumentosgroupId, artifactID, version e file para publicar um diferente. JAR

Essas instruções são baseadas em exemplos no Guia para implantação de terceiros JARs em repositórios remotos da documentação do Apache Maven.

Para obter mais informações, consulte estes tópicos no site do Projeto Apache Maven:

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

Configurando e usando o Gradle Groovy

Publicando pacotes com curl

Configurando e usando mvn

Sumário

Buscando dependências de CodeCatalyst

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

Atenção

nota

nota

nota

Importante

Buscando pacotes de repositórios de pacotes externos por meio de CodeCatalyst

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

Publicando pacotes em CodeCatalyst

Para usar mvn para publicar pacotes em seu repositório de CodeCatalyst pacotes

Atenção

Publicação de pacotes de terceiros

Para criar um token de acesso pessoal (PAT)

dica

Importante

Para publicar pacotes Maven de terceiros

nota

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

Para usar `mvn` para publicar pacotes em seu repositório de CodeCatalyst pacotes