Dokümanlar /
... / Uygulama Yapılandırması / Ortam değişkenlerini yönetme

Ortam değişkenlerini yönetme

app.odac.run üzerindeki sağ taraftaki denetleyici çekmecesinden herhangi bir uygulama için ortam değişkenlerini görüntüleyin, ekleyin, düzenleyin, oluşturun ve paylaşın. Ortam değişkenleri bölümünden gruplanmış değişken ön eklerini ve bağlı uygulamaları bir bakışta inceleyebilir, birden fazla satırı doldurmak için .env metni yapıştırabilir, 16 karakterlik gizli anahtarlar (secret) oluşturabilir, kilitli başlangıç kimlik bilgilerini açığa çıkarabilir veya kopyalayabilir, başka bir uygulamadan değişkenler bağlayabilir ve değişiklikleri yeniden başlatarak veya başlatmadan kaydedebilirsiniz.

Ortam değişkenlerini görüntüleme ve düzenleyiciyi açma

  1. Kanvas üzerinden uygulamanın denetleyici çekmecesini açın (bkz. Uygulamayı inceleme, yeniden adlandırma, yeniden başlatma ve silme) ve Ortam değişkenleri bölümüne bakın. Uygulamada henüz değişken yoksa satırda yalnızca kesikli çizgili Ortam ekle düğmesi görünür. Değişkenler veya bağlı uygulamalar olduğunda bölümün sağ üst köşesinde Düzenle görünür ve satır üç grupta etiketler gösterir: bağlantı simgeli bağlı uygulama rozetleri (örneğin mariadb), ilk alt çizgiden önce aynı ön eki paylaşan iki veya daha fazla anahtar için gruplanmış ön ek etiketleri (örneğin +3 sayı rozetli DB) ve tekil değişkenler için ayrı etiketler (örneğin NODE_ENV). Renkli noktalar değişken türlerini ayırt eder: veritabanı anahtarları için mavi, önbellek için kırmızı, çalışma zamanı için yeşil, gizli değerler ve anahtarlar için kehribar, ODAC değişkenleri için mor ve diğer anahtarlar için gri. Kopyalamak üzere herhangi bir anahtarı seçebileceğiniz, o gruptaki her tam anahtar adını listeleyen bir açılır kutu açmak için bir ön ek etiketinin sayı rozetinin (örneğin +3) üzerine gelin.

shop için Ortam değişkenleri bölümünde bağlı mariadb rozetini, açılır kutusu açık DB +3 ön ek etiketini, API_KEY, NODE_ENV ve Düzenle düğmesini gösteren denetleyici çekmecesi

  1. Ortam değişkenleri düzenleyicisini açmak için Düzenle düğmesine, Ortam değişkenleri satırındaki herhangi bir etikete veya Ortam ekle düğmesine tıklayın. Denetleyici çekmecesi genişler, diğer genel bakış bölümlerini daraltır ve üst bilgide Geri düğmesini (<) görünür kılar. Loading... tamamlandıktan sonra en üstte varsa bağlı uygulamalar salt okunur kartlarda görünür; ardından alfabetik sırayla manuel değişkenleriniz (henüz hiç yoksa No environment variables) ve en altta Değişken ekle ile Uygulama bağla düğmeleri yer alır.

shop için API_KEY, DB_HOST, NODE_ENV değişkenlerini ve Değişken ekle ile Uygulama bağla düğmelerini gösteren genişletilmiş Ortam değişkenleri düzenleyicisi

Değişken ekleme veya .env dosyası yapıştırma

  1. Ortam değişkenleri düzenleyicisinin sol alt kısmındaki Değişken ekle düğmesine tıklayın. Solda bir NEW_KEY alanı, sağda bir value alanı ve bir kaldırma düğmesi (×) içeren yeni bir satır görünür ve imleciniz NEW_KEY alanına yerleşir. Boş bir NEW_KEY alanına odaklanıldığında Kısayol: Otomatik doldurmak için .env içeriğini buraya yapıştırabilirsiniz ipucu görüntülenir. Bir anahtar adı yazın (anahtarlar büyük harfle görüntülenir) ve sağ tarafa değerini girin. Mevcut bir değişkeni düzenlemek için değer alanına tıklayın ve yeni değeri yazın; mevcut değeri gizli olan alanlarda odaklanıldığında temizlenen noktalar (•••) görünür, böylece yeni bir değer yazabilirsiniz (alanı boş bırakmak gizli değeri değiştirmeden geri yükler). Herhangi bir manuel satırı kaldırmak için sağındaki × düğmesine tıklayın.

Yeni bir satıra odaklanılmış ve NEW_KEY altında Kısayol: Otomatik doldurmak için .env içeriğini buraya yapıştırabilirsiniz açılır kutusunun göründüğü genişletilmiş Ortam değişkenleri düzenleyicisi

  1. Birden fazla değişkeni tek seferde içe aktarmak için .env metnini (KEY=value biçimindeki satırları) doğrudan NEW_KEY alanına yapıştırın. ODAC boş satırları ve # yorum satırlarını yok sayar, değerlerin başındaki ve sonundaki tek veya çift tırnakları kaldırır, mevcut satırı ilk geçerli girişle doldurur ve kalan girişler için aşağıya yeni satırlar ekler. Manuel bir değişken başka bir satırla veya bağlı bir uygulamayla aynı anahtarı kullanıyorsa, kaydetmeden önce çakışmayı çözebilmeniz için yinelenen satır kırmızıyla vurgulanır (ve bağlı kartların içindeki çakışan anahtarlar kırmızıya döner).

