Paylaşılan Ortam Değişkeni Grupları

Bir ortam değişkeni grubu, paylaşılan bir API anahtarı veya veritabanı kimlik bilgisi gibi birkaç Orbit projesinin ihtiyaç duyduğu değerleri tek bir yerde tutar. Grubu ihtiyacı olan projelere bağlayın ve her birinin derlemesi bu değişkenleri alır, böylece bir anahtarı döndürmek altı düzenleme yerine bir düzenleme olur.

Env Grupları Nerede Bulunur

Orbit açın ve üst düzey gezintiden Env groups seçin. Sayfa Shared env var groups başlığına sahiptir ve bunları hesap düzeyinde gruplar olarak tanımlar ve birden fazla Orbit projesi arasında paylaşılır.

Gruplar projelerin üstündedir. Bir projenin kendi değişkenleri hala Env vars sekmesinde bulunur: Environment Variables in Orbit bölümüne bakın.

Grup Ne Zaman Kullanılır

Test basittir: aynı değer birden fazla projeye yapıştırılıyor mu?

İyi adaylar:

• Her ön uç tarafından kullanılan paylaşılan bir analitik veya hata izleme anahtarı.
• Birkaç dahili araç tarafından kullanılan bir okuma çoğaltması bağlantı dizesi.
• Tüm hesabın konuştuğu bir hizmet için üçüncü taraf API anahtarı.
• Ortak bir özellik bayrağı istemci belirteci.

Kötü adaylar:

• Bir projeye özgü herhangi bir şey. Orada kalmalıdır.
• Üretim ve önizleme arasında farklılık gösteren herhangi bir şey. Gruplar ortam başına değildir, bu nedenle ortama göre değişen bir değer projenin kendi ortam değişkenlerinde kalmalıdır.

Grup Oluşturma

1. New group düğmesine tıklayın.
2. Buna bir Group name verin, en fazla 64 karakter. Adını içerdiği şeyden sonra adlandırın, örneğin kimlik bilgilerinin ait olduğu hizmet.
3. İsteğe bağlı bir Description ekleyin.
4. Create group düğmesine tıklayın.

Bir hesap en fazla 20 gruba sahip olabilir. Sınırda olduğunuzda düğme (limit reached) gösterir ve başka bir grup oluşturmak reddedilir.

Değişken Ekleme

Grubu açın ve Variables bölümünü kullanın:

1. Add variable düğmesine tıklayın.
2. Anahtarı ve değeri girin.
3. Herhangi bir hassas şey için Mark as secret işaretleyin.
4. Save group düğmesine tıklayın.

Gizli olarak işaretlenen bir değişken şifreli olarak depolanır ve değeri daha sonra panele döndürülmez. Liste, anahtar ve değerin yerine Marked as secret (hidden) göstergesi gösterir. Gizli olmayan değerler görünür kalır, böylece bunları bir bakışta kontrol edebilirsiniz.

Bir sırrın değerini değiştirmek için yeni değeri yazın ve kaydedin. Bir değişkeni kaldırmak için satırında Remove düğmesine tıklayın ve kaydedin.

Projeleri Bağlama

Linked projects bölümü hesaptaki her projeyi listeler. Bağlamak veya bağlantıyı kaldırmak için bir projeye tıklayın; bağlantılı projeler vurgulanır. Grubu kaydedin ve uygulayın.

Bağlantılı projesi olmayan bir grubun hiçbir işlevi yoktur ve bölüm siz bir proje bağlayana kadar No projects yet gösterir.

Grup değişkenleri derleme zamanında enjekte edilir, bu nedenle bir projeyi bağlamak şu anda canlı olan dağıtımı değil, sonraki derlemesini etkiler. Değişikliğe şimdi ihtiyacınız varsa yeniden dağıtın: Deploying Your Project bölümüne bakın.

Öncelik

Kural sayfada belirtilir: grup değişkenleri derleme zamanında enjekte edilir ve proje düzeyinde ve ortam düzeyinde değişkenler grup değişkenlerinden öncelik alır.

Diğer bir deyişle, en spesifik kazanır:

1. Ortam düzeyinde değişkenler, en yüksek öncelik.
2. Proje düzeyinde değişkenler.
3. Grup değişkenleri, en düşük.

Bu sıralama sadece bir teknik ayrıntı değil, yararlıdır. Paylaşılan varsayılanı grupta ayarlayın ve farklı bir şeye ihtiyaç duyan bir projeye geçersiz kılın, o projeyi gruptan kaldırmadan. Ortam katmanı için Environment Variables Per Environment bölümüne bakın.

Ayrıca gruplarla en yaygın kafa karışıklığını açıklar: grubu düzenlersiniz, yeniden dağıtırsınız ve hiçbir şey değişmez, çünkü projenin sessizce kazanan aynı anahtarla kendi değişkeni vardır. Bir grup değeri göz ardı edilmiş gibi göründüğünde önce projenin kendi Env vars sekmesini kontrol edin.

Paylaşılan Kimlik Bilgisini Döndürme

Bu, grupların varlık nedeni olan iş akışıdır:

1. Sağlayıcıda yeni kimlik bilgisi oluşturun, eskisini etkin bırakın.
2. Grupta değeri düzenleyin ve kaydedin.
3. Her bağlantılı projeyi yeniden dağıtın veya sonraki dağıtımını bekleyin.
4. Her projenin yeni kimlik bilgisi üzerinde çalıştığını onaylayın.
5. Eski kimlik bilgisini sağlayıcıda iptal edin.

Adım 5'i önce yapmak, her bağlantılı projenin aynı anda bozuk olduğu bir pencere verir, bu da paylaşılan kimlik bilgisinin yoğunlaştırdığı tam riskdir.

Grubu Silme

Grupta sil düğmesine tıklayın. Onay, sonuç hakkında spesifiktir: gelecekteki derlemeler bu değişkenleri kaybedecek ve zaten tamamlanmış derlemeler etkilenmez.

Silme ayrıca her projeyi bağlantısını kaldırır. Bu, çalışan dağıtımların oluşturuldukları değerlerle devam ettiği ve her bağlantılı projenin sonraki derlemesinin bunlarsız ortaya çıktığı anlamına gelir. Bu değişkenler gerekli ise, bu derleme başarısız olur veya uygulama çalışma zamanında yanlış davranır.

Silmeden önce projelerin bağlantısını birer birer kaldırın ve her birini yeniden dağıtın, böylece hepsi kaybetmeden önce hangilerinin gerçekten gruba bağlı olduğunu öğrenirsiniz.

Pratik Tavsiye

Grupları küçük ve amaçlı tutun. Bir dış hizmet başına bir grup, her şeyin tam olarak ihtiyacı olan projeleri bağlamanıza izin verdiği için bir dev "shared" grubu yenmesi.

Anahtarları her yerde aynı şekilde adlandırın. Bir proje SENTRY_DSN okuyorsa ve diğeri SENTRY_KEY okuyorsa, paylaşılan bir grup size yardımcı olamaz. Önce adları standartlaştırın.

Genel önizlemeleri olan projelerle bağlantılı bir gruba üretim kimlik bilgilerini koymayın. Grup değişkenleri bağlantılı projenin her derlemesine, önizlemeler dahil olmak üzere ulaşır.

Sorun Giderme

Bir derleme değişkeni görmüyor. Projenin bağlı olduğunu ve kaydedildiğini ve derlemenin bağlantı yapıldıktan sonra çalıştığını onaylayın. Grup değişkenleri sonraki derlemeden uygulanır.

Değer çalışma zamanında yanlış. Aynı anahtarla proje düzeyinde veya ortam düzeyinde bir değişken bunu geçersiz kılıyor. Projenin Env vars sekmesini kontrol edin.

Grubu oluştur kullanılamıyor. 20 grubu sınırında veya hesap rolünüz sahip veya yönetici değildir.

Bir sırrın değeri boş gösterilir. Doğru. Gizli değerler kaydedildikten sonra panele döndürülmez.

Bir proje grup düzenlemesinden sonra bozuldu. Grupta değeri geri alın ve yeniden dağıtın, ardından hangi projenin katılmadığını çözün. Rolling Back a Deployment yapılan dağıtımı siz çözerken sağlıklı tutması için onu alır.

Sonra Nereye Gidilir

• Environment Variables in Orbit proje düzeyinde değişkenler için.
• Environment Variables Per Environment geçersiz kılma katmanı için.
• Orbit Project Settings projenin geri kalanının yapılandırması için.