Penyepaduan

Hubungkan Architecto dengan alat dan platform pilihan anda

Architecto bersepadu dengan alat sedia digunakan pasukan.

Kawalan versi

GitHub

Import repositori dan jana seni bina apabila kod berubah.

Persediaan:

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

Kegunaan:

  • Import Terraform sebagai rajah.
  • Kemas kini seni bina apabila IaC berubah.
  • Cipta daripada kod repositori.
  • Pautkan rajah kepada 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 (akan datang).

  • Import repositori GitLab.
  • Penyepaduan saluran GitLab CI/CD.
  • Segerakkan kepada permintaan penggabungan.

Infrastruktur sebagai kod

Terraform

Huraikan Terraform dan jana rajah.

Cara berfungsi:

  1. Muat naik fail .tf atau hubungkan GitHub.
  2. Architecto menghuraikan sumber penyedia.
  3. Menjana topologi daripada takrif.
  4. Mencipta nod bagi setiap sumber.
  5. Menyambung mengikut kebergantungan.

Contoh: muat naik fail 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 → pengimbang beban → instans EC2 → RDS.

CloudFormation

Import templat AWS CloudFormation.

  • Huraikan YAML/JSON.
  • Jana topologi daripada tindanan.
  • Sokongan semua sumber AWS.

Bicep

Bahasa infrastruktur Azure (akan datang).

CDK: infrastruktur sebagai kod

Sokongan AWS CDK (akan datang).

Platform kerjasama

Discord

Kongsi seni bina dan terima pemberitahuan.

Persediaan:

  1. Penyepaduan → Discord.
  2. Klik Tambah kepada Discord.
  3. Pilih ruang kerja dan benarkan.
  4. Pilih saluran pemberitahuan.

Ciri:

  • Kongsi dalam saluran Discord.
  • Pemberitahuan tentang:
    • Seni bina dikongsi dengan anda.
    • Komen pada rajah bersama.
    • Jemputan pasukan.
  • Cari seni bina dalam Discord.
  • Pratonton pautan seni bina.

Contoh:

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

Jira

Pautkan seni bina kepada isu dan cipta tiket daripada dapatan.

Persediaan:

  1. Penyepaduan → Jira.
  2. Masukkan ID Jira Cloud.
  3. Jana dan tampal token API.

Ciri:

  • Pautkan kepada epik dan cerita Jira.
  • Tiket untuk:
    • Pengoptimuman kos.
    • Kebolehskalaan.
    • Mitigasi keselamatan.
    • Masalah pematuhan.
  • Lampirkan rajah kepada Jira.
  • Kemas kini status daripada Architecto.

Komunikasi

E-mel

Hantar seni bina dan laporan melalui e-mel.

  • Kongsi dengan bukan ahli pasukan.
  • Hantar laporan analisis.
  • Jadualkan ringkasan seni bina baharu.
  • Eksport dan lampirkan.

Teams (akan datang)

Penyepaduan Microsoft Teams.

  • Kongsi ke saluran.
  • Terima pemberitahuan.
  • Benamkan rajah dalam sembang.

Analitik dan pemantauan

Datadog (akan datang)

Pantau pelaksanaan seni bina.

New Relic (akan datang)

Jejaki metrik prestasi.

Grafana (akan datang)

Gambarkan metrik dan log.

Penyedia awan

AWS

Penyepaduan asli AWS, sedia disertakan.

  • Ikon lebih 200 perkhidmatan.
  • Penyepaduan harga.
  • VPC dan kumpulan keselamatan.

Google Cloud Platform

Penyepaduan GCP, sedia disertakan.

  • Ikon perkhidmatan.
  • Data harga.
  • VPC.

Microsoft Azure

Penyepaduan Azure, sedia disertakan.

  • Ikon lebih 100 perkhidmatan.
  • Data harga.
  • Rangkaian maya.

Kubernetes

Kubernetes dan orkestrasi bekas, sedia disertakan.

  • Ikon pod, pelaksanaan dan perkhidmatan.
  • Sokongan berbilang kluster.
  • Visualisasi carta Helm, akan datang.

Ujian API

Postman

Uji API dan penyepaduan.

  • Koleksi Postman
  • Import untuk menguji semua titik akhir.
  • Pengesahan prakonfigurasi.

AI dan automasi (akan datang)

GitHub Actions

Automatikkan aliran seni bina.

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

Zapier

Hubungkan lebih 1000 aplikasi.

  • Cetus tindakan melalui peristiwa Zapier.
  • Hantar seni bina kepada aplikasi terhubung.

Penyepaduan tersuai

Webhook

Bina penyepaduan dengan webhook.

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

API

Bina penyelesaian dengan API REST.

Amalan persediaan terbaik

  1. Keistimewaan minimum: hanya skop diperlukan.
  2. Rahsia selamat: kekunci dalam pemboleh ubah persekitaran.
  3. Uji dahulu: gunakan pementasan.
  4. Pantau: kesihatan dan kadar ralat.
  5. Dokumentasikan: kemas kini panduan pasukan.

Penyelesaian masalah

Penyepaduan tidak ditemukan?

Penyepaduan tidak berfungsi?

  • Semak tamat tempoh kekunci.
  • Pastikan URL webhook boleh dicapai.
  • Semak log ralat dalam tetapan.
  • Hubungi support@architecto.dev.

Langkah seterusnya:

Penyepaduan | Dokumentasi | Architecto