Wdrażanie aplikacji w Google Cloud za pomocą Antigravity i wtyczki Google Cloud Developer

1. Zanim zaczniesz

W tym ćwiczeniu zainstalujesz wtyczkę Google Cloud Developer do interfejsu wiersza poleceń Antigravity CLI i wdrożysz aplikację w Google Cloud.

Czego się nauczysz

  • (Opcjonalnie) Odbierz środki na Google Cloud w ramach programu Google Developer Program lub połącz istniejące konto rozliczeniowe Cloud.
  • utworzyć projekt w chmurze Google Cloud, włączyć interfejs Agent Platform API i skonfigurować obszar roboczy Cloud Shell;
  • Uwierzytelnij Antigravity CLI za pomocą domyślnego uwierzytelniania aplikacji (ADC).
  • Zainstaluj wtyczkę Google Cloud Developer w Antigravity CLI.
  • Przetestuj wtyczkę, wdrażając przykładową aplikację internetową w Google Cloud.

Wymagania wstępne

  • Konto Google (aby wykorzystać środki w programie Google Developer Program, musisz mieć osobiste konto Gmail).
  • Konto rozliczeniowe Cloud (odebranie środków spowoduje automatyczne utworzenie konta tymczasowego).

2. Odbieranie środków w ramach programu Google Developer Program (opcjonalnie)

Wszystkie projekty Google Cloud wymagają aktywnego konta rozliczeniowego Cloud. Jeśli uczestniczysz w warsztatach lub wydarzeniu organizowanym przez Google, możesz odebrać środki w ramach programu Google Developer Program, aby otrzymać tymczasowe, wstępnie opłacone konto rozliczeniowe.

