Gyro Kapsayıcı: ortamı özel ağa (VPC) bağlama

1. Nasıl çalışır

• Ortamınıza seçtiğiniz subnet içinde VPC kaynak aralığı ayrılır: 16 adreslik sabit bir blok (/28). Kapsayıcılarınızdan VPC'deki sunuculara giden bağlantılar bu aralıktan gelir.
• Bu aralık değişmez: düğüm yenilense, ölçeklense ya da paket değişse bile aynı kalır. Sunucunuzun güvenlik duvarında bir kez izin vermeniz yeter.
• Aralığın ilk adresi VPC uç noktasıdır. Bir servisi "yayınladığınızda" VPC'deki sunucular ona uç_nokta:port ile ulaşır. Uç nokta internete açılmaz.
• Bağlantı ve VPC içi trafik ücretsizdir; VPC kapısı (NAT) gerekmez. Kapsayıcıların internete çıkışı bugünkü gibi düğümlerin genel adresinden olur.
• Servisleriniz yeniden kurulmaz; bağlantı yaklaşık bir dakikada hazır olur.

2. Panelden bağlamak

1. Kapsayıcı hizmetinizde Yönetim sekmesinde Özel ağ (VPC) aracını açın.
2. VPC ve Subnet'i seçin. Henüz VPC'niz yoksa Gyro Konsol > Özel ağlar (VPC) bölümünden oluşturun.
3. VPC sunucularının erişmesini istediğiniz servisleri Servis ekle ile seçin ve her birine bir VPC portu verin (ör. api → 8080). Yalnız dışarı bağlanmak istiyorsanız servis eklemeniz gerekmez.
4. VPC'ye bağla'ya basın. Durum Bağlanıyor → Bağlı olur; VPC kaynak aralığı ve VPC uç noktası ekranda görünür.
5. VPC sunucunuzun güvenlik duvarında kaynak aralığına izin verin. Örneğin PostgreSQL için pg_hba.conf'a host all all 10.10.1.16/28 scram-sha-256 ekleyin.
6. Kapsayıcıdan VPC sunucusuna sunucunun özel IP'siyle bağlanın: DATABASE_URL=postgres://uygulama:[email protected]:5432/gyroproje.

Yayınlanan servisleri sonradan değiştirmek için listeyi düzenleyip Kaydet'e basın; kaynak aralığı ve uç nokta aynı kalır. Bağlantıyı kaldır blok adreslerini serbest bırakır: yeniden bağladığınızda farklı bir aralık gelebilir.

Gyro Konsol'da VPC'nin ayrıntı sayfası, Bağlı Kapsayıcı ortamları bölümünde her ortamın kaynak aralığını ve uç noktasını gösterir.

3. CLI, API, Terraform ve yapay zeka asistanı ile

gyro vpc list                                            # VPC ve subnet kimlikleri
gyro container vpc attach 12345 --vpc p0ab12cd --subnet sb34ef56 --expose api:8080 --wait
gyro container vpc get 12345                             # source_range, endpoint_ip, yayınlar
gyro container vpc expose 12345 --expose api:8080 --expose web:80   # listeyi değiştirir (--clear = boşalt)
gyro container vpc detach 12345 --wait

resource "gyro_container_vpc_attachment" "app" {
  environment_id = gyro_container_environment.gyro_proje.id
  vpc_id         = gyro_vpc.uretim.id
  subnet_id      = gyro_vpc.uretim.default_subnet_id
  expose {
    service = "api"
    port    = 8080
  }
}

output "kaynak_araligi" { value = gyro_container_vpc_attachment.app.source_range }

API: PUT /cloud/containers/{id}/vpc gövdesi {"vpc_id": "...", "subnet_id": "...", "expose": [{"service": "api", "port": 8080}]}; durum GET /cloud/containers/{id}/vpc (state: attaching → ready); yayın listesi PATCH ile, kaldırma DELETE gövdesi {"confirm": true}. Gyro MCP araçları: container_vpc_get, container_vpc_attach, container_vpc_expose, container_vpc_detach. Ayrıntı: geliştirici belgeleri.

4. VPC sunucusundan servise ulaşmak

Uç nokta 10.10.1.16 ve api servisi 8080 portunda yayınlıysa VPC'deki bir sunucudan:

curl http://10.10.1.16:8080/saglik

İstek servisin iç adresine (api.<ortam-ad-alanı>.svc.cluster.local:80) gider ve kopyalar arasında dağıtılır. Uç nokta adresi bir düğüm değişince kendiliğinden diğer düğüme taşınır.

5. Güvenlik

• VPC kaynak aralığı yalnız sizin ortamınıza aittir; başka müşterinin ortamı aynı bloğu kullanamaz. Yine de sunucu güvenlik duvarınızda yalnız bu aralığa ve gereken porta izin verin.
• Uç nokta yalnız VPC içinden erişilebilir; internete açmak için VPC kapısında port yönlendirme kullanmayın, servisin kendi HTTPS adresini kullanın.
• VPC kapısındaki port yönlendirmelerini Kaynak IP'ler listesiyle kısıtlayabilirsiniz (VPC kapısı).

6. Sık sorulanlar

Kaynak aralığı neden önemli? Kapsayıcıların düğümleri değişebilir; tek tek düğüm IP'lerine izin vermek yerine sabit /28'e izin verirsiniz, aralık hiç değişmez.

Ortamı başka bir subnete taşıyabilir miyim? Önce bağlantıyı kaldırın, sonra yeni subnete bağlayın. Yeni bağlantı yeni bir aralık alır.

Subnetim /26'dan küçük, ne yapmalıyım? VPC'ye en az /26 boyutunda yeni bir subnet ekleyin ve ortamı oraya bağlayın.

Ücreti var mı? Hayır. Bağlantı ve VPC içi trafik ücretsizdir; VPC kapısı gerekmez.

Sunucusuz ortamımı bağlayabilir miyim? Sunucusuz ortamlar için VPC bağlantısı yakında. Bu sürüm düğümlü ortamlarda çalışır.