Workshop Mod Aplikasi

1. Pengantar

Terakhir Diperbarui: 01-11-2024

Bagaimana cara memodernisasi aplikasi PHP lama ke Google Cloud?

(📽️ tonton video pengantar berdurasi 7 menit untuk codelab ini)

Sering kali ada aplikasi lama yang berjalan di infrastruktur lokal yang perlu dimodernisasi. Artinya, membuat model tersebut skalabel, aman, dan dapat di-deploy di berbagai lingkungan.

Dalam workshop ini, Anda akan:

  1. Masukkan Aplikasi PHP ke dalam container.
  2. Beralih ke Layanan Database Terkelola (Cloud SQL).
  3. Deploy ke Cloud Run (alternatif zero-ops untuk GKE/Kubernetes).
  4. Mengamankan Aplikasi dengan Identity and Access Management (IAM) dan Secret Manager.
  5. Tentukan pipeline CI/CD melalui Cloud Build. Cloud Build dapat dihubungkan dengan repositori Git Anda yang dihosting di penyedia Git populer seperti GitHub atau GitLab, dan dipicu pada setiap push ke main, misalnya.
  6. Menghosting gambar aplikasi di Cloud Storage. Hal ini dicapai melalui pemasangan, dan tidak diperlukan kode untuk mengubah aplikasi.
  7. Memperkenalkan fungsi AI Generatif melalui Gemini, yang diorkestrasi melalui Cloud Functions (serverless).
  8. Pelajari SLO dan cara mengoperasikan aplikasi yang baru diperbarui.

Dengan mengikuti langkah-langkah ini, Anda dapat memodernisasi aplikasi PHP secara bertahap, sehingga meningkatkan skalabilitas, keamanan, dan fleksibilitas deployment-nya. Selain itu, beralih ke Google Cloud memungkinkan Anda memanfaatkan infrastruktur dan layanannya yang canggih untuk memastikan aplikasi Anda berjalan lancar di lingkungan berbasis cloud.

Kami yakin bahwa apa yang akan Anda pelajari dengan mengikuti langkah-langkah sederhana ini dapat diterapkan untuk aplikasi dan organisasi Anda sendiri dengan bahasa/stack dan kasus penggunaan yang berbeda.

Tentang Aplikasi

Aplikasi (kode, di bawah lisensi MIT) yang akan Anda fork adalah aplikasi PHP 5.7 dasar dengan autentikasi MySQL. Ide utama Aplikasi ini adalah menyediakan platform tempat pengguna dapat mengupload foto, dan administrator memiliki kemampuan untuk memberi tag pada gambar yang tidak pantas. Aplikasi ini memiliki dua tabel:

  • Pengguna. Sudah dikompilasi sebelumnya dengan admin. Orang baru dapat mendaftar.
  • Images. Dilengkapi dengan beberapa gambar contoh. Pengguna yang login dapat mengupload gambar baru. Kami akan menambahkan sentuhan ajaib di sini.

Sasaran Anda

Kami ingin memodernisasi aplikasi lama agar dapat dijalankan di Google Cloud. Kami akan memanfaatkan alat dan layanannya untuk meningkatkan skalabilitas, meningkatkan keamanan, mengotomatiskan pengelolaan infrastruktur, dan mengintegrasikan fitur lanjutan seperti pemrosesan gambar, pemantauan, dan penyimpanan data menggunakan layanan seperti Cloud SQL, Cloud Run, Cloud Build, Secret Manager, dan lainnya.

445f7a9ae37e9b4d.png

Yang lebih penting, kami ingin melakukannya langkah demi langkah agar Anda dapat mempelajari proses pemikiran di balik setiap langkah, dan biasanya setiap langkah membuka kemungkinan baru untuk langkah berikutnya (contoh: modul 2 -> 3, dan 6 -> 7).

Masih belum yakin? Tonton video berdurasi 7 menit ini di YouTube.

Yang Anda butuhkan

  • Komputer dengan browser, yang terhubung ke internet.
  • Beberapa kredit GCP. Lihat langkah berikutnya untuk melakukannya.
  • Anda akan menggunakan Cloud Shell. Cloud Shell dilengkapi dengan semua perintah yang telah diinstal sebelumnya yang Anda perlukan dan IDE.
  • Akun GitHub. Anda memerlukan ini untuk membuat cabang kode asli 🧑🏻‍💻 gdgpescara/app-mod-workshop dengan repo git Anda sendiri. Hal ini diperlukan untuk memiliki pipeline CI/CD Anda sendiri (commit otomatis -> build -> deploy)

Contoh solusi dapat ditemukan di sini:

Workshop ini dirancang untuk diselesaikan di Cloud Shell (di browser).

Namun, hal ini juga dapat dicoba dari komputer lokal Anda.

2. Penyiapan kredit dan Fork

6dafc658860c0ce5.png

Tukarkan kredit GCP dan siapkan lingkungan GCP Anda [opsional]

Untuk menjalankan workshop ini, Anda memerlukan akun penagihan dengan sejumlah kredit. Gunakan kredit dari banner di bagian atas codelab ini untuk memulai. Jika Anda sudah terhubung ke akun penagihan, Anda dapat melewati langkah ini.

Setelah selesai, buka Konsol Google Cloud dan buat project baru dengan mengklik Project Selector di menu dropdown kiri atas tempat "No organization" ditampilkan. Lihat di bawah

bd7548f78689db0b.png

Buat project baru jika Anda belum memilikinya seperti yang ditunjukkan pada screenshot di bawah. Ada opsi "NEW PROJECT" di pojok kanan atas.

6c82aebcb9f5cd47.png

Pastikan untuk menautkan project baru dengan akun penagihan uji coba GCP sebagai berikut.

f202527d254893fb.png

Anda sudah siap menggunakan Google Cloud Platform. Jika Anda adalah pemula atau hanya ingin melakukan semuanya di lingkungan Cloud, Anda dapat mengakses Cloud Shell dan editornya melalui tombol berikut di pojok kiri atas seperti yang ditunjukkan di bawah.

7d732d7bf0deb12e.png

Pastikan project baru Anda dipilih di kiri atas:

Tidak dipilih (buruk):

c2ffd36a781b276a.png

Dipilih (baik):

594563c158f4f590.png

Membuat Fork Aplikasi dari GitHub

  1. Buka aplikasi demo: https://github.com/gdgpescara/app-mod-workshop
  2. Klik 🍴 fork.
  3. Jika Anda belum memiliki akun GitHub, Anda harus membuat akun baru.
  4. Edit hal-hal sesuai keinginan Anda.

734e51bfc29ee5df.png

  1. Buat clone kode Aplikasi menggunakan
  2. git clone https://github.com/YOUR-GITHUB-USER/YOUR-REPO-NAME
  1. Buka folder project yang di-clone dengan editor favorit Anda. Jika memilih Cloud Shell, Anda dapat melakukannya dengan mengklik "Open Editor" seperti yang ditunjukkan di bawah.

40f5977ea4c1d1cb.png

Anda memiliki semua yang Anda butuhkan dengan Google Cloud Shell Editor seperti yang ditunjukkan pada gambar berikut

a4e5ffb3e9a35e84.png

Hal ini dapat dilakukan secara visual dengan mengklik "Open Folder" dan memilih folder, kemungkinan app-mod-workshop di folder beranda Anda.

3. Modul 1: Membuat Instance SQL

645902e511a432a6.png

Membuat Instance Google Cloud SQL

Aplikasi PHP kita akan terhubung ke database MySQL, sehingga kita perlu mereplikasinya ke Google Cloud untuk migrasi yang lancar. Cloud SQL adalah pilihan yang tepat karena memungkinkan Anda menjalankan database MySQL yang terkelola sepenuhnya di Cloud. Berikut langkah-langkah yang harus diikuti:

  1. Buka halaman Cloud SQL: https://console.cloud.google.com/sql/instances
  2. Klik "Create Instance"
  3. Enable API (jika diperlukan). Proses ini mungkin memerlukan waktu beberapa detik.
  4. Pilih MySQL.
  5. (Kami mencoba memberikan versi termurah, sehingga bertahan lebih lama):
  • Edisi: Enterprise
  • Preset: development (kami mencoba Sandbox dan tidak berhasil)
  • Versi Mysql: 5.7 (wow, versi lama!)
  1. ID instance: pilih appmod-phpapp (jika Anda mengubahnya, jangan lupa untuk mengubah juga skrip dan solusi mendatang).
  2. Password: apa pun yang Anda inginkan, tetapi catat sebagai CLOUDSQL_INSTANCE_PASSWORD
  3. Region: tetap sama seperti yang Anda pilih untuk bagian aplikasi lainnya (misalnya, Milan = europe-west8)
  4. Zonal avail: Single Zone (kita menghemat biaya untuk demo)

Klik tombol Create Instance untuk men-deploy database Cloud SQL; ⌛ proses ini memerlukan waktu sekitar 10 menit⌛. Sementara itu, lanjutkan membaca dokumentasi; Anda juga dapat mulai menyelesaikan modul berikutnya ("Memasukkan Aplikasi PHP ke dalam Container") karena modul tersebut tidak memiliki dependensi pada modul ini di bagian pertama (hingga Anda memperbaiki koneksi DB).

Catatan. Instance ini akan dikenai biaya sekitar $7/hari. Pastikan untuk memisahkannya setelah workshop.