Kroki

  1. Znajdź link do wykorzystania środków w materiałach dotyczących wydarzenia (np. https://me.developers.google.com/benefits/claim/XXXX lub https://g.dev/credits/XXXX).
  2. Otwórz link, zaloguj się na swoje osobiste konto Gmail i wybierz Odbierz środki.

claim_gdp_credits

  1. Jeśli pojawi się taka prośba, wypełnij formularz, aby skonfigurować profil w programie Google Developer Program.
  2. Przejdź weryfikację Zeskanuj, aby potwierdzić, że jesteś człowiekiem, skanując kod QR za pomocą urządzenia mobilnego.
  3. Po zakończeniu weryfikacji pojawi się ekran potwierdzenia:

claim_credits_successfully

(Opcjonalnie) 🔍 Sprawdź wykorzystane środki

  1. Kliknij przycisk Otwórz konto rozliczeniowe lub otwórz Rozliczenia usługi Google Cloud, aby wyświetlić swoje konta rozliczeniowe w konsoli Google Cloud. Nowe konto pojawi się w sekcji Twoje konta rozliczeniowe:

newly_creation_billing_account

  1. Wybierz konto rozliczeniowe, a następnie w menu nawigacyjnym po lewej stronie kliknij Środki, aby sprawdzić aktywne środki, pozostałe saldo i daty ważności.

billing_account_credits

3. Tworzenie projektu Google Cloud i konfigurowanie środowiska

Aby korzystać z usług Google Cloud, utwórz projekt i połącz go z aktywnym kontem rozliczeniowym.

Tworzenie projektu Google Cloud

  1. Otwórz konsolę Google Cloud. W menu nawigacyjnym (☰) kliknij Uprawnienia i administracja > Utwórz projekt.

creating_a_project

  1. Dokończ konfigurację projektu:
    • Nazwa projektu: wpisz nazwę i zapisz wygenerowany identyfikator projektu, aby użyć go w kolejnych krokach.
    • Konto rozliczeniowe: wybierz konto rozliczeniowe (np. konto środków w programie Google Developer Program). Uwaga: jeśli masz tylko jedno konto rozliczeniowe, Google Cloud połączy je automatycznie i ukryje to pole.
    • Zasób nadrzędny: wybierz Brak organizacji (lub wybierz swoją organizację, jeśli dotyczy).

cloud_project_creation

  1. Kliknij Utwórz i poczekaj na zakończenie obsługi administracyjnej.
  2. Gdy pojawi się powiadomienie, kliknij ikonę Powiadomienia w prawym górnym rogu i wybierz Wybierz projekt.

select_project

  1. Sprawdź, czy nowy projekt jest widoczny w selektorze projektów u góry konsoli. Jeśli nie, otwórz selektor i przełącz się na nie.

project_selector

Aktywowanie Cloud Shell

Do uruchomienia interfejsu wiersza poleceń Antigravity i ukończenia ćwiczenia użyjemy Cloud Shell.

  1. Na pasku narzędzi w prawym górnym rogu kliknij ikonę Aktywuj Cloud Shell.

activate_cloud_shell

  1. Jeśli pojawi się prośba, kliknij Autoryzuj, aby przyznać Cloud Shell dostęp do interfejsów Google Cloud API.

authorize_cloud_shell

  1. Sprawdź aktywny projekt w terminalu.

cloud_shell_project

Jeśli właściwy projekt nie jest ustawiony, uruchom to polecenie:

gcloud config set project YOUR_PROJECT_ID

cloud_shell_project_set

Włączanie interfejsu Agent Platform API

Interfejs Antigravity CLI wymaga interfejsu Agent Platform API, aby uzyskać dostęp do modeli AI. Włącz interfejs API, uruchamiając w Cloud Shell to polecenie:

gcloud services enable aiplatform.googleapis.com

cloud_shell_enable_api

Co zrobiliśmy

  • utworzyć i skonfigurować projekt Google Cloud z rozliczeniami;
  • uruchomić i autoryzować Cloud Shell,
  • Ustaw aktywny projekt i włącz interfejs Agent Platform API.

4. Uruchamianie Antigravity CLI

Pobieranie przykładowej aplikacji

Do przetestowania wdrożenia w Google Cloud użyjemy przykładowej aplikacji. Użyj polecenia w Cloud Shell, aby pobrać przykładową aplikację i wejść do katalogu.

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

Uruchom Antigravity

Antigravity CLI (agy) jest wstępnie zainstalowany w Cloud Shell. W tej sekcji skonfigurujesz i uruchomisz interfejs wiersza poleceń.

Aby autoryzować Antigravity CLI za pomocą domyślnego uwierzytelniania aplikacji (ADC), wykonaj te czynności:

  1. Ustaw wymagane zmienne środowiskowe (AGY_ADC_AUTH, CLOUDSDK_CORE_PROJECT i GOOGLE_CLOUD_QUOTA_PROJECT), aby Antigravity CLI korzystał z limitu Twojego projektu, a następnie uruchom interfejs wiersza poleceń:
export AGY_ADC_AUTH=true
export CLOUDSDK_CORE_PROJECT=$(gcloud config get project)
export GOOGLE_CLOUD_QUOTA_PROJECT=$(gcloud config get project)
agy
  1. Przy pierwszym uruchomieniu pojawi się prośba o wybranie motywu:

agy_cli_themes

i zaakceptuj warunki korzystania z usługi:

agy_cli_tos

Do nawigacji użyj klawiszy strzałek, a następnie naciśnij Enter, aby przejść dalej.

  1. Ponieważ po raz pierwszy uruchamiasz interfejs wiersza poleceń w tym katalogu, pojawi się prośba o potwierdzenie, że mu ufasz. Wybierz Tak, ufam temu folderowi i naciśnij Enter.

agy_cli_trust

  1. Antigravity CLI jest teraz uruchomiony. Sprawdź, czy wskazuje on Twój projekt docelowy i bieżący katalog roboczy (luckydraw).

agy_cli_launched

  1. Uruchom polecenie /quit, aby zamknąć interfejs wiersza poleceń Antigravity i wrócić do Cloud Shell. Wymaganą wtyczkę zainstalujesz w następnej sekcji.

Co zrobiliśmy

  • Pobieranie przykładowej aplikacji do testowania
  • uruchomić Antigravity CLI w Cloud Shell z uwierzytelnianiem Google Cloud,

5. Instalowanie i testowanie wtyczki Google Cloud Developer

Aby wyposażyć interfejs wiersza poleceń Antigravity w narzędzia i sprawdzone metody wymagane do pracy z Google Cloud Platform, zainstaluj wtyczkę Google Cloud Developer.

Instalowanie wtyczki Google Cloud Developer

W Cloud Shell (poza Antigravity CLI) uruchom to polecenie, aby zainstalować wtyczkę Google Cloud Developer:

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

agy_cli_plugin_installation

Wdrażanie aplikacji z interfejsu wiersza poleceń Antigravity

  1. Uruchom Antigravity CLI:
agy
  1. W interfejsie wiersza poleceń poproś agenta o wdrożenie aplikacji i podaj preferencje konfiguracji, takie jak region wdrożenia:
Please deploy this web app to Google Cloud. I'd like to publish it to the region in Taiwan
  1. Podczas wykonywania zadań interfejs wiersza poleceń może prosić o zatwierdzenie poleceń. Aby potwierdzić i przejść dalej, naciśnij Enter.

agy_cli_deployment

Po zakończeniu wdrażania agent zwraca publiczny adres URL aplikacji.

Czyszczenie zasobów

Aby usunąć wszystkie utworzone zasoby i uniknąć dalszych opłat, poproś agenta o usunięcie środowiska:

Please clean up all stuff in this project

Co zostało zrobione

  • Zainstaluj wtyczkę Google Cloud Developer do Antigravity CLI.
  • wdrażać aplikację w Google Cloud za pomocą agenta Antigravity.

6. Gratulacje

Wiesz już, jak skonfigurować projekt, konto rozliczeniowe i Cloud Shell w Google Cloud. Użyliśmy też interfejsu wiersza poleceń Antigravity CLI i zobaczyliśmy, jak wtyczka Google Cloud Developer usprawnia wdrażanie i wycofywanie aplikacji.

osiągnięcia,

  • (Opcjonalnie) Wykorzystaj środki w programie Google Developer Program i skonfiguruj aktywne konto rozliczeniowe Cloud.
  • utworzyć projekt Google Cloud i połączyć go z aktywnym kontem rozliczeniowym Cloud;
  • Uruchomiliśmy interfejs wiersza poleceń Antigravity z uwierzytelnianiem Google Cloud.
  • zainstalować wtyczkę Google Cloud Developer do interfejsu wiersza poleceń Antigravity.
  • wdrożyć i wycofać aplikację w Google Cloud,

Dalsze kroki