Google Cloud Developer Plugin ile Google Cloud'a Uygulama Dağıtmak İçin Antigravity'yi Kullanma

1. Başlamadan önce

Bu codelab'de, Antigravity CLI için Google Cloud Developer eklentisini yükleyecek ve Google Cloud'a bir uygulama dağıtacaksınız.

Öğrenecekleriniz

  • (İsteğe bağlı) Google Developer Program aracılığıyla Google Cloud kredisi talep edin veya mevcut bir Cloud Faturalandırma Hesabı'nı bağlayın.
  • Google Cloud projesi oluşturma, Agent Platform API'yi etkinleştirme ve Cloud Shell çalışma alanınızı yapılandırma
  • Uygulama Varsayılan Kimlik Bilgileri'ni (ADC) kullanarak Antigravity CLI'nın kimliğini doğrulayın.
  • Antigravity CLI'ya Google Cloud Developer eklentisini yükleyin.
  • Google Cloud'a örnek bir web uygulaması dağıtarak eklentiyi test etme

Ön koşullar

  • Google Hesabı (Google Developer Program kredilerini kullanmak için kişisel bir Gmail hesabı gerekir).
  • Cloud Faturalandırma Hesabı (Kredileri talep ettiğinizde otomatik olarak geçici bir hesap oluşturulur.)

2. Google Developer Program kredilerini kullanma (isteğe bağlı)

Tüm Google Cloud projeleri için etkin bir Cloud Faturalandırma Hesabı gerekir. Google tarafından desteklenen bir atölye çalışmasına veya etkinliğe katılıyorsanız Google Developer Program kredileri talep ederek geçici ve önceden finanse edilmiş bir faturalandırma hesabı alabilirsiniz.

