Integrasi

Hubungkan Architecto dengan alat dan platform pilihan Anda

Architecto terintegrasi dengan alat yang sudah digunakan tim.

Kontrol versi

GitHub

Impor repositori dan buat arsitektur ketika kode berubah.

Pengaturan:

  1. Integrasi → GitHub.
  2. Klik Hubungkan GitHub.
  3. Izinkan Architecto mengakses repositori.
  4. Pilih repositori tertentu atau semua.

Penggunaan:

  • Impor Terraform sebagai diagram.
  • Perbarui arsitektur saat IaC berubah.
  • Buat dari kode repositori.
  • Tautkan diagram ke permintaan perubahan.

Tindakan:

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

GitLab

Serupa dengan GitHub (segera hadir).

  • Impor repositori GitLab.
  • Integrasi pipeline GitLab CI/CD.
  • Sinkronkan diagram ke permintaan penggabungan.

Infrastruktur sebagai kode

Terraform

Uraikan Terraform dan buat diagram.

Cara kerja:

  1. Unggah berkas .tf atau hubungkan GitHub.
  2. Architecto mengurai sumber daya penyedia.
  3. Membuat topologi dari definisi.
  4. Membuat simpul tiap sumber daya.
  5. Menghubungkan sesuai dependensi.

Contoh: unggah berkas ini:

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"
}

Menghasilkan VPC → penyeimbang beban → instans EC2 → RDS.

CloudFormation

Impor templat AWS CloudFormation.

  • Uraikan YAML/JSON.
  • Buat topologi dari stack.
  • Mendukung semua sumber daya AWS.

Bicep

Bahasa infrastruktur Azure (segera hadir).

CDK: infrastruktur sebagai kode

Dukungan AWS CDK (segera hadir).

Platform kolaborasi

Discord

Bagikan arsitektur dan terima notifikasi.

Pengaturan:

  1. Integrasi → Discord.
  2. Klik Tambahkan ke Discord.
  3. Pilih ruang kerja dan izinkan.
  4. Pilih kanal notifikasi.

Fitur:

  • Bagikan arsitektur ke kanal.
  • Notifikasi untuk:
    • Arsitektur yang dibagikan kepada Anda.
    • Komentar pada diagram bersama.
    • Undangan tim.
  • Cari arsitektur dalam Discord.
  • Pratinjau tautan arsitektur.

Contoh:

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

Jira

Tautkan arsitektur ke isu dan buat tiket dari temuan.

Pengaturan:

  1. Integrasi → Jira.
  2. Masukkan ID Jira Cloud.
  3. Buat lalu tempel token API.

Fitur:

  • Tautkan ke epic dan cerita Jira.
  • Tiket untuk:
    • Optimasi biaya.
    • Skalabilitas.
    • Mitigasi keamanan.
    • Masalah kepatuhan.
  • Lampirkan diagram ke Jira.
  • Perbarui status dari Architecto.

Komunikasi

Email

Kirim arsitektur dan laporan melalui email.

  • Berbagi dengan orang di luar tim.
  • Kirim laporan analisis.
  • Jadwalkan ringkasan arsitektur baru.
  • Ekspor dan lampirkan.

Teams (segera hadir)

Integrasi Microsoft Teams.

  • Berbagi ke kanal.
  • Terima notifikasi.
  • Sematkan diagram dalam chat.

Analitik dan pemantauan

Datadog (segera hadir)

Pantau penerapan arsitektur.

New Relic (segera hadir)

Lacak metrik kinerja.

Grafana (segera hadir)

Visualisasikan metrik dan log.

Penyedia cloud

AWS

Integrasi AWS bawaan, sudah tersedia.

  • Ikon lebih dari 200 layanan.
  • Integrasi harga.
  • VPC dan grup keamanan.

Google Cloud Platform

Integrasi GCP, sudah tersedia.

  • Ikon layanan.
  • Data harga.
  • VPC.

Microsoft Azure

Integrasi Azure, sudah tersedia.

  • Ikon lebih dari 100 layanan.
  • Data harga.
  • Jaringan virtual.

Kubernetes

Kubernetes dan orkestrasi kontainer, sudah tersedia.

  • Ikon pod, penerapan, dan layanan.
  • Dukungan multikluster.
  • Visualisasi chart Helm, segera hadir.

Pengujian API

Postman

Uji API dan integrasi.

  • Koleksi Postman
  • Impor untuk menguji seluruh endpoint.
  • Autentikasi siap pakai.

AI dan otomatisasi (segera hadir)

GitHub Actions

Otomatiskan alur arsitektur.

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

Zapier

Hubungkan lebih dari 1000 aplikasi.

  • Picu tindakan dari peristiwa Zapier.
  • Kirim arsitektur ke aplikasi terhubung.

Integrasi khusus

Webhook

Bangun integrasi dengan webhook.

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

API

Bangun solusi dengan REST API.

Praktik pengaturan terbaik

  1. Hak minimum: hanya cakupan diperlukan.
  2. Rahasia aman: simpan kunci dalam variabel lingkungan.
  3. Uji dahulu: gunakan staging.
  4. Pantau: kondisi dan tingkat kesalahan.
  5. Dokumentasikan: perbarui dokumen tim.

Pemecahan masalah

Integrasi tidak ditemukan?

Integrasi tidak berfungsi?

  • Periksa kedaluwarsa kunci.
  • Pastikan URL webhook dapat diakses.
  • Periksa log kesalahan pada pengaturan.
  • Hubungi support@architecto.dev.

Langkah berikutnya:

Integrasi | Dokumentasi | Architecto