iGRPIGRP 3.0Documentation

Criar workspace

O workspace é a plataforma iGRP a correr no teu computador, em Docker, mais os teus projetos. Cria-o com o assistente do Studio em três passos.

Um workspace é uma pasta com a plataforma iGRP completa — autenticação, Access Management, Application Center, gateway, bases de dados, storage — descrita em Docker Compose, mais a pasta projects/ onde vão viver os teus projetos. O Studio gere-o por ti: cria-o, arranca os serviços e mostra o seu estado.

Quando aparece

No primeiro arranque, Enter Studio Workspace abre este assistente se ainda não tiveres nenhum workspace. Depois disso, cria outros pelo seletor de workspaces da barra lateral → Adicionar workspace (Cmd/Ctrl + N).

O assistente

Criar Novo Workspace

CampoO que é
NomeNome legível do workspace (por defeito My Workspace)
SlugIdentificador em minúsculas, dígitos e hífens — é também o hostname da plataforma local
DescriçãoOpcional
LocalizaçãoPasta onde o workspace é criado — tem de estar vazia; os ficheiros são escritos diretamente nela
Passo Criar Novo Workspace, com Nome, Slug, Descrição e Localização

Docker Orchestration

A stack principal é sempre incluída. Aqui escolhes as stacks opcionais:

Monitoring

Observabilidade: OpenTelemetry Collector, Prometheus, Loki, Tempo e Grafana.

Process

Process Management e Process Studio (API + UI) — necessária para processos BPMN.

Não precisas de decidir já: ambas podem ser acrescentadas depois, em Serviços → Docker → Add Stack.

Passo Docker Orchestration, com as stacks opcionais de monitoring e process

DNS & Platform Access

A plataforma responde em http://<slug>:<porta>. Acrescenta o slug ao ficheiro hosts do teu sistema (o assistente mostra o comando para copiar):

127.0.0.1  <slug>

Clica em Criar Workspace. Se o Docker estiver a correr, o Studio arranca logo a stack principal; se não, avisa e podes arrancá-la mais tarde.

Passo DNS & Platform Access, com a linha a acrescentar ao ficheiro hosts e os endereços da plataforma

O workspace abre no separador Projetos, ainda vazio:

Workspace recém-criado no separador Projetos, sem projetos

O que fica no disco

igrp-compose.yaml
.env
nginx.conf
Ficheiro / pastaPapel
igrp-compose.yaml + .envStack principal: nginx, PostgreSQL, Keycloak, Access Management, Application Center, gateway, Eureka, MinIO, Redis, pgAdmin
monitoring/, process/Stacks opcionais (só existem se as escolheste)
projects/Os teus projetos — ver Primeiro projeto
.igrpstudio/workspace.jsonIdentifica a pasta como workspace — é o que o Studio procura em Open Workspace

Cada workspace novo recebe uma porta HTTP própria (a partir de 2575), escrita no .env, para poderes ter vários lado a lado.

Próximo passo
Executar o workspace

Arrancar e parar os serviços e abrir a plataforma no browser.

How is this guide?

Última atualização: