Mevcut herhangi bir aktif ortamdan dallanarak yeni bir ortam oluşturabilirsiniz. Süreç kaynak veritabanını klonlar ve isteğe bağlı olarak yapılandırma kaynaklarını kopyalar; değişiklikleri geliştirmek veya test etmek için izole bir çalışma alanı sağlar.

---

Yeni Ortam Nasıl Oluşturulur

1. Backend Konsolu’nun üst gezinti çubuğundaki Ortam Seçici açılır menüsünü açın.
2. + Ortam Oluştur düğmesine tıklayın.
3. Aşağıdaki yapılandırma seçenekleriyle bir modal iletişim kutusu görünecektir.

Yapılandırma Alanları

• Dallanma Kaynağı: Dallanma için kaynak ortamı seçin. Yalnızca active durumundaki ortamlar kaynak olarak kullanılabilir.
• Ortam Adı: Yeni ortam için benzersiz bir ad girin (örn. staging, feature-auth, qa-sprint-12). Adlar yalnızca alfanümerik karakterler, tireler ve alt çizgiler içerebilir.

Dal Modu

Kaynak veritabanının nasıl klonlanacağını seçin:

• Full (şema + veri): Kaynak veritabanının tüm tablo yapıları ve satır verileri dahil tam bir kopyasını oluşturur. Test veya QA için gerçekçi veriye ihtiyaç duyduğunuzda kullanın.
• System (yalnızca şema): Yalnızca veritabanı şemasını (tablolar, sütunlar, indeksler, ilişkiler, enumlar, görünümler) satır verisi olmadan kopyalar. Boş veri setiyle başlamak istediğiniz temiz geliştirme ortamları için kullanın.

Kaynaktan Yapılandırma Kopyala

İsteğe bağlı olarak kaynak ortamdan kaynak yapılandırmalarını kopyalayın. Her seçenek bir onay kutusu ile kontrol edilir ve ProjectOwner rolü gerektirir:

• Dosya depolama sağlayıcıları: Dosya depolama sağlayıcı yapılandırmalarını (S3, GCS, Azure, Filestack) yeni ortama kopyalayın. Her kopyalanan sağlayıcı yeni benzersiz bir tanımlayıcı alır.
• Gateway rotaları: Özel API gateway rotalarını ve webhook’ları kopyalayın. Bu, yeni ortamda yönlendirme yapılandırmanızı korur.
• Güvenlik yapılandırması: CORS origin’lerini ve rate limit ayarlarını kopyalayın. Yeni ortamın ebeveyniyle aynı ağ politikalarını devralmasını sağlar.
• Ortam değişkenleri: Ortam değişkeni anahtar-değer çiftlerini kopyalayın. Yeni ortamın kaynakla aynı yapılandırma sırlarıyla başlamasını sağlar.

Not: Kimlik doğrulama sağlayıcıları güvenlik nedenleriyle kasıtlı olarak kopyalama seçeneklerinden hariç tutulmuştur. OAuth istemci sırları, Cognito kimlik bilgileri ve diğer kimlik doğrulama anahtarları, yanlışlıkla kimlik bilgisi paylaşımını önlemek için ortam başına bağımsız yapılandırılmalıdır.

4. Dallanma sürecini başlatmak için Ortam oluştur’a tıklayın.

---

Dallanma Sırasında Ne Olur

Yeni bir ortam oluşturduğunuzda aşağıdaki sıra gerçekleşir:

1. Doğrulama: Sistem ortam adının benzersiz olduğunu ve kaynak ortamın active durumunda olduğunu doğrular.
2. Kayıt Oluşturma: Yeni bir ortam kaydı oluşturulur ve platformun yapılandırma deposunda projeyle kaydedilir.
3. Veritabanı Klonlama: Kaynak PostgreSQL veritabanı klonlanır. Full modda tüm veriler dahildir; System modda yalnızca şema (tablo yapıları) kopyalanır.
4. Veritabanı Kullanıcıları: Klonlanan ortam için yeni güvenli veritabanı kimlik bilgileri otomatik olarak sağlanır.
5. Yapılandırma Kaydı: Yeni ortam projenin global ayarlarına bağlanır.
6. Kaynak Kopyalama: Seçildiyse dosya sağlayıcıları, gateway rotaları, güvenlik yapılandırması ve ortam değişkenleri kaynaktan yeni ortama kopyalanır.
7. Durum Aktivasyonu: Ortam durumu active’e geçer ve kullanıma hazır hale gelir.

Herhangi bir adım başarısız olursa sistem otomatik geri alma yapar: klonlanan veritabanı ve ilişkili kimlik bilgileri kaldırılır; yetim kaynak kalmaz.

---

GraphQL API

Mutation: branchEnvironment

mutation BranchEnvironment($input: BranchEnvironmentInput!) {
  branchEnvironment(input: $input) {
    success
    message
    environment {
      id
      name
      parentId
      parentName
      branchMode
      branchedAt
      status
      createdAt
      updatedAt
    }
  }
}

Variables:

{
  "input": {
    "projectId": "f7e4a264-d659-4719-91e8-c2d74654e529",
    "name": "staging",
    "sourceEnvironment": "master",
    "mode": "full",
    "copyFileProviders": true,
    "copyGatewayRoutes": true,
    "copySecurityConfig": false,
    "copyEnvironmentVariables": true
  }
}

Response:

{
  "data": {
    "branchEnvironment": {
      "success": true,
      "message": "Environment created successfully",
      "environment": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "name": "staging",
        "parentId": "master-env-id",
        "parentName": "master",
        "branchMode": "full",
        "branchedAt": "2026-03-08T20:00:00Z",
        "status": "active",
        "createdAt": "2026-03-08T20:00:00Z",
        "updatedAt": "2026-03-08T20:00:05Z"
      }
    }
  }
}

Input Fields

Alan	Tip	Gerekli	Açıklama
projectId	String	Evet	Projenin benzersiz tanımlayıcısı
name	String	Evet	Yeni ortam için ad
sourceEnvironment	String	Evet	Dallanılacak ortamın adı
mode	String	Evet	Klonlama modu: "full" veya "system"
copyFileProviders	Boolean	Hayır	Dosya depolama sağlayıcı yapılandırmalarını kopyala
copyGatewayRoutes	Boolean	Hayır	Özel API gateway rotalarını kopyala
copySecurityConfig	Boolean	Hayır	CORS ve rate limit ayarlarını kopyala
copyEnvironmentVariables	Boolean	Hayır	Ortam değişkeni anahtar-değer çiftlerini kopyala

İzin Gereksinimleri

• Kopyalama bayrağı olmadan ortam oluşturmak standart proje erişimi gerektirir.
• Herhangi bir kopyalama bayrağını (copyFileProviders, copyGatewayRoutes, copySecurityConfig, copyEnvironmentVariables) etkinleştirmek ProjectOwner rolü gerektirir; bu işlemler hassas yapılandırma verilerinin kopyalanmasını içerir.