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

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

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 (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 `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 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 se autenticar. mvn 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.
- space_nameSubstitua pelo nome do seu CodeCatalyst espaço.
- proj_nameSubstitua pelo nome CodeCatalyst do seu projeto.
- repo_nameSubstitua pelo 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 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.
- repo_nameSubstitua pelo nome CodeCatalyst do repositório do pacote.
- usernameSubstitua CodeCatalyst pelo seu nome de usuário.
- PATSubstitua por seu CodeCatalyst PAT.
```
<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.
- space_nameSubstitua pelo nome do seu CodeCatalyst espaço.
- proj_nameSubstitua pelo nome CodeCatalyst do seu projeto.
- repo_nameSubstitua pelo 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
commonsware-gateway

Para instalar pacotes de repositórios de pacotes públicos do 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 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.

Publicando pacotes em CodeCatalyst

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

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 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 se autenticar. mvn 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 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 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 são baseadas em exemplos no Guia para implantação de terceiros JARs 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

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 de pacotes públicos do 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

Publicação de pacotes do 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