Tutorial: extrair de um repositório de pacotes

Abra o console do CodeCatalyst em https://codecatalyst.aws/.

Navegue até o projeto, codecatalyst-package-project.

No painel de navegação, selecione Código e, depois, selecione Repositórios de origem.

Escolha Adicionar repositório e selecione Criar repositório.

Em Nome do repositório, insira:

hello-world-app

Escolha Criar.

No painel de navegação, selecione Packages (pacotes).

Escolha Criar repositório de pacotes.

Em Nome do repositório, insira:

codecatalyst-package-repository

Escolha + Selecionar repositórios upstream.

Escolha Repositórios de gateway.

Na caixa npm-public-registry-gateway, selecione Criar.

Escolha Selecionar.

Escolha Criar.

O CodeCatalyst cria um repositório de pacotes chamado codecatalyst-package-repository que está conectado a um repositório de gateway. O repositório de gateway está conectado ao registro npmjs.com.

No painel de navegação, escolha Código e Ambientes de Desenvolvimento.

Na parte superior, escolha Criar ambiente de desenvolvimento e AWS Cloud9 (no navegador).

Verifique se Repositório está definido como hello-world-app e Ramificação existente está definido como main. Escolha Criar.

O Ambiente de Desenvolvimento é iniciado em uma nova guia do navegador e seu repositório (hello-world-app) é clonado nela.

Deixe as duas guias do navegador do CodeCatalyst abertas e vá para o próximo procedimento.

Acesse o Ambiente de Desenvolvimento.

No prompt do terminal, mude para o diretório raiz do repositório de origem hello-world-app:

cd hello-world-app

Inicialize um projeto Node.js:

npm init -y

A inicialização cria um arquivo package.json no diretório raiz do hello-world-app.

Conecte o cliente npm no Ambiente de Desenvolvimento ao repositório de pacotes do CodeCatalyst:

Importe a versão 4.17.20 de lodash:

npm install lodash@v4.17.20 --save --save-exact

O npm procura a versão 4.17.20 de lodash nos seguintes locais, na seguinte ordem:

O npm importa lodash para o repositório de gateway, o repositório de pacotes do CodeCatalyst e o Ambiente de Desenvolvimento.

O npm também atualiza seu arquivo package.json com a dependência lodash e cria um diretório node_modules contendo lodash e todas as dependências.

Teste se lodash foi importado para seu Ambiente de Desenvolvimento. Insira:

npm list

A mensagem a seguir é exibida, indicando uma importação bem-sucedida:

`-- lodash@4.17.20

(Opcional) Abra hello-world-app/package.json e verifique se as linhas em negrito vermelho foram adicionadas:

{
  "name": "hello-world-app",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  dependencies": {
    "lodash": "4.17.20"
  }
}

Em /hello-world-app, crie um arquivo chamado index.js com o conteúdo a seguir:

// Importing lodash library
const _ = require('lodash');

// Input string
const inputString = 'hello-world';

// Transforming the string using lodash
const transformedString = _.startCase(inputString.replace('-', ' '));

// Outputting the transformed string to the console
console.log(transformedString);

Mude para o console do CodeCatalyst.

No painel de navegação, selecione Packages (pacotes).

Selecione npm-public-registry-gateway.

Certifique-se de que lodash seja exibido. A coluna Versão mais recente indica 4.17.20.

Repita esse procedimento para o codecatalyst-package-repository. Talvez seja necessário atualizar a janela do navegador para ver o pacote importado.

Mude para o Ambiente de Desenvolvimento.

Verifique se você ainda está no diretório hello-world-app e execute a aplicação:

node index.js

Uma mensagem Hello World é exibida. O Node.js executou a aplicação usando o pacote lodash que você baixou para o Ambiente de Desenvolvimento em uma etapa anterior.

Ignore o diretório node_modules. Insira:

echo "node_modules/" >> .gitignore

É uma prática recomendada evitar confirmar esse diretório. Além disso, a confirmação desse diretório interferirá nas etapas posteriores neste tutorial.

Adicione, confirme e envie:

git add .
git commit -m "add the Hello World application"
git push

Os arquivos da aplicação e do projeto “Hello World” são adicionados ao repositório de origem.

Mude para o console do CodeCatalyst.

No painel de navegação, escolha CI/CD e Fluxos de trabalho.

Selecione Criar fluxo de trabalho.

Em Repositório de origem, selecione hello-world-app.

Em Ramificação, selecione main.

O arquivo de definição do fluxo de trabalho será criado no repositório de origem e na ramificação escolhidos.

Escolha Criar.

Selecione YAML na parte superior.

Exclua o código de amostra YAML.

Adicione o seguinte código YAML:

Name: codecatalyst-package-workflow
SchemaVersion: "1.0"

# Required - Define action configurations.
Actions:
  RunHelloWorldApp:
    # Identifies the action. Do not modify this value.
    Identifier: aws/build@v1
    Compute:
      Type: Lambda
    Inputs:
      Sources:
        - WorkflowSource # This specifies your source repository. 
    Configuration:
      Steps:
        - Run: npm install
        - Run: npm list
        - Run: node index.js
      Container: # This specifies the Docker image that runs the action.
        Registry: CODECATALYST
        Image: CodeCatalystLinuxLambda_x86_64:2024_03
    Packages:
      NpmConfiguration:
        PackageRegistries:
          - PackagesRepository: codecatalyst-package-repository

No código anterior, substitua codecatalyst-package-repository pelo nome do repositório de pacotes do CodeCatalyst que você criou em Etapa 2: criar os repositórios de pacotes do CodeCatalyst e do gateway.

Para ter informações sobre as propriedades nesse arquivo, consulte a Ações de criação e de teste YAML.

(Opcional) Selecione Validar para garantir que o código YAML seja válido antes de confirmar.

Escolha Commit (Confirmar).

Na caixa de diálogo Confirmar fluxo de trabalho, insira o seguinte:

1. Em Nome do arquivo do fluxo de trabalho, mantenha o padrão, codecatalyst-package-workflow.

2. Em Confirmar mensagem, insira:

   add initial workflow file

3. Em Repositório, selecione hello-world-app.

4. Em Nome da ramificação, selecione principal.

5. Escolha Commit (Confirmar).

Agora você criou um fluxo de trabalho.

Ao lado do fluxo de trabalho que você acabou de criar (codecatalyst-package-workflow), selecione Ações e, depois, selecione Executar.

A execução do fluxo de trabalho é iniciada.

Na notificação verde na parte superior, à direita, escolha o link para a execução. O link é semelhante a View Run-1234.

Um diagrama do fluxo de trabalho é exibido, mostrando quem iniciou a execução e a ação RunHelloWorldApp.

Escolha a caixa RunHelloWorldApp para observar o progresso da ação.

Quando a execução terminar, vá para Etapa 5: verificar o fluxo de trabalho.

No diagrama do fluxo de trabalho, escolha a caixa RunHelloWorldApp.

Uma lista de mensagens de log é exibida.

Expanda a mensagem de log node index.js.

A seguinte mensagem é exibida:

[Container] 2024/04/24 21:15:41.545650 Running command node index.js
Hello World

A aparência de Hello Word (em vez de hello-world) indica que a dependência lodash foi usada.

Expanda o log npm list.

Uma mensagem semelhante à seguinte é exibida:

└── lodash@4.17.20

Essa mensagem indica que a versão 4.17.20 de lodash foi baixada para a imagem do Docker que executa a ação do fluxo de trabalho.

No painel de navegação, selecione Packages (pacotes).

Selecione npm-publish-registry-gateway.

Selecione lodash.

Na parte superior, selecione Controles de origem.

Em Upstream, selecione Bloquear.

Escolha Salvar.

Agora você bloqueou as importações para seu repositório de gateway (e repositórios e computadores downstream) em npmjs.com.

Mude para o Ambiente de Desenvolvimento.

Extraia o arquivo codecatalyst-package-workflow.yaml que você criou usando o console do CodeCatalyst anteriormente:

git pull

Abra o /hello-world-app/package.json.

Altere a versão de lodash para 4.17.21 conforme mostrado em negrito vermelho:

{
  "name": "hello-world-app",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "dependencies": {
    "lodash": "4.17.21"
  }
}

Agora há uma incompatibilidade entre a versão no arquivo package.json (4.17.21) e a versão nos repositórios de pacotes do gateway e do CodeCatalyst (4.17.20).

Adicione, confirme e envie:

git add .
git commit -m "update package.json to use lodash 4.17.21"
git push

Execute o fluxo de trabalho com a incompatibilidade de versão:

Verifique se o fluxo de trabalho falhou:

No painel de navegação, selecione Packages (pacotes).

Selecione npm-publish-registry-gateway.

Selecione lodash.

Na parte superior, selecione Controles de origem.

Em Upstream, selecione Permitir.

Escolha Salvar.

Agora você desbloqueou as importações de lodash.

Seu fluxo de trabalho agora pode importar a versão 4.17.21 de lodash.

Execute o fluxo de trabalho novamente. Desta vez, o fluxo de trabalho deve ser bem-sucedido porque a importação de 4.17.21 agora deve funcionar. Para executar o fluxo de trabalho novamente:

Verifique se a versão 4.17.21 foi importada para seus repositórios do CodeCatalyst e de gateway:

Exclua o codecatalyst-package-project:

1. No console do CodeCatalyst, navegue até o projeto codecatalyst-package-project se você ainda não estiver lá.

2. No painel de navegação, escolha Configurações do projeto.

3. Selecione Excluir projeto, insira delete e selecione Excluir projeto.

   O CodeCatalyst exclui todos os recursos do projeto, incluindo os repositórios de origem, gateway e pacotes do CodeCatalyst. O Ambiente de Desenvolvimento também é excluído.

Exclua o token PAT:

1. Escolha seu nome de usuário à direita e selecione Minhas configurações.

2. Em Tokens de acesso pessoal, escolha o token que você criou neste tutorial e selecione Excluir.