Integrações

Conecte o Architecto às ferramentas e plataformas que você usa

O Architecto se integra às ferramentas já usadas pela equipe.

Controle de versão

GitHub

Importe repositórios e gere arquiteturas quando o código mudar.

Configuração:

Acesse Integrações → GitHub.
Clique em Conectar GitHub.
Autorize o acesso do Architecto.
Escolha repositórios específicos ou todos.

Casos de uso:

Importar Terraform como diagramas.
Atualizar arquitetura com mudanças na IaC.
Criar arquiteturas a partir de código.
Vincular diagramas a solicitações de alteração.

Ações:

- Import Terraform from GitHub
- Watch for changes in .tf files
- Create PR comments with diagram preview
- Sync architecture to GitHub discussion

GitLab

Semelhante à integração GitHub (em breve).

Importação de repositórios.
Integração GitLab CI/CD.
Sincronização com solicitações de mesclagem.

Infraestrutura como código

Terraform

Interprete Terraform e gere diagramas.

Como funciona:

Envie um arquivo .tf ou conecte o GitHub.
O Architecto interpreta os recursos do provedor.
Gera a topologia pelas definições.
Cria nós para cada recurso.
Conecta pelas dependências.

Exemplo: ao enviar este arquivo:

resource "aws_vpc" "main" {
  cidr_block = "10.0.0.0/16"
}

resource "aws_lb" "main" {
  load_balancer_type = "application"
}

resource "aws_instance" "app" {
  instance_type = "t3.medium"
  count         = 3
}

resource "aws_rds_cluster" "db" {
  engine = "aurora-postgresql"
}

Gera: VPC → balanceador → instâncias EC2 → RDS.

CloudFormation

Importe modelos AWS CloudFormation.

Interpretação YAML/JSON.
Topologia a partir de pilhas.
Suporte a todos os recursos AWS.

Bicep

Linguagem de infraestrutura Azure (em breve).

CDK: infraestrutura como código

Suporte ao AWS CDK (em breve).

Plataformas de colaboração

Discord

Compartilhe arquiteturas e receba notificações.

Configuração:

Acesse Integrações → Discord.
Clique em Adicionar ao Discord.
Escolha o espaço e autorize.
Selecione o canal.

Recursos:

Compartilhe em canais Discord.
Receba avisos de:
- Arquiteturas compartilhadas com você.
- Comentários em diagramas.
- Convites de equipe.
Pesquise arquiteturas no Discord.
Veja prévias ao expandir links.

Exemplo:

/architecto share my-ecommerce-arch #team-architecture

Jira

Relacione arquiteturas a itens Jira e crie chamados com as constatações.

Configuração:

Acesse Integrações → Jira.
Informe o ID do Jira Cloud.
Gere e cole um token de API.

Recursos:

Vincule arquiteturas a épicos e histórias.
Crie chamados para:
- Otimização de custos.
- Escalabilidade.
- Mitigações de segurança.
- Problemas de conformidade.
Anexe diagramas ao Jira.
Atualize status pelo Architecto.

Comunicação

E-mail

Envie arquiteturas e relatórios por e-mail.

Compartilhe com pessoas fora da equipe.
Envie relatórios de análise.
Agende resumos de novas arquiteturas.
Exporte e anexe os resultados.

Teams (em breve)

Integração Microsoft Teams.

Compartilhe em canais.
Receba notificações.
Incorpore diagramas aos chats.

Análise e monitoramento

Datadog (em breve)

Monitore implantações de arquitetura.

New Relic (em breve)

Acompanhe métricas de desempenho.

Grafana (em breve)

Visualize métricas e logs.

Provedores de nuvem

AWS

Integração nativa AWS, já incluída.

Ícones para mais de 200 serviços.
Integração de preços.
Suporte a VPC e grupos de segurança.

Google Cloud Platform

Integração GCP, já incluída.

Ícones dos serviços.
Dados de preços.
Suporte a VPC.

Microsoft Azure

Integração Azure, já incluída.

Ícones de mais de 100 serviços.
Dados de preços.
Redes virtuais.

Kubernetes

Kubernetes e orquestração de contêineres, já incluídos.

Ícones de pods, implantações e serviços.
Suporte a vários clusters.
Visualização de charts Helm, em breve.

Testes de API

Postman

Teste APIs e integrações.

Coleção do Postman
Importe para testar todos os endpoints.
Autenticação pré-configurada.

IA e automação (em breve)

GitHub Actions

Automatize fluxos de arquitetura.

- name: Update Architecture
  uses: architecto/update-architecture@v1
  with:
    terraform-path: ./infrastructure
    api-key: ${{ secrets.ARCHITECTO_API_KEY }}

Zapier

Conecte mais de 1000 aplicativos.

Inicie ações com eventos Zapier.
Envie arquiteturas a qualquer app conectado.

Integrações personalizadas

Webhooks

Crie integrações próprias com webhooks.

POST /webhooks
{
  "url": "https://your-app.com/architecto-webhook",
  "events": ["architecture.created", "analysis.completed"]
}

API

Use a API REST para criar suas soluções.

Referência completa da API
SDKs Python, Node.js, Go, Ruby e Java.
Suporte a GraphQL, em breve.

Boas práticas de configuração

Privilégio mínimo: autorize apenas os escopos necessários.
Segredos seguros: guarde chaves em variáveis de ambiente.
Teste primeiro: use homologação.
Monitore: acompanhe integridade e taxas de erro.
Documente: mantenha a documentação atualizada.

Solução de problemas

Não encontra uma integração?

Consulte a página de integrações.
Solicite um recurso no GitHub.
Escreva para support@architecto.dev.

Não está funcionando?

Confira a validade da chave.
Verifique se a URL do webhook está acessível.
Consulte os logs de erro nas configurações.
Fale com support@architecto.dev.

Próximos passos:

Integrações

Nesta página