Adımlar

  1. Etkinlik materyallerinizde (ör. https://me.developers.google.com/benefits/claim/XXXX veya https://g.dev/credits/XXXX) kredi kullanma bağlantınızı bulun.
  2. Bağlantıyı açın, kişisel Gmail hesabınızla giriş yapın ve Krediyi Kullan'ı seçin.

claim_gdp_credits

  1. İstenirse Google Developer Program profilinizi oluşturmak için formu doldurun.
  2. Mobil cihazınızla QR kodunu tarayarak Gerçek Kişi Olduğunuzu Doğrulamak İçin Tarayın kontrolünü tamamlayın.
  3. Doğrulama işleminden sonra bir onay ekranı gösterilir:

claim_credits_successfully

(İsteğe bağlı) 🔍 Talep ettiğiniz kredileri kontrol etme

  1. Google Cloud Console'da faturalandırma hesaplarınızı görüntülemek için Faturalandırma Hesabını Aç düğmesini tıklayın veya Cloud Faturalandırma'yı ziyaret edin. Yeni hesabınız Faturalandırma hesaplarınız bölümünde listelenir:

newly_creation_billing_account

  1. Faturalandırma hesabınızı seçin, ardından etkin kredilerinizi, kalan bakiyenizi ve son kullanma tarihlerini onaylamak için soldaki gezinme menüsünde Krediler'i tıklayın.

billing_account_credits

3. Google Cloud projesi oluşturma ve ortamı ayarlama

Google Cloud hizmetlerini kullanmak için bir proje oluşturun ve bu projeyi etkin bir faturalandırma hesabına bağlayın.

Google Cloud projesi oluşturma

  1. Google Cloud Console'u açın. Gezinme menüsünden (☰) IAM & Admin (IAM ve Yönetici) > Create Project'e (Proje Oluştur) gidin.

creating_a_project

  1. Proje yapılandırmasını tamamlayın:
    • Proje adı: Bir ad girin ve oluşturulan proje kimliğini sonraki adımlarda kullanmak üzere kaydedin.
    • Faturalandırma hesabı: Faturalandırma hesabınızı (ör. Google Developer Program kredileri hesabınız) seçin. Not: Yalnızca bir faturalandırma hesabınız varsa Google Cloud bu hesabı otomatik olarak bağlar ve bu alanı gizler.
    • Üst kaynak: Kuruluş yok'u seçin (veya varsa kuruluşunuzu seçin).

cloud_project_creation

  1. Create'i (Oluştur) tıklayın ve temel hazırlığın tamamlanmasını bekleyin.
  2. Bildirim göründüğünde sağ üst köşedeki Bildirimler simgesini tıklayın ve Proje Seç'i belirleyin.

select_project

  1. Yeni projenizin, konsolun üst kısmındaki proje seçicide göründüğünü doğrulayın. Seçili değilse seçiciyi açıp ilgili hesaba geçin.

project_selector

Cloud Shell'i etkinleştirme

Antigravity CLI'yı çalıştırmak ve codelab'i tamamlamak için Cloud Shell'i kullanacağız.

  1. Sağ üstteki araç çubuğunda Cloud Shell'i etkinleştir simgesini tıklayın.

activate_cloud_shell

  1. İstenirse Cloud Shell'e Google Cloud API'lerine erişim izni vermek için Authorize'ı (Yetkilendir) tıklayın.

authorize_cloud_shell

  1. Terminal isteminde etkin projenizi doğrulayın.

cloud_shell_project

Doğru proje ayarlanmamışsa şu komutu çalıştırın:

gcloud config set project YOUR_PROJECT_ID

cloud_shell_project_set

Agent Platform API'yi etkinleştirme

Antigravity CLI, yapay zeka modellerine erişmek için Agent Platform API'yi kullanır. Cloud Shell'de komutu çalıştırarak API'yi etkinleştirin:

gcloud services enable aiplatform.googleapis.com

cloud_shell_enable_api

Yaptıklarımız

  • Faturalandırma özelliğine sahip bir Google Cloud projesi oluşturup yapılandırdınız.
  • Cloud Shell'i başlatma ve yetkilendirme
  • Etkin projeyi ayarlayın ve Agent Platform API'yi etkinleştirin.

4. Antigravity CLI'yı başlatma

Örnek uygulamayı indirin

Google Cloud'a dağıtımı test etmek için örnek bir uygulama kullanacağız. Örnek uygulamayı indirmek ve dizine girmek için lütfen Cloud Shell'deki komutu kullanın.

git clone https://github.com/ericsk/luckydraw.git
cd luckydraw/

Antigravity'yi başlatma

Antigravity CLI (agy), Cloud Shell'e önceden yüklenmiştir. Bu bölümde CLI'yi yapılandırıp başlatacaksınız.

Uygulama Varsayılan Kimlik Bilgileri'ni (ADC) kullanarak Antigravity CLI'yı yetkilendirmek için aşağıdaki adımları uygulayın:

  1. Antigravity CLI'ın projenizin kotasını kullanması için gerekli ortam değişkenlerini (AGY_ADC_AUTH, CLOUDSDK_CORE_PROJECT ve GOOGLE_CLOUD_QUOTA_PROJECT) ayarlayın, ardından CLI'yı başlatın:
export AGY_ADC_AUTH=true
export CLOUDSDK_CORE_PROJECT=$(gcloud config get project)
export GOOGLE_CLOUD_QUOTA_PROJECT=$(gcloud config get project)
agy
  1. İlk başlatmada bir tema seçmeniz istenir:

agy_cli_themes

ve hizmet şartlarını kabul edin:

agy_cli_tos

Gezinmek için ok tuşlarını kullanın ve devam etmek için Enter tuşuna basın.

  1. KSA'yı bu dizinde ilk kez çalıştırdığınız için güvenilir olarak işaretlemeniz istenir. Yes, I trust this folder'ı (Evet, bu klasöre güveniyorum) seçin ve Enter'a basın.

agy_cli_trust

  1. Antigravity CLI artık çalışıyor. Hedef projenizi ve mevcut çalışma dizininizi (luckydraw) gösterdiğini doğrulayın.

agy_cli_launched

  1. Antigravity CLI'dan çıkıp Cloud Shell'e dönmek için /quit komutunu çalıştırın. Gerekli eklentiyi bir sonraki bölümde yükleyeceksiniz.

Yaptıklarımız

  • Test için örnek uygulamayı indirme
  • Google Cloud kimlik doğrulamasıyla Cloud Shell'de Antigravity CLI'yı başlatın.

5. Google Cloud Developer eklentisini yükleme ve test etme

Antigravity CLI'yı Google Cloud Platform ile çalışmak için gereken araçlar ve en iyi uygulamalarla donatmak üzere Google Cloud Developer eklentisini yükleyin.

Google Cloud Developer eklentisini yükleme

Google Cloud Developer eklentisini yüklemek için Cloud Shell'de (Antigravity CLI dışında) aşağıdaki komutu çalıştırın:

agy plugin install https://github.com/google/skills/tree/main/plugins/cloud/google-cloud-developer

agy_cli_plugin_installation

Uygulamanızı Antigravity CLI'dan dağıtma

  1. Antigravity CLI'yı başlatın:
agy
  1. KSA'da, temsilciden uygulamanızı dağıtmasını isteyin ve dağıtım bölgesi gibi yapılandırma tercihlerini ekleyin:
Please deploy this web app to Google Cloud. I'd like to publish it to the region in Taiwan
  1. CLI, görevleri yürütürken komutları onaylamanızı isteyebilir. Onaylayıp devam etmek için Enter tuşuna basın.

agy_cli_deployment

Dağıtım tamamlandığında temsilci, uygulamanızın herkese açık URL'sini döndürür.

Kaynakları temizleme

Oluşturulan tüm kaynakları kaldırmak ve devam eden ücretlerden kaçınmak için temsilciden ortamı kaldırmasını isteyin:

Please clean up all stuff in this project

Yaptıklarınız

  • Antigravity CLI için Google Cloud Developer eklentisini yükleyin.
  • Antigravity aracısını kullanarak Google Cloud'a uygulama dağıtma

6. Tebrikler

Google Cloud'da proje, faturalandırma hesabı ve Cloud Shell'i nasıl yapılandıracağınızı öğrendiniz. Ayrıca Antigravity CLI'yı kullandınız ve Google Cloud Developer eklentisinin, uygulamaları dağıtma ve dağıtımı kaldırma işlemlerini nasıl kolaylaştırdığını gördünüz.

Başarılarınız

  • (İsteğe bağlı) Google Developer Program kredilerini kullanmış ve etkin bir Cloud Faturalandırma Hesabı oluşturmuş olmanız gerekir.
  • Google Cloud projesi oluşturup etkin bir Cloud Faturalandırma Hesabı'na bağlamış olmanız gerekir.
  • Google Cloud kimlik doğrulamasını kullanarak Antigravity CLI'yı başlattınız.
  • Antigravity CLI için Google Cloud Developer eklentisini yüklediniz.
  • Google Cloud'da bir uygulama dağıtıp dağıtımını kaldırdınız.

Sonraki adımlar