Membuat DB dan Pengguna image_catalog di Cloud SQL

Project Aplikasi dilengkapi dengan folder db/ yang berisi dua file sql:

  1. 01_schema.sql: Berisi kode SQL untuk membuat dua tabel yang berisi data Pengguna dan Gambar.
  2. 02_seed.sql: Berisi kode SQL untuk menyisipkan data ke dalam tabel yang dibuat sebelumnya.

File ini akan digunakan nanti setelah database image_catalog dibuat. Anda dapat melakukannya dengan mengikuti langkah-langkah berikut:

  1. Buka instance Anda dan Klik tab Databases:
  2. klik "Create Database"
  3. beri nama image_catalog (seperti dalam konfigurasi aplikasi PHP).

997ef853e5ebd857.png

Kemudian, kita membuat pengguna database. Dengan ini, kita dapat melakukan autentikasi ke database image_catalog.

  1. Sekarang klik tab Users
  2. Klik "Tambahkan akun pengguna".
  3. Pengguna: mari kita buat:
  • Nama pengguna: appmod-phpapp-user
  • Sandi: Pilih sandi yang dapat Anda ingat, atau klik "buat"
  • Biarkan "Allow any host (%)".
  1. klik ADD.

Buka DB ke IP yang dikenal.

Perhatikan bahwa semua DB di Cloud SQL dibuat 'terisolasi'. Anda harus menyiapkan jaringan secara eksplisit agar dapat diakses.

  1. Klik instance Anda
  2. Buka Menu "Koneksi"
  3. Klik tab "Networking".
  4. Klik di bagian "Authorized networks". Sekarang tambahkan jaringan (yaitu, subnet).
  • Untuk saat ini, mari pilih setelan yang cepat, tetapi TIDAK AMAN agar Aplikasi dapat berfungsi. Anda dapat membatasinya nanti ke IP yang Anda percayai:
  • Nama: "Everyone in the world - INSECURE".
  • Jaringan: "0.0.0.0/0" (Catatan: ini adalah bagian yang TIDAK AMAN!)
  • Klik SELESAI
  1. Klik Simpan.

Anda akan melihat yang seperti ini:

5ccb9062a7071964.png

Catatan. Solusi ini adalah kompromi yang baik untuk menyelesaikan workshop dalam O(jam). Namun, periksa dokumen KEAMANAN untuk membantu mengamankan solusi Anda untuk produksi.

Saatnya menguji koneksi DB.

Mari kita lihat apakah pengguna image_catalog yang telah kita buat sebelumnya berfungsi.

Akses "Cloud SQL Studio" di dalam instance, lalu masukkan Database, Pengguna, dan Sandi yang akan diautentikasi seperti yang ditunjukkan di bawah:

d56765c6154c11a4.png

Setelah masuk, Anda dapat membuka SQL Editor dan melanjutkan ke bagian berikutnya.

Mengimpor Database dari codebase

Gunakan Editor SQL untuk mengimpor tabel image_catalog beserta datanya. Salin kode SQL dari file di repo (01_schema.sql, lalu 02_seed.sql) dan jalankan satu per satu secara berurutan.

Setelah ini, Anda akan mendapatkan dua tabel di image_catalog, yaitu users dan images seperti yang ditunjukkan di bawah:

65ba01e4c6c2dac0.png

Anda dapat mengujinya dengan menjalankan perintah berikut di editor: select * from images;

Pastikan juga untuk mencatat alamat IP Publik instance Cloud SQL, Anda akan membutuhkannya nanti. Untuk mendapatkan IP, buka halaman utama instance Cloud SQL di halaman Overview. (Overview > Connect to this Instance > Public IP Address).

4. Modul 2: Memasukkan Aplikasi PHP ke dalam Container

e7f0e9979d8805f5.png

Kami ingin membangun aplikasi ini untuk cloud.

Artinya, kode dikemas dalam semacam file ZIP yang berisi semua info untuk menjalankannya di Cloud.

Ada beberapa cara untuk mengemasnya:

  • Docker. Sangat populer, tetapi cukup rumit untuk disiapkan dengan benar.
  • Buildpack. Kurang populer, tetapi cenderung 'menebak otomatis' apa yang harus di-build dan dijalankan. Sering kali, hal ini berhasil.

Dalam konteks workshop ini, kami akan mengasumsikan bahwa Anda menggunakan Docker.

Jika Anda memilih untuk menggunakan Cloud Shell, sekarang saatnya untuk membukanya kembali (klik di kanan atas konsol Cloud).

ec6a6b90b39e03e.png

Tindakan ini akan membuka shell yang praktis di bagian bawah halaman, tempat Anda seharusnya telah melakukan fork kode pada langkah penyiapan.

6999b906c0dedeb7.png

Docker

Jika Anda ingin memiliki kontrol, ini adalah solusi yang tepat untuk Anda. Hal ini masuk akal jika Anda perlu mengonfigurasi library tertentu, dan memasukkan perilaku tertentu yang tidak jelas (chmod dalam upload, file yang dapat dieksekusi non-standar di aplikasi Anda, ..)

Karena pada akhirnya kita ingin men-deploy aplikasi dalam container ke Cloud Run, lihat dokumentasi berikut. Bagaimana Anda akan melakukan backport dari PHP 8 ke PHP 5.7? Mungkin Anda bisa menggunakan Gemini untuk melakukannya. Atau, Anda dapat menggunakan versi siap pakai ini:

# Use the official PHP image: https://hub.docker.com/_/php
FROM php:5.6-apache

# Configure PHP for Cloud Run.
# Precompile PHP code with opcache.
# Install PHP's extension for MySQL
RUN docker-php-ext-install -j "$(nproc)" opcache mysqli pdo pdo_mysql && docker-php-ext-enable pdo_mysql

RUN set -ex; \
  { \
    echo "; Cloud Run enforces memory & timeouts"; \
    echo "memory_limit = -1"; \
    echo "max_execution_time = 0"; \
    echo "; File upload at Cloud Run network limit"; \
    echo "upload_max_filesize = 32M"; \
    echo "post_max_size = 32M"; \
    echo "; Configure Opcache for Containers"; \
    echo "opcache.enable = On"; \
    echo "opcache.validate_timestamps = Off"; \
    echo "; Configure Opcache Memory (Application-specific)"; \
    echo "opcache.memory_consumption = 32"; \
  } > "$PHP_INI_DIR/conf.d/cloud-run.ini"

# Copy in custom code from the host machine.
WORKDIR /var/www/html

COPY . .

# Setup the PORT environment variable in Apache configuration files: https://cloud.google.com/run/docs/reference/container-contract#port
ENV PORT=8080

# Tell Apache to use 8080 instead of 80.
RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf

# Note: This is quite insecure and opens security breaches. See last chapter for hardening ideas.
# Uncomment at your own risk:
#RUN chmod 777 /var/www/html/uploads/

# Configure PHP for development.
# Switch to the production php.ini for production operations.
# RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
# https://github.com/docker-library/docs/blob/master/php/README.md#configuration
RUN mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"

# Expose the port
EXPOSE 8080

Versi Dockerfile terbaru tersedia di sini.

Untuk menguji aplikasi secara lokal, kita perlu mengubah file config.php sedemikian rupa sehingga Aplikasi PHP kita akan terhubung dengan db MYSQL yang tersedia di Google Cloud SQL. Berdasarkan apa yang telah Anda siapkan sebelumnya, lengkapi bagian yang kosong:

<?php
// Database configuration
$db_host = '____________';
$db_name = '____________';
$db_user = '____________';
$db_pass = '____________';

try {
    $pdo = new PDO("mysql:host=$db_host;dbname=$db_name", $db_user, $db_pass);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
    die("Errore di connessione: " . $e->getMessage());
}

session_start();
?>
  • DB_HOST adalah alamat IP publik Cloud SQL, Anda dapat menemukannya di konsol SQL:

bd27071bf450a8d0.png

  • DB_NAME tidak boleh diubah: image_catalog
  • DB_USER harus appmod-phpapp-user
  • DB_PASS adalah sesuatu yang Anda pilih. Siapkan dalam tanda kutip tunggal dan escape sesuai kebutuhan.

Selain itu, jangan ragu untuk menerjemahkan beberapa bagian dalam bahasa 🇮🇹 Italia ke bahasa Indonesia dengan bantuan Gemini.

Oke, setelah Anda memiliki Dockerfile dan mengonfigurasi Aplikasi PHP untuk terhubung ke DB, mari kita coba!

Instal docker jika Anda belum memilikinya (link). Anda tidak memerlukan ini jika menggunakan Cloud Shell (keren, bukan?).

Sekarang, coba bangun dan jalankan Aplikasi PHP dalam Container Anda dengan perintah build dan run docker yang sesuai.

# Build command - don't forget the final . This works if Dockerfile is inside the code folder:
$ docker build -t my-php-app-docker .   

# Local Run command: most likely ports will be 8080:8080
$ docker run -it -p <CONTAINER_PORT>:<LOCAL_MACHINE_PORT> my-php-app-docker

Jika semuanya berfungsi, Anda akan dapat melihat halaman web berikut saat terhubung ke host lokal. Sekarang aplikasi Anda berjalan di port 8080, klik ikon "Web preview" (browser dengan mata), lalu Preview on port 8080 (atau "Change port" untuk port lainnya)

33a24673f4550454.png

Menguji hasil di browser Anda

Sekarang aplikasi Anda akan terlihat seperti ini:

2718ece96b1f18b6.png

Dan jika Anda login dengan Admin/admin123, Anda akan melihat tampilan seperti ini.

68b62048c2e86aea.png

Bagus. Selain teks bahasa Italia, semuanya berfungsi. 🎉🎉🎉

Jika dockerization Anda baik, tetapi kredensial DB salah, Anda mungkin mendapatkan pesan seperti ini:

e22f45b79bab86e1.png

Coba lagi, Anda hampir berhasil.

Menyimpan ke Artifact Registry [opsional]

Sekarang, Anda seharusnya sudah memiliki aplikasi PHP dalam container yang berfungsi dan siap di-deploy ke cloud. Selanjutnya, kita memerlukan tempat di cloud untuk menyimpan image Docker dan membuatnya dapat diakses untuk deployment ke layanan Google Cloud seperti Cloud Run. Solusi penyimpanan ini disebut Artifact Registry, layanan Google Cloud yang terkelola sepenuhnya dan dirancang untuk menyimpan artefak aplikasi, termasuk image container Docker, paket Maven, modul npm, dan lainnya.

Mari kita buat repositori di Google Cloud Artifact Registry menggunakan tombol yang sesuai.

e1123f0c924022e6.png

Pilih nama yang valid, format, dan region yang sesuai untuk menyimpan artefak.

4e516ed209c470ee.png

Kembali ke tag lingkungan pengembangan lokal Anda dan kirim image container Aplikasi ke repositori Artifact Registry yang baru dibuat. Selesaikan perintah berikut untuk melakukannya.

  • docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]
  • docker push TARGET_IMAGE[:TAG]

Hasilnya akan terlihat seperti screenshot berikut.

1e498feb4e88be9f.png

Hore 🎉🎉🎉 Anda dapat melanjutkan ke level berikutnya. Sebelum itu, mungkin luangkan waktu 2 menit untuk mencoba upload/login/logout dan membiasakan diri dengan endpoint aplikasi.Anda akan membutuhkannya nanti.

Kemungkinan error

Jika Anda mendapatkan error containerization, coba gunakan Gemini untuk menjelaskan dan memperbaiki error, dengan memberikan:

  • Dockerfile Anda saat ini
  • Error yang diterima
  • [jika diperlukan] kode PHP yang sedang dieksekusi.

Izin Upload. Coba juga endpoint /upload.php dan coba upload gambar. Anda mungkin mendapatkan error di bawah. Jika demikian, Anda harus melakukan beberapa perbaikan chmod/chown di Dockerfile.

Warning: move_uploaded_file(uploads/image (3).png): failed to open stream: Permission denied in /var/www/html/upload.php on line 11

PDOException "could not find driver" (atau "Errore di connessione: could not find driver"). Pastikan Dockerfile Anda memiliki library PDO yang tepat untuk mysql (pdo_mysql), agar dapat terhubung ke DB. Dapatkan inspirasi dari solusi di sini.

Unable to forward your request to a backend. Couldn't connect to a server on port 8080. Artinya, Anda mungkin mengekspos port yang salah. Pastikan Anda mengekspos port yang benar-benar digunakan Apache/Nginx untuk menyajikan konten. Hal ini tidaklah mudah. Jika memungkinkan, coba buat port tersebut menjadi 8080 (memudahkan penggunaan Cloud Run). Jika Anda ingin mempertahankan port 80 (misalnya, karena Apache menginginkannya demikian), gunakan perintah lain untuk menjalankannya:

$ docker run -it -p 8080:80 # force 80

# Use the PORT environment variable in Apache configuration files.

# https://cloud.google.com/run/docs/reference/container-contract#port

RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf

5. Modul 3: Men-deploy Aplikasi ke Cloud Run

9ffca42774f6c5d1.png

Mengapa Cloud Run?

Pertanyaan yang bagus. Beberapa tahun lalu, Anda pasti akan memilih Google App Engine.

Singkatnya, saat ini, Cloud Run memiliki stack teknologi yang lebih baru, lebih mudah di-deploy, lebih murah, dan dapat diperkecil skalanya hingga 0 saat Anda tidak menggunakannya. Dengan fleksibilitasnya untuk menjalankan container stateless apa pun dan integrasinya dengan berbagai layanan Google Cloud, Cloud Run ideal untuk men-deploy microservice dan aplikasi modern dengan overhead minimal dan efisiensi maksimum.

Lebih spesifiknya, Cloud Run adalah platform terkelola sepenuhnya dari Google Cloud yang memungkinkan Anda menjalankan aplikasi dalam container stateless di lingkungan serverless. Layanan ini otomatis menangani semua infrastruktur, melakukan penskalaan dari nol untuk memenuhi traffic yang masuk dan menurunkan skala saat tidak ada aktivitas, sehingga hemat biaya dan efisien. Cloud Run mendukung bahasa atau library apa pun asalkan dipaketkan dalam container, sehingga memberikan fleksibilitas yang tinggi dalam pengembangan. Cloud Run terintegrasi dengan baik dengan layanan Google Cloud lainnya dan cocok untuk membangun microservice, API, situs, dan aplikasi berbasis peristiwa tanpa perlu mengelola infrastruktur server.

Prasyarat

Untuk menyelesaikan tugas ini, Anda harus menginstal gcloud di komputer lokal Anda. Jika tidak, lihat petunjuknya di sini. Namun, jika Anda menggunakan Google Cloud Shell, tidak ada tindakan yang perlu dilakukan.

Sebelum men-deploy...

Jika Anda bekerja di lingkungan lokal, lakukan autentikasi ke Google Cloud dengan perintah berikut

  • $ gcloud auth login –update-adc # not needed in Cloud Shell

Tindakan ini akan mengautentikasi Anda melalui login OAuth di browser. Pastikan Anda login melalui Chrome dengan pengguna yang sama (misalnya vattelapesca@gmail.com) yang login ke Google Cloud dengan penagihan diaktifkan.

Aktifkan Cloud Run API dengan perintah berikut:

  • $ gcloud services enable run.googleapis.com cloudbuild.googleapis.com

Pada tahap ini, semuanya sudah siap untuk di-deploy ke Cloud Run.

Men-deploy Aplikasi ke Cloud Run melalui gcloud

Perintah yang memungkinkan Anda men-deploy Aplikasi di Cloud Run adalah gcloud run deploy. Ada beberapa opsi yang dapat ditetapkan untuk mencapai sasaran Anda. Kumpulan opsi minimum (yang dapat Anda berikan melalui command line, atau alat akan meminta Anda dengan perintah interaktif) adalah sebagai berikut:

  1. Nama Layanan Cloud Run yang ingin Anda deploy untuk Aplikasi Anda. Layanan Cloud Run akan menampilkan URL yang menyediakan endpoint ke Aplikasi Anda.
  2. Region Google Cloud tempat Aplikasi Anda akan dijalankan. (--region REGION)
  3. Image Container yang menggabungkan Aplikasi Anda.
  4. Variabel Lingkungan yang perlu digunakan Aplikasi Anda selama eksekusinya.
  5. Flag Allow-Unauthenticated yang mengizinkan semua orang mengakses Aplikasi Anda tanpa autentikasi lebih lanjut.

Lihat dokumentasi (atau scroll ke bawah untuk mengetahui kemungkinan solusi) guna melihat cara menerapkan opsi ini ke command line Anda.

Deployment akan memerlukan waktu beberapa menit. Jika semuanya sudah benar, Anda akan melihat tampilan seperti ini di Konsol Google Cloud.

ef1029fb62f8de81.pngf7191d579c21ca3e.png

Klik URL yang disediakan oleh Cloud Run dan uji Aplikasi Anda. Setelah diautentikasi, Anda akan melihat tampilan seperti ini.

d571a90cd5a373f9.png

"gcloud run deploy" tanpa argumen

Anda mungkin telah memperhatikan bahwa gcloud run deploy mengajukan pertanyaan yang tepat dan mengisi bagian yang kosong yang Anda tinggalkan. Ini hebat sekali!

Namun, dalam beberapa modul, kita akan menambahkan perintah ini ke pemicu Cloud Build sehingga kita tidak dapat menggunakan pertanyaan interaktif. Kita perlu mengisi setiap opsi dalam perintah. Jadi, kamu ingin membuat gcloud run deploy --option1 blah --foo bar --region your-fav-region emas. Bagaimana Anda melakukannya?

  1. ulangi langkah 2-3-4 hingga gcloud berhenti mengajukan pertanyaan:
  2. [LOOP] gcloud run deploy dengan opsi yang ditemukan sejauh ini
  3. [LOOP] systems ask for option X
  4. [LOOP] Search in public docs how to set up X from CLI adding option --my-option [my-value].
  5. Kembali ke langkah 2 sekarang, kecuali jika gcloud selesai tanpa pertanyaan lebih lanjut.
  6. Perintah gcloud run deploy BLAH BLAH BLAH ini keren banget! Simpan perintah di suatu tempat, Anda akan memerlukannya nanti untuk langkah Cloud Build.

Solusi yang mungkin dapat dilakukan ada di sini. Dokumen tersedia di sini.

Hore 🎉🎉🎉 Anda berhasil men-deploy Aplikasi di Google Cloud dan menyelesaikan langkah pertama Modernisasi.

6. Modul 4: Sandi Bersih dengan Secret Manager

95cd57b03b4e3c73.png

Pada langkah sebelumnya, kita berhasil men-deploy dan menjalankan Aplikasi di Cloud Run. Namun, kami melakukannya dengan praktik keamanan yang buruk: memberikan beberapa secret dalam cleartext.

Iterasi pertama: Update config.php Anda untuk menggunakan ENV

Anda mungkin memperhatikan bahwa kami memasukkan sandi DB langsung ke dalam kode di file config.php. Hal ini tidak masalah untuk tujuan pengujian dan untuk melihat apakah Aplikasi berfungsi. Namun, Anda tidak dapat meng-commit/menggunakan kode tersebut di lingkungan produksi. Sandi (dan parameter koneksi DB lainnya) harus dibaca secara dinamis dan diberikan ke Aplikasi saat runtime. Ubah file config.php agar membaca parameter db dari variabel ENV. Jika gagal, sebaiknya tetapkan nilai default. Hal ini berguna jika Anda gagal memuat ENV, sehingga output halaman akan memberi tahu Anda jika nilai default digunakan. Isi bagian yang kosong dan ganti kode di config.php.

<?php
// Database configuration with ENV variables. Set default values as well 
$db_host = getenv('DB_HOST') ?: 'localhost';
$db_name = getenv('DB_NAME') ?: 'image_catalog';
$db_user = getenv('DB_USER') ?: 'appmod-phpapp-user';
$db_pass = getenv('DB_PASS') ?: 'wrong_password';
// Note getenv() is PHP 5.3 compatible
try {
    $pdo = new PDO("mysql:host=$db_host;dbname=$db_name", $db_user, $db_pass);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
    die("Errore di connessione: " . $e->getMessage());
}

session_start();
?>

Karena Aplikasi Anda di-container-kan, Anda perlu menyediakan cara untuk menyediakan variabel ENV ke Aplikasi. Hal ini dapat dilakukan dengan beberapa cara:

  • Pada waktu build, di Dockerfile. Tambahkan 4 parameter ke Dockerfile sebelumnya menggunakan sintaksis ENV DB_VAR=ENV_VAR_VALUE. Tindakan ini akan menyiapkan nilai default yang dapat diganti saat runtime. Misalnya, 'DB_NAME' dan 'DB_USER' dapat ditetapkan di sini dan tidak di tempat lain.
  • Pada waktu run. Anda dapat menyiapkan variabel ini untuk Cloud Run, baik dari CLI maupun dari UI. Ini adalah tempat yang tepat untuk menempatkan keempat variabel Anda (kecuali jika Anda ingin mempertahankan setelan default di Dockerfile).

Di localhost, Anda mungkin ingin menempatkan variabel ENV dalam file .env (periksa folder solutions).

Pastikan juga .env ditambahkan ke .gitignore : Anda tidak ingin mengirim secret ke GitHub.

echo .env >> .gitignore

Setelah itu, Anda dapat menguji instance secara lokal:

docker run -it -p 8080:8080 --env-file .env my-php-app-docker

Sekarang Anda telah mencapai hal berikut:

  1. Aplikasi Anda akan membaca variabel secara dinamis dari ENV Anda
  2. Anda meningkatkan keamanan karena telah menghapus sandi DB dari kode Anda)

Sekarang Anda dapat men-deploy revisi baru ke Cloud Run. Mari kita buka UI dan tetapkan variabel lingkungan secara manual:

  • Buka https://console.cloud.google.com/run
  • Klik aplikasi Anda
  • Klik "Edit and deploy a new revision"
  • Di tab pertama "Container(s)", klik tab bawah "Variables and secrets"
  • Klik "+ Tambahkan variabel" dan tambahkan semua variabel yang diperlukan. Anda akan melihat tampilan seperti ini:

7a5fbfa448544d3.pngf2780c35585388ca.png

Apakah ini sempurna? Tidak. PASS Anda masih dapat dilihat oleh sebagian besar operator. Hal ini dapat dimitigasi dengan Google Cloud Secret Manager.

Iterasi kedua: Secret Manager

Sandi Anda telah menghilang dari kode Anda sendiri: berhasil! Tapi tunggu, apakah kita sudah aman?

Sandi Anda masih dapat dilihat oleh siapa pun yang memiliki akses ke Konsol Google Cloud. Bahkan, jika Anda mengakses file deployment YAML Cloud Run, Anda akan dapat mengambilnya. Atau, jika Anda mencoba mengedit atau men-deploy revisi Cloud Run baru, sandi akan terlihat di bagian Variables & Secrets seperti yang ditunjukkan dalam screenshot di bawah.

Secret Manager Google Cloud adalah layanan terpusat yang aman untuk mengelola informasi sensitif seperti kunci API, sandi, sertifikat, dan secret lainnya.

Dengan Secret Manager, Anda dapat menyimpan, mengelola, dan mengakses secret dengan izin yang mendetail dan enkripsi yang kuat. Secret Manager terintegrasi dengan Identity and Access Management (IAM) Google Cloud, sehingga Anda dapat mengontrol siapa yang dapat mengakses secret tertentu, memastikan keamanan data, dan kepatuhan terhadap peraturan.

Layanan ini juga mendukung rotasi dan pembuatan versi secret otomatis, sehingga menyederhanakan pengelolaan siklus proses secret dan meningkatkan keamanan dalam aplikasi di seluruh layanan Google Cloud.

Untuk mengakses Secret Manager, buka menu tiga garis ke layanan Security dan temukan di bagian Perlindungan Data seperti yang ditunjukkan pada screenshot di bawah.

6df83a1c3cb757f6.png

Aktifkan Secret Manager API setelah Anda berada di sana seperti yang ditunjukkan pada gambar berikut.

a96c312e2c098db1.png

  • Sekarang klik "Create a secret": Beri nama yang sesuai:
  • Nama: php-amarcord-db-pass
  • Secret value: ‘your DB password' (abaikan bagian "upload file").
  • beri anotasi pada link rahasia ini, akan terlihat seperti projects/123456789012/secrets/php-amarcord-db-pass. Ini adalah pointer unik ke secret Anda (Untuk Terraform, Cloud Run, dan lainnya). Nomor tersebut adalah nomor project unik Anda.

Tips: Coba gunakan konvensi penamaan yang konsisten untuk secret Anda, dengan mengkhususkan dari kiri ke kanan, misalnya: cloud-devrel-phpamarcord-dbpass

  • Organisasi (dengan perusahaan)
  • Tim (dalam organisasi)
  • Aplikasi (dalam tim)
  • Nama variabel (dalam aplikasi)

Dengan begitu, Anda akan memiliki ekspresi reguler yang mudah untuk menemukan semua rahasia untuk satu aplikasi.

Membuat revisi Cloud Run baru

Setelah memiliki Secret baru, kita perlu menghapus variabel DB_PASS ENV dan menggantinya dengan Secret baru. Jadi:

  • Akses ke Cloud Run menggunakan Konsol Google Cloud
  • Pilih aplikasi.
  • Klik "Edit & Deploy a New Revision"
  • temukan tab "Variables & Secrets".
  • Gunakan tombol "+ Reference a Secret" untuk mereset variabel ENV DB_PASS.
  • Gunakan "DB_PASS" yang sama untuk Secret yang direferensikan dan gunakan versi terbaru.

9ed4e35be7654dcb.png

Setelah selesai, Anda akan mendapatkan error berikut

da0ccd7af39b04ed.png

Coba cari tahu cara memperbaikinya. Untuk mengatasinya, Anda perlu mengakses bagian IAM & Admin dan mengubah izin yang diberikan. Selamat melakukan proses debug.

Setelah Anda mengetahuinya, kembali ke Cloud Run dan deploy ulang revisi baru. Hasilnya akan terlihat seperti gambar berikut:

e89f9ca780169b6b.png

Tips: Konsol Developer (UI) sangat baik dalam menunjukkan masalah izin. Luangkan waktu untuk menjelajahi semua link untuk entity Cloud Anda.

7. Modul 5: Menyiapkan CI/CD dengan Cloud Build

ba49b033c11be94c.png

Mengapa Pipeline CI/CD?

Sekarang, Anda seharusnya sudah mengetik gcloud run deploy beberapa kali, mungkin menjawab pertanyaan yang sama berulang kali.

Lelah men-deploy aplikasi secara manual dengan gcloud run deploy? Bukankah akan sangat bagus jika aplikasi Anda dapat otomatis di-deploy setiap kali Anda mengirim perubahan baru ke repositori Git?

Untuk menggunakan pipeline CI/CD, Anda memerlukan dua hal:

  1. Repositori Git Pribadi: Untungnya, Anda seharusnya sudah melakukan fork repositori workshop ke akun GitHub Anda di Langkah 2. Jika belum, kembali dan selesaikan langkah tersebut. Repositori yang di-fork akan terlihat seperti ini: https://github.com/<YOUR_GITHUB_USER>/app-mod-workshop
  2. Cloud Build. Layanan yang luar biasa dan murah ini memungkinkan Anda mengonfigurasi otomatisasi build untuk hampir semua hal: Terraform, aplikasi dalam docker, ..

Bagian ini akan berfokus pada penyiapan Cloud Build.

Masuk ke Cloud Build.

Kita akan menggunakan Cloud Build untuk melakukannya:

  • membangun sumber Anda (dengan Dockerfile). Anggap ini sebagai "file .zip besar" yang berisi semua yang Anda perlukan untuk membangun dan menjalankannya ("artefak build" Anda).
  • mengirim artefak ini ke Artifact Registry (AR).
  • Kemudian, lakukan deployment dari AR ke Cloud Run untuk aplikasi "php-amarcord"
  • Tindakan ini akan membuat versi baru ("revisi") dari aplikasi yang ada (anggap saja sebagai lapisan dengan kode baru) dan kami akan mengonfigurasinya untuk mengalihkan traffic ke versi baru jika push berhasil.

Berikut adalah contoh beberapa build untuk aplikasi php-amarcord saya:

f30f42d4571ad5e2.png

Bagaimana cara kami melakukan semua ini?

  1. Dengan membuat satu file YAML yang sempurna: cloudbuild.yaml
  2. Dengan membuat pemicu Cloud Build.
  3. Dengan menghubungkan ke repositori GitHub kami melalui UI Cloud Build.

Membuat pemicu (dan Menghubungkan Repositori)

  • Buka https://console.cloud.google.com/cloud-build/triggers
  • Klik "Create Trigger".
  • Kompilasi:
  • Nama: Sesuatu yang bermakna seperti on-git-commit-build-php-app
  • Event: Push to branch
  • Source: "Connect new repository" teks alternatif
  • Tindakan ini akan membuka jendela di sebelah kanan: "Connect repository"
  • Penyedia sumber: "Github" (pertama)
  • "Terus"
  • Authenticate akan membuka jendela di GitHub untuk melakukan autentikasi silang. Ikuti alurnya dan bersabarlah. Jika Anda memiliki banyak repositori, proses ini mungkin memerlukan waktu beberapa saat.
  • "Select repo" Pilih akun/repositori Anda dan centang bagian "I understand...".
  • Jika Anda mendapatkan error: Aplikasi GitHub tidak diinstal di repositori mana pun, lanjutkan dengan mengklik "Install Google Cloud Build" dan ikuti petunjuknya.
  • 23e0e0f1219afea3.pngKlik Hubungkan
  • bafd904ec07122d2.png
  • Tepat! Repositori Anda kini terhubung.
  • Kembali ke bagian Pemicu....
  • Konfigurasi: Dideteksi otomatis (*)
  • Advanced: Pilih akun layanan "[PROJECT_NUMBER]- compute@developer.gserviceaccount.com"
  • xxxxx adalah project ID Anda
  • Akun layanan komputasi default cukup untuk pendekatan lab - jangan gunakan dalam produksi. ( Pelajari lebih lanjut).
  • biarkan yang lainnya apa adanya.
  • Klik tombol "Create".

(*) Ini adalah cara paling sederhana karena memeriksa Dockerfile atau cloudbuild.yaml. Namun, cloudbuild.yaml memberi Anda kemampuan nyata untuk memutuskan apa yang harus dilakukan pada langkah mana.

Aku punya kekuatan!

Sekarang, pemicu tidak akan berfungsi kecuali jika Anda memberi akun layanan Cloud Build (apa itu akun layanan? Email "robot" yang bertindak atas nama Anda untuk suatu tugas - dalam hal ini membangun sesuatu di Cloud!).

SA Anda akan gagal membangun dan men-deploy kecuali jika Anda memberinya wewenang untuk melakukannya. Untungnya, caranya mudah.

  • buka "Cloud Build" > " Settings".
  • Akun layanan "[PROJECT_NUMBER]- compute@developer.gserviceaccount.com"
  • Centang kotak berikut:
  • Cloud Run
  • Secret Manager
  • Akun Layanan
  • Cloud Build
  • Centang juga "Set as preferred service account"

8715acca72286a46.png

Di mana YAML Cloud Build?

Sebaiknya Anda meluangkan waktu untuk membuat YAML Cloud Build Anda sendiri.

Namun, jika Anda tidak punya waktu, atau tidak ingin meluangkan waktu, Anda bisa mendapatkan inspirasi di folder solusi ini: .solutions

Sekarang Anda dapat mengirim perubahan ke GitHub dan mengamati Cloud Build melakukan tugasnya.

Menyiapkan Cloud Build bisa jadi rumit. Perkirakan beberapa diskusi melalui:

  • Memeriksa log di https://console.cloud.google.com/cloud-build/builds;region=global
  • Menemukan error.
  • Memperbaiki kode, dan mengeluarkan kembali git commit/git push.
  • Terkadang error tidak ada dalam kode, tetapi dalam beberapa konfigurasi. Jika demikian, Anda dapat mengeluarkan build baru dari UI (cloud build > "Triggers" > Run)

97acd16980a144ab.png

Perhatikan bahwa jika Anda menggunakan solusi ini, masih ada beberapa hal yang harus dilakukan. Misalnya, Anda perlu menetapkan variabel ENV untuk endpoint dev/prod yang baru dibuat:

3da8723e4ff80c0a.png

Anda dapat melakukannya dengan dua cara:

  • Melalui UI - dengan menyetel variabel ENV lagi
  • Melalui CLI dengan membuat skrip yang "sempurna" untuk Anda. Contohnya dapat ditemukan di sini: gcloud-run-deploy.sh . Anda perlu menyesuaikan beberapa hal, misalnya endpoint dan nomor project; Anda dapat menemukan nomor project di Cloud Overview.

How do i commit code to github?

Workshop ini tidak membahas cara terbaik untuk git push ke GitHub. Namun, jika Anda mengalami masalah dan berada di Cloud Shell, ada dua cara:

  1. CLI. Tambahkan kunci ssh secara lokal dan tambahkan remote dengan git@github.com:YOUR_USER/app-mod-workshop.git (bukan http)
  2. VSCode. Jika menggunakan editor Cloud Shell, Anda dapat menggunakan tab Source control (ctrl-shift-G), klik "sync changes", lalu ikuti petunjuknya. Anda akan dapat mengautentikasi akun GitHub Anda ke VS Code dan melakukan pull/push dari sana dengan mudah.

f0d53f839c7fa3b6.png

Jangan lupa untuk git add clodubuild.yaml di antara file lainnya, atau file tersebut tidak akan berfungsi.

"Paritas dev/prod" Mendalam vs Dangkal [opsional]

Jika Anda menyalin versi model dari sini, Anda akan memiliki dua versi DEV dan PROD yang identik. Hal ini menarik, dan sejalan dengan aturan 10 dari Aplikasi Dua Belas Faktor.

Namun, kita menggunakan dua endpoint Web yang berbeda agar aplikasi mengarah ke Database yang sama. Hal ini sudah cukup untuk workshop; namun, dalam kehidupan nyata, Anda perlu meluangkan waktu untuk membuat lingkungan prod yang tepat. Artinya, Anda harus memiliki dua database (satu untuk dev dan satu untuk prod) serta memilih tempat untuk menempatkannya untuk disaster recovery/ketersediaan tinggi. Hal ini berada di luar cakupan workshop ini, tetapi dapat menjadi bahan pertimbangan.

Jika Anda memiliki waktu untuk melakukan versi produksi yang "mendalam", harap ingat semua resource yang perlu Anda duplikasi, seperti:

  • Database Cloud SQL (dan mungkin instance SQL).
  • Bucket GCS
  • Cloud Function.
  • Anda dapat menggunakan Gemini 1.5 Flash sebagai model dalam pengembangan (lebih murah, lebih cepat), dan Gemini 1.5 Pro (lebih canggih).

Secara umum, setiap kali Anda melakukan sesuatu pada aplikasi, pikirkan secara kritis: apakah produksi harus memiliki nilai yang sama atau tidak? Jika tidak, duplikasi upaya Anda. Hal ini tentu jauh lebih mudah dilakukan dengan Terraform, karena Anda dapat memasukkan lingkungan (-dev, -prod) sebagai akhiran ke resource Anda.

8. Modul 6: Berpindah ke Google Cloud Storage

a680e0f287dd2dfb.png

Penyimpanan

dc3a4b8ea92aaef6.png

Saat ini, aplikasi menyimpan status dalam container Docker. Jika mesin rusak, aplikasi meledak, atau jika Anda mendorong revisi baru, revisi baru akan dijadwalkan, dengan penyimpanan baru yang kosong: 🙈

Bagaimana cara memperbaikinya? Ada beberapa pendekatan.

  1. Menyimpan gambar di DB. Itulah yang akhirnya saya lakukan dengan aplikasi PHP saya sebelumnya. Ini adalah solusi paling sederhana karena tidak menambah kompleksitas. Namun, hal ini pasti akan menambah latensi dan beban ke DB Anda.
  2. Migrasikan aplikasi Cloud Run Anda ke solusi yang mendukung penyimpanan: GCE + Persistent disk? Mungkin GKE + Storage? Catatan: apa yang Anda peroleh dalam kontrol, Anda kehilangan dalam kelincahan.
  3. Pindah ke GCS. Google Cloud Storage menawarkan Penyimpanan terbaik di kelasnya untuk seluruh Google Cloud dan merupakan solusi yang paling sesuai dengan Cloud. Namun, kita harus bersusah payah menggunakan library PHP. Apakah kita memiliki library PHP 5.7 untuk GCS? Apakah PHP 5.7 mendukung Composer (sepertinya PHP 5.3.2 adalah versi paling awal yang didukung oleh Composer)?
  4. Mungkin menggunakan sidecar docker?
  5. Atau, gunakan Pemasangan Volume Cloud Run GCS. Kedengarannya luar biasa.

🤔 Memigrasikan penyimpanan (uraian)

[Open Ended] Dalam latihan ini, kami ingin Anda menemukan solusi untuk memindahkan gambar Anda dengan cara yang dipertahankan dalam beberapa cara.

Uji penerimaan

Saya tidak ingin memberi tahu Anda solusinya, tetapi saya ingin hal ini terjadi:

  1. Anda mengupload newpic.jpg. Anda melihatnya di aplikasi.
  2. Anda mengupgrade aplikasi ke versi baru.
  3. newpic.jpg masih ada, terlihat.

💡 Solusi yang mungkin (Pemasangan Volume Cloud Run GCS)

Ini adalah solusi yang sangat elegan yang memungkinkan kita mencapai upload file stateful tanpa menyentuh kode SAMA SEKALI (selain menampilkan deskripsi gambar, tetapi itu sepele dan hanya untuk kepuasan visual).

Dengan begitu, Anda dapat memasang folder dari Cloud Run ke GCS, sehingga:

  1. Semua upload ke GCS akan terlihat di aplikasi Anda.
  2. Semua upload ke aplikasi Anda akan diupload ke GCS
  3. Keajaiban akan terjadi pada objek yang diupload di GCS (bab 7).

Catatan. Baca detail FUSE. Hal ini TIDAK boleh dilakukan jika performa menjadi masalah.

Membuat bucket GCS

GCS adalah layanan penyimpanan Google Cloud yang selalu tersedia. Layanan ini telah teruji dan digunakan oleh setiap layanan GCP yang memerlukan penyimpanan.

Perhatikan bahwa Cloud Shell mengekspor PROJECT_ID sebagai GOOGLE_CLOUD_PROJECT:

$ export PROJECT_ID=$GOOGLE_CLOUD_PROJECT

#!/bin/bash

set -euo pipefail

# Your Cloud Run Service Name, eg php-amarcord-dev
SERVICE_NAME='php-amarcord-dev'
BUCKET="${PROJECT_ID}-public-images"
GS_BUCKET="gs://${BUCKET}"

# Create bucket
gsutil mb -l "$GCP_REGION" -p "$PROJECT_ID" "$GS_BUCKET/"

# Copy original pictures there - better if you add an image of YOURS before.
gsutil cp ./uploads/*.png "$GS_BUCKET/"

Mengonfigurasi Cloud Run untuk memasang bucket di folder /uploads/

Sekarang mari kita beralih ke bagian yang elegan. Kita membuat volume php_uploads dan menginstruksikan Cloud Run untuk melakukan pemasangan FUSE di MOUNT_PATH (seperti /var/www/html/uploads/):

#!/bin/bash

set -euo pipefail

# .. keep variables from previous script..

# Uploads folder within your docker container.
# Tweak it for your app code.
MOUNT_PATH='/var/www/html/uploads/'

# Inject a volume mount to your GCS bucket in the right folder.
gcloud --project "$PROJECT_ID" beta run services update "$SERVICE_NAME" \
    --region $GCP_REGION \
    --execution-environment gen2 \
    --add-volume=name=php_uploads,type=cloud-storage,bucket="$BUCKET"  \
    --add-volume-mount=volume=php_uploads,mount-path="$MOUNT_PATH"

Sekarang, ulangi langkah ini untuk semua endpoint yang ingin Anda arahkan ke Cloud Storage.

Anda juga dapat mencapai hal yang sama dari UI

  1. Di tab "Volumes", buat Pemasangan Volume yang mengarah ke bucket Anda, dengan jenis "Cloud Storage bucket", misalnya dengan nama "php_uploads".
  2. Di bagian Container > Volume Mounts, pasang volume yang baru saja Anda buat di titik volume yang diminta oleh aplikasi Anda. Hal ini bergantung pada dockerfile, tetapi mungkin terlihat seperti var/www/html/uploads/ .

Apa pun caranya, jika berhasil, mengedit revisi Cloud Run baru akan menampilkan tampilan seperti ini:

6c2bb98fc1b0e077.png

Sekarang, uji aplikasi baru dengan mengupload satu gambar baru ke endpoint /upload.php.

Gambar akan mengalir lancar di GCS tanpa menulis satu baris PHP pun:

70032b216afee2d7.png

Apa yang baru saja terjadi?

Sesuatu yang sangat ajaib telah terjadi.

Aplikasi lama dengan kode lama masih berfungsi. Stack baru yang dimodernisasi memungkinkan kita menyimpan semua gambar/foto di aplikasi kita dengan nyaman di Cloud Bucket stateful. Sekarang, tidak ada batasan:

  • Ingin mengirim email setiap kali ada gambar dengan label "dangerous" atau "nude"? Anda dapat melakukannya tanpa menyentuh kode PHP.
  • Ingin menggunakan model Multimodal Gemini setiap kali ada gambar yang masuk untuk mendeskripsikannya, dan mengupload DB dengan deskripsinya? Anda dapat melakukannya tanpa menyentuh kode PHP. Kamu tidak percaya padaku? Lanjutkan membaca di bab 7.

Kita baru saja membuka ruang peluang yang besar di sini.

9. Modul 7: Memberdayakan Aplikasi Anda dengan Google Gemini

c00425f0ad83b32c.png

Sekarang Anda memiliki aplikasi PHP baru yang keren, modern, dan canggih (seperti Fiat 126 tahun 2024) dengan penyimpanan yang dimigrasikan ke Cloud.

Apa yang dapat dilakukan dengannya?

Prasyarat

Di bab sebelumnya, solusi model memungkinkan kita memasang gambar /uploads/ di GCS, secara de facto memisahkan logika Aplikasi dari penyimpanan gambar.

Latihan ini mengharuskan Anda untuk:

  • Telah berhasil menyelesaikan latihan di bab 6 (penyimpanan).
  • Miliki bucket GCS dengan upload gambar, tempat orang mengupload gambar di aplikasi Anda dan gambar mengalir ke bucket Anda.

Menyiapkan Cloud Function (di Python)

Pernahkah Anda bertanya-tanya bagaimana cara menerapkan aplikasi berbasis peristiwa? Misalnya:

  • saat <peristiwa> terjadi => kirim email
  • saat <event> terjadi => jika <condition> benar, update Database.

Peristiwa dapat berupa apa saja, mulai dari data baru yang tersedia di BigQuery, objek baru yang diubah dalam folder di GCS, atau pesan baru yang menunggu dalam antrean di Pub/Sub.

Google Cloud mendukung beberapa paradigma untuk mencapai hal ini. Terutama:

Dalam latihan ini, kita akan mempelajari Cloud Function untuk mencapai hasil yang cukup spektakuler. Kami juga akan memberikan latihan opsional untuk Anda.

Perhatikan bahwa kode contoh disediakan di bagian .solutions/

Menyiapkan Cloud Function (🐍 python)

Kami mencoba membuat GCF yang sangat ambisius.

  1. Saat image baru dibuat di GCS.. (mungkin karena seseorang telah menguploadnya di aplikasi - tetapi tidak hanya itu)
  2. .. panggil Gemini untuk mendeskripsikannya dan dapatkan deskripsi tekstual gambar .. (sebaiknya periksa MIME dan pastikan itu adalah gambar, bukan PDF, MP3, atau Teks)
  3. .. dan memperbarui DB dengan deskripsi ini. (hal ini mungkin memerlukan patch DB untuk menambahkan kolom description ke tabel images).

Patch DB untuk menambahkan description ke gambar

  1. Buka Cloud SQL Studio:

b92b07c4cba658ef.png

  1. Masukkan pengguna dan sandi Anda untuk DB Gambar
  2. Masukkan SQL ini yang menambahkan kolom untuk deskripsi gambar:

ALTER TABLE images ADD COLUMN description TEXT;

3691aced78a6389.png

Dan bingo! Coba sekarang untuk memeriksa apakah cara ini berhasil:

SELECT * FROM images;

Anda akan melihat kolom deskripsi baru:

bed69d6ad0263114.png

Menulis f(x) Gemini

Catatan. Fungsi ini sebenarnya dibuat dengan bantuan Gemini Code Assist.

Catatan. Saat membuat fungsi ini, Anda mungkin mengalami error izin IAM. Beberapa di antaranya didokumentasikan di bawah dalam paragraf "Kemungkinan error".

  1. Mengaktifkan API
  2. Buka https://console.cloud.google.com/functions/list
  3. Klik "Create Function"
  4. Mengaktifkan API dari wizard API:

d22b82658cfd4c48.png

Anda dapat membuat GCF dari UI atau dari command line. Di sini, kita akan menggunakan command line.

Kode yang mungkin dapat ditemukan di bagian .solutions/

  1. Buat folder untuk menghosting kode Anda, misalnya "gcf/". Buka folder.
  2. Buat file requirements.txt:
google-cloud-storage
google-cloud-aiplatform
pymysql
  1. Membuat fungsi Python. Contoh kode di sini: gcf/main.py.
#!/usr/bin/env python

"""Complete this"""

from google.cloud import storage
from google.cloud import aiplatform
import vertexai
from vertexai.generative_models import GenerativeModel, Part
import os
import pymysql
import pymysql.cursors

# Replace with your project ID
PROJECT_ID = "your-project-id"
GEMINI_MODEL = "gemini-1.5-pro-002"
DEFAULT_PROMPT = "Generate a caption for this image: "

def gemini_describe_image_from_gcs(gcs_url, image_prompt=DEFAULT_PROMPT):
    pass

def update_db_with_description(image_filename, caption, db_user, db_pass, db_host, db_name):
    pass

def generate_caption(event, context):
    """
    Cloud Function triggered by a GCS event.
    Args:
        event (dict): The dictionary with data specific to this type of event.
        context (google.cloud.functions.Context): The context parameter contains
                                                event metadata such as event ID
                                                and timestamp.
    """
    pass
  1. Kirim fungsi. Anda dapat menggunakan skrip yang mirip dengan ini: gcf/push-to-gcf.sh.

Catatan 1. Pastikan untuk mengambil ENV dengan nilai yang tepat, atau cukup tambahkan di bagian atas (GS_BUCKET=blah, ..):

Catatan 2. Tindakan ini akan mengirimkan semua kode lokal (.), jadi pastikan untuk mengelompokkan kode Anda dalam folder tertentu dan menggunakan .gcloudignore seperti profesional untuk menghindari pengiriman library yang besar. ( contoh).

#!/bin/bash

set -euo pipefail

# add your logic here, for instance:
source .env || exit 2 

echo "Pushing ☁️ f(x)☁ to 🪣 $GS_BUCKET, along with DB config.. (DB_PASS=$DB_PASS)"

gcloud --project "$PROJECT_ID" functions deploy php_amarcord_generate_caption \
    --runtime python310 \
    --region "$GCP_REGION" \
    --trigger-event google.cloud.storage.object.v1.finalized \
    --trigger-resource "$BUCKET" \
    --set-env-vars "DB_HOST=$DB_HOST,DB_NAME=$DB_NAME,DB_PASS=$DB_PASS,DB_USER=$DB_USER" \
    --source . \
    --entry-point generate_caption \
    --gen2

Catatan: dalam contoh ini, generate_caption akan menjadi metode yang dipanggil, dan Cloud Function akan meneruskan peristiwa GCS ke metode tersebut dengan semua info yang relevan (nama bucket, nama objek, ..). Luangkan waktu untuk men-debug dict python peristiwa tersebut.

Menguji fungsi

Pengujian Unit

Fungsi ini memiliki banyak komponen yang saling terkait. Anda mungkin ingin menguji semua pengujian tunggal.

Contohnya ada di gcf/test.py.

UI Cloud Functions

Luangkan juga waktu untuk mempelajari fungsi Anda di UI. Setiap tab layak untuk dijelajahi, terutama Source (favorit saya), Variables, Trigger, dan Logs; Anda akan menghabiskan banyak waktu di Logs untuk memecahkan masalah error (lihat juga kemungkinan error di bagian bawah halaman ini). Pastikan juga untuk memeriksa Permissions.

cf3ded30d532a2c7.png

Pengujian E2E

Saatnya menguji fungsi secara manual.

  1. Buka aplikasi Anda, lalu login
  2. Upload gambar (tidak terlalu besar, kami pernah mengalami masalah dengan gambar besar)
  3. periksa di UI apakah gambar telah diupload.
  4. Periksa di Cloud SQL Studio bahwa deskripsi telah diperbarui. Login dan jalankan kueri ini: SELECT * FROM images.

43a680b12dbbdda0.png

Dan ini terbukti efektif. Kita mungkin juga ingin memperbarui frontend untuk menampilkan deskripsi tersebut.

Perbarui PHP untuk menampilkan [opsional]

Kita telah membuktikan bahwa aplikasi ini berfungsi. Namun, akan lebih baik jika pengguna juga dapat melihat deskripsi tersebut.

Kita tidak perlu menjadi pakar PHP untuk menambahkan deskripsi ke index.php. Kode ini akan melakukan (ya, Gemini juga menulisnya untuk saya!):

<?php if (!empty($image['description'])): ?>
    <p class="font-bold">Gemini Caption:</p>
    <p class="italic"><?php echo $image['description']; ?></p>
<?php endif; ?>

Tempatkan kode ini di dalam foreach sesuai keinginan Anda.

Pada langkah berikutnya, kita juga akan melihat versi UI yang lebih menarik, berkat Gemini Code Assist. Versi yang rapi mungkin terlihat seperti ini:

fdc12de0c88c4464.png

Kesimpulan

Anda memiliki Cloud Function yang dipicu pada objek baru yang masuk ke GCS yang dapat menganotasi konten gambar seperti yang dapat dilakukan manusia, dan otomatis memperbarui DB. Wow!

Apa langkah selanjutnya? Anda dapat mengikuti penalaran yang sama untuk mencapai dua fungsi yang hebat.

[opsional] Tambahkan Cloud Functions lebih lanjut [jawaban terbuka]

Ada beberapa fitur tambahan yang terlintas dalam pikiran.

📩 Pemicu Email

Pemicu email yang mengirimi Anda email setiap kali seseorang mengirim gambar.

  • Terlalu sering? Tambahkan batasan lebih lanjut: Gambar BESAR, atau gambar yang konten Gemini-nya berisi kata "nude/nudity/violent".
  • Sebaiknya periksa EventArc untuk hal ini.

🚫 Memoderasi otomatis gambar yang tidak pantas

Saat ini, admin manusia menandai gambar sebagai "tidak pantas". Bagaimana kalau Gemini yang melakukan tugas berat dan memoderasi ruang? Tambahkan pengujian untuk menandai konten pemicu yang tidak pantas dan mengupdate DB seperti yang telah kita pelajari di fungsi sebelumnya. Artinya, pada dasarnya mengambil fungsi sebelumnya, mengubah perintah, dan memperbarui DB berdasarkan jawabannya.

Peringatan. AI generatif memiliki output yang tidak dapat diprediksi. Pastikan "output kreatif" dari Gemini "terarah". Anda mungkin meminta jawaban deterministik seperti skor keyakinan dari 0 hingga 1, JSON, .. Anda dapat melakukannya dengan berbagai cara, misalnya: * Menggunakan library python pydantic, langchain, .. * Menggunakan Output Terstruktur Gemini.

Tips. Anda dapat memiliki BEBERAPA fungsi atau memiliki satu perintah yang menerapkan jawaban JSON (berfungsi dengan baik dengan "Output Terstruktur Gemini" seperti yang dijelaskan di atas) seperti:

What would the prompt be to generate this?

{
    "description": "This is the picture of an arrosticino",
    "suitable": TRUE
}

Anda dapat menambahkan kolom tambahan dalam perintah untuk mendapatkan insight seperti: apakah ada hal yang baik tentangnya? Buruk? Apakah Anda mengenali tempat ini? Is there some text (OCR has never been easier):

  • goods: "Sepertinya makanan yang lezat"
  • bads: "Sepertinya makanan tidak sehat"
  • OCR: "Da consumare preferibilmente prima del 10 Novembre 2024"
  • location: "Pescara, Lungomare"

Meskipun biasanya lebih baik memiliki fungsi N untuk hasil N, membuat satu fungsi yang melakukan 10 hal akan sangat bermanfaat. Baca artikel dari Riccardo ini untuk mengetahui caranya.

Kemungkinan error (sebagian besar terkait IAM/izin)

Saat pertama kali mengembangkan solusi ini, saya mengalami beberapa masalah izin IAM. Saya akan menambahkannya di sini untuk empati dan memberikan beberapa ide tentang cara memperbaikinya.

Error: izin tidak memadai untuk Akun Layanan

  1. Perhatikan bahwa untuk men-deploy fungsi GCF yang memproses bucket GCS, Anda harus menyiapkan izin yang tepat ke Akun Layanan yang Anda gunakan untuk tugas tersebut, seperti dalam gambar:

22f51012fa6b4a24.png

Anda mungkin juga harus mengaktifkan EventArc API - tunggu beberapa menit hingga API tersebut tersedia sepenuhnya.

Error: Invoker Cloud Run tidak ada

  1. Komentar lain dari UI untuk pemberian izin GCF adalah ini (peran Cloud Run Invoker):

be72e17294f2d3f3.png

Error ini dapat diperbaiki dengan menjalankan perintah dalam image, yang mirip dengan fix-permissions.sh

Masalah ini dijelaskan di sini: https://cloud.google.com/functions/docs/securing/authenticating

Error: Batas memori terlampaui

Saat pertama kali saya menjalankannya, log saya mungkin menampilkan: "‘Memory limit of 244 MiB exceeded with 270 MiB used. Pertimbangkan untuk meningkatkan batas memori, lihat https://cloud.google.com/functions/docs/configuring/memory'". Sekali lagi, tambahkan RAM ke GCF Anda. Hal ini sangat mudah dilakukan di UI. Berikut kemungkinan masalahnya:

bed69d6ad0263114.png

Atau, Anda juga dapat memperbaiki skrip deployment Cloud Run untuk meningkatkan MEM/CPU. Proses ini memerlukan waktu sedikit lebih lama.

Error: PubSub Dipublikasikan

Membuat pemicu dengan GCF v1 pernah memberikan error ini:

e5c338ee35ad4c24.png

Sekali lagi, masalah ini mudah diperbaiki dengan membuka IAM dan memberikan peran "Pub/Sub Publisher" ke Akun Layanan Anda.

Error: Vertex AI belum digunakan

Jika Anda menerima error ini:

Permission Denied: 403 Vertex AI API has not been used in project YOUR_PROJECT before or it is disabled. Aktifkan dengan membuka https://console.developers.google.com/apis/api/aiplatform.googleapis.com/overview?project=YOR_PROJECT

Anda hanya perlu mengaktifkan Vertex AI API. Cara termudah untuk mengaktifkan SEMUA API yang diperlukan adalah sebagai berikut:

  1. https://console.cloud.google.com/vertex-ai
  2. Klik "enable all recommended APIS".

492f05ac377f3630.png

Error: EventArc Trigger not found.

Jika Anda mendapatkan pesan ini, deploy ulang fungsi.

8ec4fc11833d7420.png

Error: 400 Service agents are being provisioned

400 Service agents are being provisioned ( https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents ). Service agents are needed to read the Cloud Storage file provided. Jadi, coba lagi dalam beberapa menit.

Jika hal ini terjadi, tunggu beberapa saat atau tanyakan kepada Googler.

10. Modul 8: Membuat SLO Ketersediaan

Dalam Bab ini, kami mencoba mencapai hal ini:

  1. Membuat SLI
  2. Membuat SLO berdasarkan SLI
  3. Membuat Pemberitahuan berdasarkan SLO

f63426182c052123.png

Topik ini sangat penting bagi penulis, karena Riccardo bekerja di area SRE/DevOps Google Cloud.

(jawaban bebas) Buat SLI dan SLO untuk aplikasi ini

Seberapa bagus aplikasi jika Anda tidak dapat mengetahui kapan aplikasi tersebut tidak aktif?

Apa yang dimaksud dengan SLO?

Wah! Google menciptakan SLO. Untuk membaca lebih lanjut tentang hal ini, kami dapat menyarankan:

Langkah 1: Buat SLI/SLO Ketersediaan

Mari kita mulai dengan SLO Ketersediaan, karena ini adalah hal termudah dan mungkin paling penting yang ingin Anda ukur.

Untungnya, Cloud Run dilengkapi dengan dukungan SLO bawaan, berkat Istio.

Setelah aplikasi Anda berada di Cloud Run, hal ini sangat mudah dicapai, hanya perlu waktu 30 detik.

  • Buka halaman Cloud Run Anda.
  • Klik/pilih aplikasi Anda.
  • Pilih tab SLOs.
  • Klik "+ Create SLO".
  • Ketersediaan, Berbasis permintaan
  • Lanjutkan
  • Bulan Kalender / 99%.
  • klik "Create SLO".

e471c7ebdc56cdf6.png

Langkah 2: Siapkan Pemberitahuan di SLO ini

Sebaiknya buat 2 pemberitahuan:

  1. Satu dengan rasio konsumsi rendah ("Slowburn") untuk memberi tahu Anda melalui email (mensimulasikan tiket prioritas rendah).
  2. Satu dengan burnrate tinggi ("Fastburn") untuk memberi tahu Anda melalui SMS (mensimulasikan tiket/pager prioritas tinggi)

Buka SLO tab Anda dari sebelumnya.

Lakukan ini dua kali:

314bfd6b9ef0a260.png

  • Klik "Create SLO Alert" (tombol 🔔 dengan tanda plus di dalamnya, di sebelah kanan)
  • Durasi lookback, nilai minimum Laju Pengeluaran:
  • [FAST]. Pertama: 60 mnt / 10 x
  • [SLOW]. Kedua: 720 mnt / 2 x
  • Notification channel: klik Manage notification channels
  • Pertama, "Email" -> Tambahkan baru -> ..
  • Kedua, "SMS" -> Tambahkan baru -> Verifikasi di ponsel.
  • Tips: Saya suka menggunakan emoji dalam nama. Ini menyenangkan untuk demo.
  • setelah selesai, klik X besar di kanan atas.
  • Pilih ponsel terlebih dahulu (cepat), lalu email (lambat).
  • Tambahkan beberapa contoh dokumentasi seperti:
  • [PHP Amarcord] Riccardo told me to type sudo reboot or to check documentation in http://example.com/playbooks/1.php but I guess he was joking.

Tepat!

Hasil akhir

Kita dapat menganggap latihan ini selesai setelah Anda memiliki 1 SLO yang berfungsi + 2x pemberitahuan untuk ketersediaan, dan pemberitahuan tersebut dikirim ke email dan ponsel Anda.

Jika mau, Anda dapat menambahkan Latensi (dan kami sangat menyarankan Anda melakukannya) atau bahkan yang lebih kompleks. Untuk latensi, pilih latensi yang Anda anggap wajar; jika ragu, pilih 200ms.

11. Langkah berikutnya

Anda telah menyelesaikan SEMUANYA, apa yang kurang?

Beberapa hal yang perlu dipertimbangkan:

Bermain dengan Gemini

Anda dapat menggunakan Gemini dalam dua versi:

  1. Vertex AI. "Cara Enterprise", yang terkait dengan GCP Anda, yang telah kita bahas di bab 7 (GCF+Gemini). Semua autentikasi berfungsi dengan baik, dan layanan saling terhubung dengan baik.
  2. AI Google. "Cara Konsumen". Anda mendapatkan Kunci Gemini API dari sini dan mulai membuat skrip kecil yang dapat dikaitkan ke workload apa pun yang sudah Anda miliki (pekerjaan eksklusif, cloud lain, localhost, ..). Anda cukup mengganti kunci API dan kode akan mulai berfungsi secara ajaib.

Sebaiknya Anda mencoba menjelajahi (2) dengan project pribadi Anda sendiri.

UI Lifting

Saya tidak mahir membuat UI. Namun, Gemini bisa. Anda dapat mengambil satu halaman PHP, dan mengatakan sesuatu seperti ini:

I have a VERY old PHP application. I want to touch it as little as possible. Can you help me:

1. add some nice CSS to it, a single static include for tailwind or similar, whatever you prefer
2. Transform the image print with description into cards, which fit 4 per line in the canvas?

Here's the code:

-----------------------------------
[Paste your PHP page, for instance index.php - mind the token limit!]

Anda dapat dengan mudah mendapatkannya dalam waktu kurang dari 5 menit, hanya dengan satu Cloud Build. :)

Respons dari Gemini sangat sempurna (artinya, saya tidak perlu mengubah apa pun):

8a3d5fe37ec40bf8.png

Berikut tata letak baru di aplikasi pribadi penulis:

81620eb90ae3229a.png

Catatan: kode ditempelkan sebagai gambar karena kami tidak ingin mendorong Anda untuk mengambil kode, tetapi agar Gemini menulis kode untuk Anda, dengan batasan UI/frontend kreatif Anda sendiri; percayalah, setelah itu Anda hanya perlu melakukan sedikit perubahan.

Keamanan

Mengamankan aplikasi ini dengan benar bukanlah tujuan workshop berdurasi 4 jam ini, karena akan meningkatkan waktu untuk menyelesaikan workshop ini sebanyak 1-2 kali lipat.

Namun, topik ini sangat penting. Kami telah mengumpulkan beberapa ide di SECURITY.

12. Selamat!

Selamat 🎉🎉🎉 , Anda telah berhasil memodernisasi aplikasi PHP lama dengan Google Cloud.

24cb9a39b1841fbd.png

Singkatnya, dalam codelab ini Anda telah mempelajari:

  • Cara men-deploy database di Google Cloud SQL dan cara memigrasikan database yang ada ke dalamnya.
  • Cara memasukkan aplikasi PHP ke dalam container dengan Docker dan Buildpack, serta menyimpan image-nya ke Artifact Registry Google Cloud
  • Cara men-deploy Aplikasi dalam container ke Cloud Run dan menjalankannya dengan Cloud SQL
  • Cara menyimpan/menggunakan parameter konfigurasi sensitif (seperti sandi DB) secara rahasia menggunakan Google Secret Manager
  • Cara menyiapkan pipeline CI/CD dengan Google Cloud Build untuk otomatis membangun dan men-deploy Aplikasi PHP Anda setiap kali ada push kode ke repositori GitHub Anda.
  • Cara menggunakan Cloud Storage untuk "memindahkan" resource aplikasi Anda ke cloud
  • Cara memanfaatkan teknologi serverless untuk membangun alur kerja yang luar biasa di Google Cloud tanpa menyentuh kode aplikasi Anda.
  • Menggunakan kemampuan multimodal Gemini untuk kasus penggunaan yang sesuai.
  • Menerapkan prinsip SRE dalam Google Cloud

Ini adalah awal yang baik untuk perjalanan Anda menuju Modernisasi aplikasi dengan Google Cloud.

🔁 Masukan

Jika Anda ingin memberi tahu kami tentang pengalaman Anda dalam workshop ini, pertimbangkan untuk mengisi formulir masukan ini.

Kami menantikan masukan Anda serta PR untuk bagian kode yang sangat Anda banggakan.

🙏 Terima kasih

Penulis ingin berterima kasih kepada Mirko Gilioli dan Maurizio Ipsale dari Datatonic atas bantuan dalam penulisan dan pengujian solusi.