Skip to content

README.pt_BR.md

Latest commit

 

History

History
145 lines (109 loc) · 4.81 KB

README.pt_BR.md

File metadata and controls

145 lines (109 loc) · 4.81 KB

Asset Manager

Este documento serve como um guia abrangente de workshop que irá orientá-lo no processo de modernização de uma aplicação Java usando o GitHub Copilot app modernization. O workshop abrange avaliação, atualizações de Java/frameworks, endpoints de saúde e conteinerização.

O que o Processo de Modernização Fará: A modernização transformará sua aplicação das tecnologias desatualizadas para uma solução moderna. Isso inclui a atualização do Java 8 para o Java 21, a migração do Spring Boot 2.x para o 3.x, a adição de health checks e a conteinerização das aplicações.

Índice

Visão Geral

O branch main do projeto asset-manager é o estado original antes de ser modernizado. Ele está organizado da seguinte forma:

  • AWS S3 para armazenamento de imagens, usando autenticação baseada em senha (access key/secret key)
  • RabbitMQ para filas de mensagens, usando autenticação baseada em senha
  • Banco de dados PostgreSQL para armazenamento de metadados, usando autenticação baseada em senha

Neste workshop, você usará a extensão GitHub Copilot app modernization para avaliar, atualizar e conteinerizar o projeto.

Estimativas de Tempo: O workshop completo leva aproximadamente 35 minutos para ser concluído. Aqui está a divisão para cada etapa principal:

  • Avaliar Sua Aplicação Java: ~5 minutos
  • Atualizar Runtime e Frameworks: ~10 minutos
  • Expor Endpoints de Saúde: ~15 minutos
  • Conteinerizar Aplicações: ~5 minutos

Arquitetura Atual

flowchart TD

%% Applications
WebApp[Web Application]
Worker[Worker Service]

%% Storage Components
S3[(AWS S3)]
LocalFS[("Local File System<br/>dev only")]

%% Message Broker
RabbitMQ(RabbitMQ)

%% Database
PostgreSQL[(PostgreSQL)]

%% Queues
Queue[image-processing queue]
RetryQueue[image-processing.retry queue]

%% User
User([User])

%% User Flow
User -->|Upload Image| WebApp
User -->|View Images| WebApp

%% Web App Flows
WebApp -->|Store Original Image| S3
WebApp -->|Store Original Image| LocalFS
WebApp -->|Send Processing Message| RabbitMQ
WebApp -->|Store Metadata| PostgreSQL
WebApp -->|Retrieve Images| S3
WebApp -->|Retrieve Images| LocalFS
WebApp -->|Retrieve Metadata| PostgreSQL

%% RabbitMQ Flow
RabbitMQ -->|Push Message| Queue
Queue -->|Processing Failed| RetryQueue
RetryQueue -->|After 1 min delay| Queue
Queue -->|Consume Message| Worker

%% Worker Flow
Worker -->|Download Original| S3
Worker -->|Download Original| LocalFS
Worker -->|Upload Thumbnail| S3
Worker -->|Upload Thumbnail| LocalFS
Worker -->|Store Metadata| PostgreSQL
Worker -->|Retrieve Metadata| PostgreSQL

%% Styling
classDef app fill:#90caf9,stroke:#0d47a1,color:#0d47a1
classDef storage fill:#a5d6a7,stroke:#1b5e20,color:#1b5e20
classDef broker fill:#ffcc80,stroke:#e65100,color:#e65100
classDef db fill:#ce93d8,stroke:#4a148c,color:#4a148c
classDef queue fill:#fff59d,stroke:#f57f17,color:#f57f17
classDef user fill:#ef9a9a,stroke:#b71c1c,color:#b71c1c

class WebApp,Worker app
class S3,LocalFS storage
class RabbitMQ broker
class PostgreSQL db
class Queue,RetryQueue queue
class User user
Loading

Autenticação baseada em senha

Executar Localmente

Clone o repositório e abra a pasta asset-manager para executar o projeto atual localmente:

git clone https://github.com/copilot-dev-days/appmod-workshop-java.git
cd appmod-workshop-java

Pré-requisitos:

  • JDK 8: Necessário para executar a aplicação inicial localmente.
  • Maven 3.6.0+: Necessário para compilar a aplicação localmente.
  • Docker: Necessário para executar a aplicação localmente.

Execute os seguintes comandos para iniciar as aplicações localmente. Isso irá:

  • Usar o sistema de arquivos local em vez do S3 para armazenar imagens
  • Iniciar o RabbitMQ e o PostgreSQL usando Docker

Windows:

scripts\startapp.cmd

Linux:

scripts/startapp.sh

Para parar, execute stopapp.cmd ou stopapp.sh no diretório scripts.

Workshop de Modernização de Aplicações

Pronto para modernizar esta aplicação? Siga o guia passo a passo do workshop:

👉 Iniciar o Workshop →

O workshop abrange:

  • Instalação do GitHub Copilot app modernization
  • Avaliação da sua aplicação Java
  • Atualização de runtime e frameworks (Java 8 → 21, Spring Boot 2.x → 3.x)
  • Exposição de endpoints de saúde usando custom skills
  • Conteinerização de aplicações