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

1. Przegląd

W tym ćwiczeniu z programowania pokażemy prostą i łatwą metodę konfigurowania AlloyDB i łączenia z nią aplikacji. To szybki kurs na poziomie 100, który pomoże Ci zwiększyć komfort pracy programisty podczas integrowania zaawansowanych aplikacji AI z zaawansowanymi funkcjami danych oferowanymi przez AlloyDB.

Co utworzysz

Prosta aplikacja internetowa.

W ramach tego procesu:

1. Tworzenie instancji i klastra AlloyDB za pomocą instalacji jednym kliknięciem
2. Utwórz przykładową aplikację, aby połączyć się z tą instancją i skonfigurować dane.

Aplikacja połączy się z bazą danych skonfigurowaną 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 selektora projektów wybierz lub utwórz projekt Google Cloud.
2. Sprawdź, czy w projekcie Cloud włączone są płatności. Dowiedz się, jak sprawdzić, czy w projekcie włączone są płatności.

Aby wypróbować ten przewodnik, możesz użyć linku do środków na koncie rozliczeniowym w okresie próbnym GCP: https://bit.ly/ez-alloydb

Jak odebrać środki za pomocą tego linku? Rekomenduj.

3. Będziesz używać Cloud Shell, czyli środowiska wiersza poleceń działającego w Google Cloud. U góry konsoli Google Cloud kliknij Aktywuj Cloud Shell.

4. Po połączeniu z Cloud Shell sprawdź, czy jesteś już uwierzytelniony i czy projekt jest 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ć 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 do przechowywania danych testowych. Używa klastrów do przechowywania wszystkich zasobów, takich jak bazy danych i logi. Każdy klaster ma instancję podstawową, która zapewnia punkt dostępu do danych. Tabele będą zawierać rzeczywiste dane.

Utwórzmy klaster, instancję i tabelę AlloyDB, do których zostanie załadowany testowy zbiór danych.

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

One Click & Run

2. Po wykonaniu tego kroku repozytorium zostanie sklonowane do lokalnego edytora Cloud Shell i będziesz mieć możliwość uruchomienia poniższego polecenia z folderu projektu (ważne jest, aby upewnić się, że jesteś w katalogu projektu):

sh run.sh

3. Teraz użyj interfejsu (kliknij link w terminalu lub link „Podgląd w internecie” w terminalu).
4. Aby rozpocząć, wpisz szczegóły identyfikatora projektu, klastra i nazw instancji.
5. Idź po kawę, podczas gdy dzienniki będą się przewijać. Tutaj możesz przeczytać, jak to działa w tle.

4. Utwórz przykładową aplikację, aby przetestować połączenie

W terminalu Cloud Shell uruchom to polecenie:

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

Wprowadź zmiany w pliku verify_connection.py w przypadku konfiguracji AlloyDB, którą właśnie skonfigurowano w ostatniej 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ć połączenie lokalnie lub z dowolnego miejsca, otwórz instancję AlloyDB, kliknij „EDYTUJ”, a potem „Włącz publiczny adres IP” lub „Łączność z publicznym adresem IP” (nie wychodzącą) i wpisz „0.0.0.0/0” w polu „Autoryzowane sieci zewnętrzne” na potrzeby programowania. Po zakończeniu usuń łączność z publicznym adresem IP i wyłącz ją.

5. Wdrożenie w Cloud Run

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

Gdy będziesz mieć pewność, że znajdujesz się 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 powinien pojawić się wdrożony punkt końcowy Cloud Run, który wygląda tak:

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

6. Prezentacja

Aby sprawdzić, czy wszystko działa, możesz wyświetlić wynik w przeglądarce lub w Eksploratorze logów.

Możesz przejść do AlloyDB w konsoli Google Cloud i otworzyć nowo utworzoną instancję. W panelu nawigacji po lewej stronie kliknij „AlloyDB Studio” i zaloguj się za pomocą swoich danych logowania.

W studio w panelu po lewej stronie odśwież obiekty bazy danych. Powinna być widoczna nowo utworzona tabela:

Możesz szybko wysłać do niej zapytanie, aby sprawdzić, czy wstawianie zostało wykonane:

7. Czyszczenie

Po ukończeniu tego modułu próbnego nie zapomnij usunąć klastra i instancji AlloyDB.

Otwórz stronę https://console.cloud.google.com/alloydb/clusters. Wybierz klaster, który chcesz usunąć, klikając pionowy wielokropek obok niego, a następnie kliknij USUŃ.

Powinien on wyczyścić klaster wraz z jego instancjami.

8. Podsumowanie

Zacznij konfigurować dane w AlloyDB szybko i łatwo.