Dağıtım oluşturma ve yönetme

Apps Komut Dosyası projesi dağıtımı, komut dosyasının web uygulaması, eklenti veya API yürütülebilir dosyası olarak kullanılması için kullanıma sunulan bir sürümüdür. Dağıtım oluşturarak ve yöneterek kodunuzda iterasyon yapabilir, değişikliklerinizi takip edebilir ve kullanıcılarınızın erişebildiği tam kod sürümünü kontrol edebilirsiniz.

İki tür dağıtım vardır:

  • Her zaman mevcut proje koduyla senkronize edilen ana dağıtımlar.
  • Belirli bir proje sürümüne bağlı sürümlü dağıtımlar.

Ana dağıtımlar

Ana dağıtım, mevcut proje kodudur. Bir Apps Komut Dosyası projesi oluşturduğunuzda otomatik olarak bu proje için bir ana dağıtım oluşturursunuz.

Ana dağıtım, her zaman en son kaydedilen kodla senkronizedir. Örneğin, sürümlü bir dağıtım oluşturup kodunuzu değiştirirseniz ana dağıtım bu değişiklikleri yansıtır. Sürümlü dağıtım ise aynı kalır.

Kodu test etmek için ilk dağıtımları kullanın. Herkese açık kullanım için ana dağıtımları kullanmayın.

Sürümlü dağıtımlar

Sürümü olan bir dağıtım, proje kodunun belirli bir sürümünü kullanıma sunar. Bu sayede, siz kodda değişiklik ve iyileştirmeler yaparken kullanıcılarınız çalışmayan bir sürümü kullanmaya devam etmez.

Uygulamanız herkese açık olarak yayınlandığında her zaman sürümlü dağıtım kullanın. Aynı anda birden fazla etkin sürüm dağıtımınız olabilir.

Önemli: Sürümlü dağıtımların sahipliğini aktaramazsınız. Bir komut dosyası projesinin sahipliğini başka birine aktarırsanız projedeki mevcut sürümlü dağıtımların sahibi değişmez. Bir yönetici, dağıtım sahibinin hesabını silerse dağıtımlarıyla ilgili komut dosyası hataları görebilirsiniz.

Sürümlü dağıtım oluşturma

Bir Google Workspace eklentisinin, Düzenleyici eklentisinin, Google Chat uygulamasının veya API yürütülebilir dosyasının bir sürümünü dağıtmak için önce Apps Komut Dosyanızın Google Cloud proje ilişkilendirmesini varsayılan projeden standart bir projeye geçirmeniz gerekir.

Sürümlü dağıtım oluşturmak için aşağıdaki adımları uygulayın:

  1. Apps Komut Dosyası projesini açın.
  2. Sağ üstte Dağıtım > Yeni dağıtım'ı tıklayın.
  3. Türü seçin'in yanındaki Dağıtım türlerini etkinleştir'i tıklayın.
  4. Dağıtmak istediğiniz dağıtım türünü seçin. Google Workspace eklentileri, Düzenleyici eklentileri ve Google Chat uygulamaları için Eklenti'yi seçin.
  5. Dağıtımınızla ilgili bilgileri girin ve Dağıt'ı tıklayın.

Sürümlü dağıtımları görüntüleme

Bir Apps Komut Dosyası projesinin dağıtımlarını görüntülemek için üstte Dağıt > Dağıtımları yönet'i tıklayın.

Belirli bir sürümün kodunu görüntülemek için Önceki bir sürümü görüntüleme başlıklı makaleyi inceleyin.

Sürümlü bir dağıtımı düzenleme

Sürüm içeren bir dağıtımın açıklamasını veya sürümünü değiştirmek için dağıtımı düzenleyebilirsiniz. Bir dağıtımı düzenlemek için aşağıdaki adımları uygulayın:

  1. Apps Komut Dosyası projesini açın.
  2. Dağıt > Dağıtımları yönet'i tıklayın.
  3. Değiştirmek istediğiniz etkin dağıtımı seçin ve Düzenle'yi tıklayın.
  4. Değişikliklerinizi yapıp Yayınla'yı tıklayın.

    Arşivlenmiş bir dağıtımı düzenlemek istiyorsanız dağıtımı yeniden dağıtmanız ve önceki adımları uygulamanız gerekir.

    Proje kodunda bir değişikliği dağıtmak istediğinizde yeni bir sürüm oluşturun ve dağıtımı bu sürümü kullanacak şekilde düzenleyin. Yeni sürüm, ilgili dağıtımı kullanan tüm kullanıcılar tarafından otomatik olarak kullanılır.

Dağıtım kimliğini bulma

Her dağıtımın, otomatik olarak oluşturulan ilişkili bir dize kimliği vardır. Bu kimliği bulmak için aşağıdaki adımları uygulayın:

  1. Apps Komut Dosyası projesini açın.
  2. Sağ üstte Dağıtım > Dağıtımları yönet'i tıklayın.
  3. Kimliğini bulmak için etkin bir dağıtım seçin.

    Dağıtım kimlikleri yalnızca etkin dağıtımlarda görünür.

Dağıtımı test etme

Bir dağıtımı nasıl test ettiğiniz, oluşturduğunuz uygulamanın türüne bağlıdır.

Google Workspace eklentisi

Google Workspace eklentisi dağıtımını test etmek için Google Workspace eklentilerini test etme başlıklı makaleyi inceleyin.

Düzenleyici eklentisi

Düzenleyici eklentisi dağıtımını test etmek için Düzenleyici eklentisini test etme başlıklı makaleyi inceleyin.

Web uygulaması

Web uygulaması dağıtımını test etmek için Web uygulaması dağıtımını test etme başlıklı makaleyi inceleyin.

Google Chat uygulaması

Chat uygulaması dağıtımını test etmek için önce dağıtım kimliğine erişmek üzere komut dosyasının sürümlü bir dağıtımını oluşturmanız gerekir.

Dağıtım kimliğini aldıktan sonra Chat API yapılandırmasında kimliği belirtin ve etkileşimli özellikleri test etme adımlarını uygulayın.

Çalıştırılabilir API

Bir API yürütülebilir dağıtımını test etmek için önce sürümlü bir dağıtım oluşturmanız gerekir. Dağıtım oluşturduktan sonra aşağıdaki adımları uygulayın:

  1. Apps Script projesinin sağ üst kısmında Dağıtım > Dağıtım Testi'ni tıklayın.
  2. "Türü seçin"in yanındaki Dağıtım türlerini etkinleştir'i > API Yürütülebilir'i tıklayın.
  3. API çalıştırılabilir dağıtımınızı test etmek için URL'yi kopyalayıp kullanın.

Sürümlü bir dağıtımı arşivleme

Sürüm içeren dağıtımları silemezsiniz. Bunun yerine, bu e-postaları arşivleyebilirsiniz.

Sürümlü bir dağıtımı arşivlemek için:

  1. Apps Komut Dosyası projesini açın.
  2. Dağıt > Dağıtımları yönet'i tıklayın.
  3. Arşivlemek istediğiniz dağıtımı seçin ve Dağıtımı arşivle'yi tıklayın.

Arşivlenmiş bir dağıtımı yeniden dağıtma

  1. Apps Komut Dosyası projesini açın.
  2. Sağ üstte Dağıtım > Dağıtımları yönet'i tıklayın.
  3. Sol taraftaki Arşivlendi bölümünde, yeniden dağıtmak istediğiniz dağıtımı seçin ve Düzenle > Dağıt'ı tıklayın.