.env içeriği yapıştırıldıktan sonra APP_URL, STRIPE_KEY ve STRIPE_WEBHOOK_SECRET satırlarının dolduğu ve KAYDET ile VE YENİDEN BAŞLAT düğmelerinin göründüğü genişletilmiş Ortam değişkenleri düzenleyicisi

Zar düğmesiyle gizli anahtar oluşturma

  1. Yeni veya düzenlenebilir bir değişken anahtarı pass, pwd, secret, key, token, credential veya salt sözcüklerinden birini içerdiğinde (örneğin JWT_SECRET, API_KEY veya WEBHOOK_TOKEN), değer alanının sağ iç kenarında bir zar düğmesi görünür. Yeni eklenen satırlarda anahtar adı bu sözcüklerden biriyle eşleşir eşleşmez zar düğmesi belirir. Simgeyi döndürmek, alanı rastgele 16 karakterlik alfanümerik bir gizli değerle doldurmak, gerektiğinde kopyalayabilmeniz için önceden gizlenmiş herhangi bir değeri yeni gizli değer seçili olacak şekilde düz metne çevirmek ve KAYDET ile VE YENİDEN BAŞLAT düğmelerini görünür kılmak için zar düğmesine tıklayın.

Zar düğmesine tıklanmış ve değer alanında yeni oluşturulmuş 16 karakterlik gizli değerin seçili olduğu JWT_SECRET satırı

Kilitli başlangıç kimlik bilgilerini açığa çıkarma ve kopyalama

  1. İlk başlatmada başlangıç kimlik bilgileri oluşturan veritabanları ve durum bilgisi tutan (stateful) uygulamalar (örneğin MARIADB_ROOT_PASSWORD), manuel değişkenlerin üzerinde kehribar rengi bir uyarı gösterir: Locked values were created when this app first started. The image only reads them while setting up an empty data directory, so changing one here would not change the credential itself. Kilitli satırlar kehribar kenarlık, kilit simgesi ve silme düğmesi olmayan salt okunur maskelenmiş bir değerle görünür. Kimlik bilgisini düz metin olarak açığa çıkarmak için kilitli bir satırın sağındaki göz düğmesine tıklayın (gizlemek için tekrar tıklayın) veya değeri panonuza kopyalamak için kopyala düğmesine tıklayın. Kopyalandığında düğme kısa süreliğine yeşil bir onay işaretine dönüşür ve ODAC Value copied to clipboard bildirimini gösterir.

mariadb için kehribar rengi kilitli değerler uyarısını, düz metin olarak açığa çıkarılmış MARIADB_ROOT_PASSWORD değerini ve Değer panoya kopyalandı bildirimini gösteren genişletilmiş Ortam değişkenleri düzenleyicisi

Başka bir uygulamanın değişkenlerini bağlama

  1. Aynı projede ortam değişkenlerine sahip diğer uygulamaları listeleyen bir açılır kutu açmak için Ortam değişkenleri düzenleyicisinin sağ alt kısmındaki Uygulama bağla düğmesine tıklayın (projedeki başka hiçbir uygulamada değişken yoksa ODAC No other apps with environment variables found mesajını gösterir). Ortam değişkenlerini mevcut uygulamaya bağlamak için listeden bir uygulamaya (örneğin mariadb) tıklayın.

Uygulama bağla düğmesine tıklanmış ve mariadb ile redis uygulamalarını listeleyen açılır kutunun göründüğü genişletilmiş Ortam değişkenleri düzenleyicisi

  1. ODAC mariadb bağlandı bildirimini gösterir (veya o uygulama zaten bağlıysa Already linked uyarısını gösterir), KAYDET ve VE YENİDEN BAŞLAT düğmelerini görünür kılar ve düzenleyicinin en üstüne, manuel değişkenlerinizin üzerine bağlı uygulama için salt okunur bir kart ekler. Bağlı bir kartın içindeki gizli değerler maskelenmiş (•••••••) kalır; bunları görüntülemeniz veya değiştirmeniz gerekirse o uygulamanın kendi Ortam değişkenleri panelini açın. Bağlı bir uygulamanın bağlantısını kaldırmak için kartının sağ üst köşesindeki × düğmesine tıklayın.

mariadb bağlandı bildirimini ve Ortam değişkenleri düzenleyicisinde NODE_ENV üzerine eklenen salt okunur MARIADB kartını gösteren görünüm

Kaydetme veya kaydedip yeniden başlatma

  1. Kaydedilmemiş eklemeleriniz, düzenlemeleriniz, kaldırmalarınız veya uygulama bağlantılarınız olduğunda Ortam değişkenleri panelinin sağ üst köşesinde KAYDET ve VE YENİDEN BAŞLAT etiketi görünür. Çalışan konteyneri yeniden başlatmadan değişikliklerinizi yazmak için KAYDET düğmesine tıklayın (değişkenler uygulama bir sonraki yeniden başlatıldığında uygulanır) veya değişikliklerinizi kaydedip uygulamanın yeni değişkenleri hemen alması için uygulamayı anında yeniden başlatmak üzere VE YENİDEN BAŞLAT düğmesine tıklayın. ODAC Environment saved mesajıyla onaylar (sunucu bağlı değilse Server is offline uyarısını gösterir) ve işlem etiketini gizler. İşiniz bittiğinde üst bilgideki Geri (<) veya Kapat (×) düğmesine tıklayın.

İmlecin KAYDET yanındaki VE YENİDEN BAŞLAT düğmesine tıkladığı Ortam değişkenleri düzenleyicisi üst bilgisi