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

https://www.gyrohosting.com/bilgi-bankasi/makale/projeler-hizmetleri-gruplama

- **Bu rehberde ne öğreneceksiniz**: Proje açmayı, hizmetleri projeye taşımayı, üst çubuktaki proje seçiciyle listeleri süzmeyi, proje başına bu ayki harcamayı görmeyi ve aynı işi API, `gyro` CLI ya da Terraform ile yapmayı.
- **Süre**: 5 dakika
- **Kimin için**: Birden çok müşteri ya da ortam (üretim, test) için hizmet yöneten herkes; özellikle ajanslar ve geliştirici ekipleri.
- **Gerekenler**: En az bir hizmeti olan bir Gyro müşteri hesabı.

## 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.

![Üst çubuktaki proje seçici: bir projeye tıklayınca Hizmetlerim ve Gyro Konsol yalnız o projenin hizmetlerini gösterir. Sayılar etkin hizmet sayısıdır.](https://www.gyrohosting.com/resources/uploads/bilgi-merkezi/A10-01-tr.webp)

## 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.

![Hizmetlerim listesinde seçtiğiniz hizmetleri Projeye taşı penceresinden istediğiniz projeye taşırsınız. Hizmetin kendisi, faturası ve etiketleri değişmez.](https://www.gyrohosting.com/resources/uploads/bilgi-merkezi/A10-03-tr.webp)

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

### Kurallar

|  | Sınır |
| --- | --- |
| Proje sayısı | Hesap başına en çok 50 (Genel hariç) |
| Proje adı | 1-40 karakter, hesapta benzersiz (büyük/küçük harf fark etmez); "Genel", "General", "Default" ayrılmıştır |
| Açıklama | En çok 255 karakter |
| Renk | Gri, Mavi, Yeşil, Kırmızı, Turuncu, Sarı, Mor, Pembe, Turkuaz, Lacivert |
| Değişiklik hızı | Dakikada en çok 60 değişiklik |

## 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.

![Projeler sayfasında her projenin kaynak sayısını ve bu ayki harcamasını görürsünüz. Yeni proje sağ üstteki düğmeyle açılır.](https://www.gyrohosting.com/resources/uploads/bilgi-merkezi/A10-02-tr.webp)

- **Ö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](https://www.gyrohosting.com/bilgi-bankasi/makale/gyro-api-ilk-adim)). 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.

> **Alt hesap anahtarları**
> 
> (bayi ve son müşteri anahtarları) projeleri görebilir ve kapsamlarındaki hizmetleri taşıyabilir; proje açma, yeniden adlandırma ve silme yalnız ana anahtarla yapılır.

## 7. Sık sorulan sorular

**Projeye taşımak hizmeti etkiler mi?**

Hayır. Sunucu yeniden başlamaz, IP adresi, fatura, yenileme tarihi ve etiketler değişmez. Yalnız panelde hangi grupta göründüğü değişir.

**Bir hizmeti iki projeye koyabilir miyim?**

Hayır, her hizmet tek projededir. Birden çok gruplamaya ihtiyacınız varsa ek olarak [etiketleri](https://www.gyrohosting.com/bilgi-bankasi/makale/hizmet-takma-ad-ve-etiket) kullanın: bir etiket farklı projelerdeki hizmetlerde olabilir.

**Projeyi silersem ne olur?**

Proje kaldırılır, içindeki tüm hizmetler Genel'e döner. Hiçbir hizmet, fatura ya da veri silinmez.

**Alt hesaplarım projeleri görebilir mi?**

Hizmetleri görme yetkisi olan alt hesaplar proje seçiciyi kullanabilir. Hizmet taşımak ve proje açmak/silmek için hizmetleri yönetme yetkisi gerekir.

**Hizmeti başka bir hesaba devredersem?**

Projeler hesabınıza aittir. Devredilen hizmet sizin projenizden çıkar ve yeni sahibinde Genel'de görünür.

**Alan adlarımı projeye koyabilir miyim?**

Şimdilik hayır; projeler **Hizmetlerim** listesindeki hizmetler içindir.

> **Biliyor muydunuz?**
> 
> [Gyro Konsol](https://www.gyrohosting.com/bilgi-bankasi/makale/gyro-konsol) proje seçiminize uyar: bir proje seçtiğinizde konsoldaki sunucular, IP adresleri ve güvenlik grupları da yalnız o projeye göre listelenir.

## Sıradaki adım

- **Bulut kaynaklarınızı tek ekranda yönetin:** [Gyro Konsol](https://www.gyrohosting.com/bilgi-bankasi/makale/gyro-konsol).
- **Hizmetlere takma ad ve etiket verin:** [Takma ad ve renkli etiketler](https://www.gyrohosting.com/bilgi-bankasi/makale/hizmet-takma-ad-ve-etiket).