Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

Importar um projeto Compose — uma API de notas com PostgreSQL e Redis

Um ficheiro Compose que executa uma API, a base de dados PostgreSQL onde esta guarda as suas notas e uma cache Redis, convertido em rascunhos de ficheiros Aggrega por aggrega import — transpondo as ligações, as definições da base de dados, a palavra-passe como referência a uma variável e a tag de cada imagem — e compilado para Docker Compose.

Importar um projeto Compose percorre o processo passo a passo: o comando, os ficheiros que escreve e porque está lá cada linha, a compilação e a stack em execução. Esta pasta contém cada etapa desse guia:

pasta ou ficheiroo que contém
source/o projeto Compose, compose.yaml, o .aggrega-config.yaml que torna a pasta um espaço de trabalho, e import-answers.yaml, o único valor de que uma compilação para Kubernetes precisa e que nenhum ficheiro Compose contém
draft/os ficheiros que aggrega import compose.yaml --target compose escreveu, inalterados, incluindo release.lock, e o que imprimiu: stdout.txt na saída padrão, import.txt na saída de erro padrão

Num checkout do repositório da documentação, check.sh volta a executar a importação, compara o que esta escreve e imprime com draft/, compara os blocos que o guia cita com estes ficheiros, e valida e compila o que a importação escreveu. Precisa do catálogo da biblioteca padrão (onde obter um) num checkout ao lado deste repositório, ou do respetivo diretório indicado em AGGREGA_CATALOG_DIRS.

Gerar o exemplo

É possível executar a importação deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que a execute por si.

Escreva o exemplo numa nova pasta com o nome dele:

Terminal window
aggrega scaffold --example import-compose

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd import-compose

Compilação

A importação redige os rascunhos dos ficheiros Aggrega ao lado do projeto, em source/. Avalia o projeto face ao catálogo da biblioteca padrão, que o registry predefinido do espaço de trabalho publica como um instantâneo assinado: a primeira importação obtém-no, verifica-o, guarda-o na cache de conteúdo do espaço de trabalho e identifica-o pelo seu digest no registo que escreve ao lado dos rascunhos. Um espaço de trabalho que indica as suas próprias pastas de catálogo — em AGGREGA_CATALOG_DIRS, ou em workspace.catalog_dirs — importa antes face a essas. A importação obtém depois aquilo de que depende a Release redigida, pelo que a compilação segue de imediato:

Terminal window
cd source
aggrega import compose.yaml --target compose
aggrega build --release release.yaml

A compilação escreve dist/compose/docker-compose.yaml; a sua execução está descrita no guia indicado acima.

Com um assistente de IA

Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.

Utilize apenas as ferramentas do Aggrega e não crie nenhuma pasta por si. Se a pasta da área de trabalho ainda não contiver uma pasta `import-compose`, chame uma vez a ferramenta `scaffold` com `example` definido como `import-compose` e sem `dir`: esta escreve o exemplo numa nova pasta `import-compose`, cuja pasta `source` contém o que este exemplo importa. Em seguida, chame a ferramenta `import` com `workspace_root` definido como `import-compose/source`, `source` definido como `compose.yaml` e `target` definido como `compose`: esta lê as respostas de que precisa de `import-answers.yaml`, ao lado de `compose.yaml`, escreve os seus rascunhos em `import-compose/source` e obtém aquilo de que estes precisam. Em seguida, chame a ferramenta `validate` com `workspace_root` definido como `import-compose/source` e `release` definido como `release.yaml`, e a ferramenta `build` com `workspace_root` definido como `import-compose/source`, `release` definido como `release.yaml` e `write` definido como true. Indique-me que ficheiros o build escreveu; encontram-se em `import-compose/source/dist/`.

Testar

Com a stack em execução tal como o guia passo a passo a executa, e uma imagem que responde a HTTP na porta 8080 indicada para a API, consulte a API na porta que a Release publica:

Terminal window
curl -sS http://127.0.0.1:8080/notes

O substituto do guia passo a passo responde com uma descrição do pedido que recebeu:

{
"path": "/notes",
"headers": {
"host": "127.0.0.1:8080",
[… omitted: the user agent and the media types the client sent]
},
"method": "GET",
[… omitted: the rest of the request as the stand-in received it, the client's address and the container's host name]
}

Importada com --target helm e aplicada ao Kubernetes, como o guia passo a passo mostra, a API responde ao mesmo pedido no mesmo endereço assim que uma porta local é reencaminhada para o seu Service; aí ainda não recebe a palavra-passe da base de dados, uma vez que o Secret chega apenas à base de dados:

Terminal window
kubectl port-forward -n <namespace> svc/api-default 8080:8080