Projeler: hizmetlerinizi işe, müşteriye ya da ortama göre ayırın

1. Proje nedir?

Proje, hizmetlerinizi bir arada tutan bir klasördür. "Müşteri A", "Web Üretim", "Staging" gibi projeler açar, her hizmeti bir projeye koyarsınız. Sonra üst çubuktaki proje seçiciden bir proje seçtiğinizde Hizmetlerim ve Gyro Konsol yalnız o projenin hizmetlerini gösterir.

• Her hesapta Genel adlı varsayılan bir proje vardır. Bir projeye koymadığınız her hizmet Genel'dedir; bugüne kadar aldığınız hizmetler de oradadır. Hiçbir şey yapmazsanız paneliniz eskisi gibi çalışır.
• Bir hizmet aynı anda yalnız bir projede olur.
• Proje yalnız bir gruplamadır: hizmetin kendisi, faturası, yenileme tarihi ve etiketleri değişmez.

2. Adım adım proje açma ve hizmet taşıma

1. Sol menüden Projeler'i açın (ya da üst çubuktaki proje seçiciden Yeni proje).
2. Yeni proje'ye tıklayın; bir ad yazın (en çok 40 karakter), isterseniz açıklama, renk ve simge seçin, Oluştur'a basın.
3. Hizmetlerim'e gidin. Taşımak istediğiniz hizmetlerin solundaki kutuları işaretleyin; ekranın altında bir çubuk açılır.
4. Çubuktaki Projeye taşı'ya tıklayın, projeyi seçin ve Taşı'ya basın. Pencerede Yeni proje oluştur ve taşı ile tek adımda yeni proje de açabilirsiniz.

Tek bir hizmeti, hizmetin kendi sayfasından da taşıyabilirsiniz: başlıktaki proje rozetinin yanındaki Projeye taşı düğmesi.

Kurallar

3. Proje seçiciyle süzme

• Üst çubuktaki Proje kutusuna tıklayın. Listede Tüm projeler, Genel ve kendi projeleriniz, yanlarında etkin hizmet sayılarıyla görünür.
• Bir proje seçtiğinizde sayfa yenilenir; Hizmetlerim listesinde yalnız o projenin hizmetleri kalır ve üstte "X projesi gösteriliyor" bandı çıkar. Banttaki Tüm projeleri göster ile süzmeyi kaldırırsınız.
• Tüm projeler görünümünde her hizmetin yanında renkli proje rozeti görünür.
• Seçiminiz tarayıcınızda hatırlanır; başka bir bilgisayarda yeniden seçmeniz gerekir.
• Faturalar projeye göre süzülmez (bir fatura birden çok hizmeti kapsayabilir). Panodaki sayaçlar ve "ilgi gerektiren" uyarıları da hesabın tamamını gösterir.

4. Proje başına harcama

Projeler sayfasında her proje kartında kaynak sayısı ve bu ayki harcama görünür; üstte tüm projelerin toplamı vardır.

• Ön ödemeli (saatlik) hizmetler (Gyro Bulut İstanbul, Gyro Kapsayıcı vb.): bu ay bakiyenizden düşen gerçek tutar.
• Dönemsel hizmetler (aylık, yıllık): hizmet tutarının aylık karşılığı (ör. yıllık 120 € olan hizmet 10 €).
• Tutarlar hesap para biriminizde, parantez içinde euro karşılığıyla gösterilir.

Kartın Aç düğmesi o projeyi seçip sizi Hizmetlerim'e götürür. Kartın menüsünden projeyi düzenleyebilir ya da silebilirsiniz. Proje silindiğinde içindeki hizmetler Genel'e döner; hiçbir hizmet silinmez.

5. Yeni hizmetler hangi projeye düşer?

• Panelde bir proje seçiliyken sipariş verirseniz, yeni hizmet seçili projeye eklenir.
• Tüm projeler ya da Genel seçiliyken verilen siparişler Genel'e düşer.
• API, CLI ya da Terraform ile siparişte project_id verirseniz hizmet o projeye eklenir. Geçersiz bir project_id sipariş oluşmadan reddedilir.
• Destek ekibimizin sizin adınıza açtığı hizmetler Genel'e düşer; istediğiniz projeye taşıyabilirsiniz.

6. API, CLI ve Terraform ile

API anahtarını hesap menüsündeki API Kimlik Bilgileri'nden oluşturursunuz (bkz. Gyro API'ye ilk adım). Okuma için services_read, değişiklik için services_write kapsamı gerekir.

# Projeleri listeleyin (Genel her zaman id 0)
gyro project list

# Proje açın ve iki hizmeti hemen içine taşıyın
gyro project create --name "Müşteri A" --color teal --icon briefcase --service-ids 12345,12346

# Bir hizmeti başka projeye taşıyın (0 = Genel)
gyro service project set 12347 --project-id 7

# Yalnız bir projenin hizmetlerini listeleyin
gyro service list --project 7

# Projeyi silin (hizmetler Genel'e döner)
gyro project delete 7 --yes

API uçları: GET/POST /cloud/projects, GET/PATCH/DELETE /cloud/projects/{id}, POST /cloud/projects/{id}/services (toplu taşıma, en çok 500 hizmet) ve PUT /cloud/services/{id}/project. Hizmet listesi ve ayrıntısında her hizmetin project alanı döner; liste ?project=<id> ile süzülür. Sunucu, yük dengeleyici ve şablondan sunucu siparişlerinde project_id alanı kabul edilir.

Terraform (sağlayıcı 0.18.0 ve üstü):

resource "gyro_project" "musteri_a" {
  name  = "Müşteri A"
  color = "teal"
  icon  = "briefcase"
}

resource "gyro_server" "web" {
  plan          = "standart-2-4"
  region        = "tr-ist-1"
  image         = "ubuntu-24.04"
  confirm_order = true
  project_id    = tonumber(gyro_project.musteri_a.id)
}

# Terraform dışında açılmış bir hizmeti projeye bağlamak için
resource "gyro_service_project" "eski_site" {
  service_id = 12348
  project_id = tonumber(gyro_project.musteri_a.id)
}

project_id sonradan değişirse sunucu yeniden kurulmaz, yerinde taşınır.

7. Sık sorulan sorular