Łączenie aplikacji z danymi AlloyDB i wdrażanie w Cloud Run

1. Przegląd

W tym ćwiczeniu pokażemy prostą i łatwą metodę konfigurowania AlloyDB i łączenia z nią aplikacji. Jest to szybki kurs na poziomie podstawowym (L100), który ma na celu poprawę komfortu pracy dewelopera podczas integrowania zaawansowanych aplikacji AI z zaawansowanymi funkcjami danych oferowanymi przez AlloyDB.

Co utworzysz

Prosta aplikacja internetowa.

W ramach tego ćwiczenia wykonasz te czynności:

1. Utworzysz instancję i klaster AlloyDB za pomocą instalacji jednym kliknięciem.
2. Utworzysz przykładową aplikację, aby połączyć się z tą instancją i skonfigurować dane.

Aplikacja połączy się z konfiguracją bazy danych utworzoną w kroku 1, utworzy tabelę i wstawi do niej 1 rekord.

Wymagania

• Przeglądarka, np. Chrome lub Firefox.
• Projekt Google Cloud z włączonymi płatnościami.

2. Zanim zaczniesz

Utwórz projekt

1. W konsoli Google Cloud na stronie wyboru projektu wybierz lub utwórz projekt Google Cloud .
2. Sprawdź, czy w projekcie w chmurze włączone są płatności. Dowiedz się, jak sprawdzić, czy w projekcie włączone są płatności.
3. Użyjesz Cloud Shell, czyli środowiska wiersza poleceń działającego w Google Cloud. Kliknij Aktywuj Cloud Shell na górze konsoli Google Cloud.

4. Po połączeniu z Cloud Shell sprawdź, czy uwierzytelnianie zostało już przeprowadzone, a projekt jest już ustawiony na Twój identyfikator projektu, używając tego polecenia:

gcloud auth list

5. Aby potwierdzić, że polecenie gcloud zna Twój projekt, uruchom w Cloud Shell to polecenie:

gcloud config list project

6. Jeśli projekt nie jest ustawiony, użyj tego polecenia, aby go ustawić:

gcloud config set project <YOUR_PROJECT_ID>

7. Włącz wymagane interfejsy API: kliknij link i włącz interfejsy API.

Możesz też użyć do tego polecenia gcloud. Informacje o poleceniach gcloud i ich użyciu znajdziesz w dokumentacji.

3. Konfiguracja bazy danych

W tym module użyjemy AlloyDB jako bazy danych na potrzeby danych testowych. Do przechowywania wszystkich zasobów, takich jak bazy danych i logi, używa ona klastrów. Każdy klaster ma instancję główną, która zapewnia punkt dostępu do danych. Tabele będą zawierać rzeczywiste dane.

Utwórzmy klaster, instancję i tabelę AlloyDB, do których zostaną wczytane dane testowe.

1. Kliknij przycisk lub skopiuj link poniżej do przeglądarki, w której zalogowany jest użytkownik konsoli Google Cloud.

Uruchom jednym kliknięciem

2. Po wykonaniu tego kroku repozytorium zostanie sklonowane do lokalnego edytora Cloud Shell i będzie można uruchomić polecenie poniżej z folderu projektu (ważne, aby upewnić się, że jesteś w katalogu projektu):

sh run.sh

3. Teraz użyj interfejsu (klikając link w terminalu lub link „Podgląd w internecie” w terminalu).
4. Aby rozpocząć, wpisz szczegóły projektu, klastra i nazwy instancji.
5. Zrób sobie kawę, podczas gdy logi będą się przewijać. Możesz też przeczytać, jak to działa za kulisami.

4. Tworzenie przykładowej aplikacji do testowania połączenia

W terminalu Cloud Shell uruchom to polecenie:

git clone https://github.com/AbiramiSukumaran/verify-easy-alloydb-connection

Wprowadź zmiany w pliku verify_connection.py, aby dostosować go do konfiguracji AlloyDB, którą właśnie skonfigurowałeś(-aś) w poprzedniej sekcji:

# Replace this with the Private IP of your AlloyDB Instance
DB_HOST = <<>> 
DB_PORT = "5432"
DB_NAME = "postgres"
DB_USER = "postgres"
# Replace this with your actual AlloyDB password    
DB_PASS = <<>>

Jeśli chcesz przetestować to lokalnie lub z dowolnego miejsca, otwórz instancję AlloyDB, kliknij „EDYTUJ” i „Włącz publiczny adres IP” lub „Łączność z publicznym adresem IP” (nie wychodzącą), a następnie wpisz „0.0.0.0/0” w polu „Autoryzowane sieci zewnętrzne” na potrzeby programowania. Po zakończeniu usuń i wyłącz łączność z publicznym adresem IP.

5. Wdrożenie w Cloud Run

W terminalu Cloud Shell upewnij się, że jesteś w folderze głównym i w folderze projektu.

Gdy upewnisz się, że jesteś w folderze projektu, uruchom to polecenie:

gcloud beta run deploy verify-alloydb \
    --source . \
    --region=us-central1 \
    --network=easy-alloydb-vpc \
    --subnet=easy-alloydb-subnet \
    --allow-unauthenticated \
    --vpc-egress=all-traffic

Po wdrożeniu otrzymasz wdrożony punkt końcowy Cloud Run, który wygląda tak:

https://verify-alloydb-**********-uc.a.run.app/

6. Prezentacja

Aby potwierdzić, że wszystko działa, możesz sprawdzić wynik w przeglądarce lub w eksploratorze logów.

W konsoli Google Cloud otwórz AlloyDB i nowo utworzoną instancję. W panelu nawigacyjnym po lewej stronie kliknij „AlloyDB Studio” i połącz się za pomocą swoich danych logowania.

W Studio w panelu po lewej stronie odśwież obiekty bazy danych. Powinna się pojawić nowo utworzona tabela:

Możesz szybko wysłać do niej zapytanie, aby sprawdzić, czy wstawianie się powiodło:

7. Czyszczenie

Po zakończeniu tego ćwiczenia nie zapomnij usunąć klastra i instancji AlloyDB.

Wejdź na https://console.cloud.google.com/alloydb/clusters. Aby usunąć klaster, kliknij pionowy wielokropek obok niego i wybierz USUŃ.

Powinno to spowodować usunięcie klastra wraz z jego instancjami.

8. Podsumowanie

Zacznij konfigurować dane w AlloyDB szybko i łatwo.