Objetivo
Orientar a preparacao de APIs e workers .NET deste repositorio para execucao em Cloud Run, sem executar deploy real automaticamente.
Quando usar
- Planejar ou revisar deploy de
LedgerService.Api, BalanceService.Api, workers ou jobs em Cloud Run.
- Ajustar Dockerfile, configuracao de porta, health/readiness, variaveis de ambiente, secrets ou service account para Cloud Run.
- Avaliar se um componente deve ser Cloud Run service, job, worker pool ou GKE.
- Documentar estrategia de deploy, escalabilidade, logs, metricas, custos ou limites.
Quando nao usar
- Rodar stack local Docker Compose sem relacao com Cloud Run.
- Criar Cloud SQL, IAM ou rede como foco principal. Combine com as skills GCP correspondentes.
- Executar deploy real sem pedido explicito.
Mapeamento inicial da POC
- APIs HTTP tendem a mapear para Cloud Run services.
- Workers Kafka exigem avaliacao cuidadosa: worker pool, job, GKE ou alternativa gerenciada dependem do modelo de mensageria escolhido.
- PostgreSQL local deve ser substituido por Cloud SQL ou por outro servico explicitamente decidido.
- Imagens devem ficar preferencialmente em Artifact Registry.
- Segredos devem vir de Secret Manager ou mecanismo equivalente, nunca de arquivo versionado.
Regras de decisao
Nao introduza health/readiness, portas HTTP, endpoints auxiliares, sidecars ou novos recursos de Cloud Run apenas por checklist.
Antes de propor mudanca operacional, classifique se ela e:
- exigida pela plataforma;
- util, mas opcional;
- valida apenas em producao;
- desnecessaria para a POC;
- potencialmente prejudicial pelo custo, complexidade ou carga operacional.
Para workers e jobs, nao introduza endpoints HTTP de health/readiness por padrao. Avalie primeiro se o ambiente de execucao exige probes HTTP ou se metricas, logs, exit code, retry policy e alertas cobrem melhor a saude operacional.
Se endpoints forem realmente necessarios, mantenha-os leves e baseados em estado interno do processo. Evite readiness que consulte banco pesado, fila, DLQ ou views de grande volume em tempo real.
Passos
- Leia
README.md, docs/architecture/, docs/observability.md, Dockerfiles, Compose e ADRs relacionadas.
- Classifique cada workload como service, worker pool, job ou fora de Cloud Run.
- Confirme compatibilidade do container com porta dinamica, startup, shutdown e sinais de encerramento.
- Para APIs HTTP, preserve health/readiness ja existentes quando fizerem sentido para a plataforma.
- Para workers e jobs, avalie se health/readiness HTTP e realmente necessario ou se observabilidade por metricas e alertas e mais adequada.
- Modele variaveis por ambiente sem versionar secrets.
- Defina service account dedicada por workload com menor privilegio.
- Avalie conectividade com Cloud SQL, Kafka/Pub/Sub, Keycloak/OIDC e observabilidade.
- Defina limites de CPU, memoria, concorrencia, timeout e escala conforme o perfil do workload.
- Atualize documentacao e ADR quando a decisao afetar estrategia de deploy, operacao, conectividade, observabilidade, seguranca ou custo.
1---2name: gcp-cloud-run-deployment3description: Use esta skill para desenhar, revisar ou documentar deploy de APIs, workers e jobs em Cloud Run para esta POC .NET. Cobre container, porta, variaveis, secrets, service account, escalabilidade, health, logs, Cloud SQL e limites operacionais.4---56# Objetivo78Orientar a preparacao de APIs e workers .NET deste repositorio para execucao em Cloud Run, sem executar deploy real automaticamente.910# Quando usar1112- Planejar ou revisar deploy de `LedgerService.Api`, `BalanceService.Api`, workers ou jobs em Cloud Run.13- Ajustar Dockerfile, configuracao de porta, health/readiness, variaveis de ambiente, secrets ou service account para Cloud Run.14- Avaliar se um componente deve ser Cloud Run service, job, worker pool ou GKE.15- Documentar estrategia de deploy, escalabilidade, logs, metricas, custos ou limites.1617# Quando nao usar1819- Rodar stack local Docker Compose sem relacao com Cloud Run.20- Criar Cloud SQL, IAM ou rede como foco principal. Combine com as skills GCP correspondentes.21- Executar deploy real sem pedido explicito.2223# Mapeamento inicial da POC2425- APIs HTTP tendem a mapear para Cloud Run services.26- Workers Kafka exigem avaliacao cuidadosa: worker pool, job, GKE ou alternativa gerenciada dependem do modelo de mensageria escolhido.27- PostgreSQL local deve ser substituido por Cloud SQL ou por outro servico explicitamente decidido.28- Imagens devem ficar preferencialmente em Artifact Registry.29- Segredos devem vir de Secret Manager ou mecanismo equivalente, nunca de arquivo versionado.3031# Regras de decisao3233Nao introduza health/readiness, portas HTTP, endpoints auxiliares, sidecars ou novos recursos de Cloud Run apenas por checklist.3435Antes de propor mudanca operacional, classifique se ela e:36371. exigida pela plataforma;382. util, mas opcional;393. valida apenas em producao;404. desnecessaria para a POC;415. potencialmente prejudicial pelo custo, complexidade ou carga operacional.4243Para workers e jobs, nao introduza endpoints HTTP de health/readiness por padrao. Avalie primeiro se o ambiente de execucao exige probes HTTP ou se metricas, logs, exit code, retry policy e alertas cobrem melhor a saude operacional.4445Se endpoints forem realmente necessarios, mantenha-os leves e baseados em estado interno do processo. Evite readiness que consulte banco pesado, fila, DLQ ou views de grande volume em tempo real.4647# Passos48491. Leia `README.md`, `docs/architecture/`, `docs/observability.md`, Dockerfiles, Compose e ADRs relacionadas.502. Classifique cada workload como service, worker pool, job ou fora de Cloud Run.513. Confirme compatibilidade do container com porta dinamica, startup, shutdown e sinais de encerramento.524. Para APIs HTTP, preserve health/readiness ja existentes quando fizerem sentido para a plataforma.535. Para workers e jobs, avalie se health/readiness HTTP e realmente necessario ou se observabilidade por metricas e alertas e mais adequada.546. Modele variaveis por ambiente sem versionar secrets.557. Defina service account dedicada por workload com menor privilegio.568. Avalie conectividade com Cloud SQL, Kafka/Pub/Sub, Keycloak/OIDC e observabilidade.579. Defina limites de CPU, memoria, concorrencia, timeout e escala conforme o perfil do workload.5810. Atualize documentacao e ADR quando a decisao afetar estrategia de deploy, operacao, conectividade, observabilidade, seguranca ou custo.
rodri-oliveira-dev