Uygulama Değişikliği Atölyesi

1. Giriş

Son güncelleme tarihi: 01.11.2024

Eski bir PHP uygulamasını Google Cloud'a nasıl modernize ederiz?

(📽️ Bu codelab'e giriş niteliğindeki 7 dakikalık videoyu izleyin)

Şirket içinde çalışan ve modernleştirilmesi gereken eski uygulamalar yaygındır. Bu, modellerin ölçeklenebilir, güvenli ve farklı ortamlarda dağıtılabilir hale getirilmesi anlamına gelir.

Bu atölyede şunları yapacaksınız:

  1. PHP uygulamasını kapsayıcıya alma
  2. Yönetilen bir veritabanı hizmetine (Cloud SQL) geçiş yapın.
  3. Cloud Run'a dağıtma (GKE/Kubernetes'e sıfır operasyonlu bir alternatiftir).
  4. Identity and Access Management (IAM) ve Secret Manager ile uygulamayı güvenli hale getirme
  5. Cloud Build aracılığıyla bir CI/CD ardışık düzeni tanımlama Cloud Build, GitHub veya GitLab gibi popüler Git sağlayıcılarında barındırılan Git deponuza bağlanabilir ve örneğin, ana dala yapılan her push işleminde tetiklenebilir.
  6. Uygulama resimlerini Cloud Storage'da barındırın. Bu işlem, bağlama yoluyla gerçekleştirilir ve uygulamayı değiştirmek için kod gerekmez.
  7. Cloud Functions (sunucusuz) aracılığıyla yönetilen Gemini üzerinden üretken yapay zeka işlevini kullanıma sunma
  8. Hizmet seviyesi hedefleri (SLO) ve yeni yenilenen uygulamanızı çalıştırma hakkında bilgi edinin.

Bu adımları uygulayarak PHP uygulamanızı kademeli olarak modernize edebilir, ölçeklenebilirliğini, güvenliğini ve dağıtım esnekliğini artırabilirsiniz. Ayrıca Google Cloud'a geçerek uygulamanızın bulutta yerel bir ortamda sorunsuz şekilde çalışmasını sağlamak için Google Cloud'un güçlü altyapısından ve hizmetlerinden yararlanabilirsiniz.

Bu basit adımları uygulayarak öğreneceğiniz bilgilerin, farklı diller/yığınlar ve farklı kullanım alanlarıyla kendi uygulamanız ve kuruluşunuz için de geçerli olabileceğini düşünüyoruz.

Uygulama hakkında

Çatallayacağınız uygulama (MIT lisansı kapsamındaki kod), MySQL kimlik doğrulaması içeren temel bir PHP 5.7 uygulamasıdır. Uygulamanın temel amacı, kullanıcıların fotoğraf yükleyebileceği ve yöneticilerin uygunsuz resimleri etiketleyebileceği bir platform sunmaktır. Uygulamada iki tablo vardır:

  • Kullanıcılar. Yöneticilerle önceden derlenmiş olarak gelir. Yeni kullanıcılar kaydolabilir.
  • Görseller. Birkaç örnek resim içerir. Giriş yapmış kullanıcılar yeni resimler yükleyebilir. Buraya sihirli bir dokunuş katacağız.

Hedefiniz

Eski uygulamayı Google Cloud'a taşımak için modernize etmek istiyoruz. Ölçeklenebilirliği artırmak, güvenliği iyileştirmek, altyapı yönetimini otomatikleştirmek ve Cloud SQL, Cloud Run, Cloud Build, Secret Manager gibi hizmetleri kullanarak görüntü işleme, izleme ve veri depolama gibi ileri seviye özellikleri entegre etmek için Google Cloud'un araç ve hizmetlerinden yararlanacağız.

445f7a9ae37e9b4d.png

Daha da önemlisi, her adımın arkasındaki düşünce sürecini öğrenebilmeniz için bunu adım adım yapmak istiyoruz. Genellikle her adım, sonraki adımlar için yeni olanaklar sunar (örnek: 2. -> 3. ve 6. -> 7. modüller).

Henüz ikna olmadınız mı? YouTube'daki bu 7 dakikalık videoyu izleyin.

Gerekenler

  • Tarayıcısı olan ve internete bağlı bir bilgisayar.
  • Bazı GCP kredileri. Bunun için sonraki adıma bakın.
  • Cloud Shell'i kullanacaksınız. İhtiyacınız olan tüm önceden yüklenmiş komutlar ve bir IDE ile birlikte gelir.
  • GitHub hesabı. Orijinal kodu 🧑🏻‍💻 gdgpescara/app-mod-workshop kendi git deponuzla dallandırmak için buna ihtiyacınız vardır. Bu, kendi CI/CD ardışık düzeninizi (otomatik kaydetme -> derleme -> dağıtma) oluşturmak için gereklidir.

Örnek çözümleri burada bulabilirsiniz:

Bu atölye, Cloud Shell'de (tarayıcıda) tamamlanacak şekilde tasarlanmıştır.

Ancak bu işlemi yerel bilgisayarınızdan da yapabilirsiniz.

2. Kredi oluşturma ve çatallama

6dafc658860c0ce5.png

GCP kredisini kullanma ve GCP ortamınızı oluşturma [isteğe bağlı]

Bu atölyeyi çalıştırmak için bir miktar kredisi olan bir faturalandırma hesabınız olmalıdır. Başlamak için bu codelab'in üst kısmındaki banner'da bulunan kredileri kullanın. Bir faturalandırma hesabına zaten bağlıysanız bu adımı atlayabilirsiniz.

İşlem tamamlandıktan sonra Google Cloud Console'u açın ve sol üstteki açılır menüde "Kuruluş yok" ifadesinin gösterildiği proje seçiciyi tıklayarak yeni bir proje oluşturun. Aşağıya bakın

bd7548f78689db0b.png

Projeniz yoksa aşağıdaki ekran görüntüsünde gösterildiği gibi yeni bir proje oluşturun. Sağ üst köşede "YENİ PROJE" seçeneği vardır.

6c82aebcb9f5cd47.png

Yeni projeyi GCP deneme faturalandırma hesabına aşağıdaki şekilde bağladığınızdan emin olun.

f202527d254893fb.png

Google Cloud Platform'u kullanmaya hazırsınız. Yeni başlayan biriyseniz veya her şeyi bir bulut ortamında yapmak istiyorsanız sol üst köşedeki aşağıdaki düğmeyi kullanarak Cloud Shell'e ve düzenleyicisine erişebilirsiniz.

7d732d7bf0deb12e.png

Sol üstte yeni projenizin seçili olduğundan emin olun:

Seçilmedi (kötü):

c2ffd36a781b276a.png

Seçilen (iyi):

594563c158f4f590.png

Uygulamayı GitHub'dan çatallama

  1. Demo uygulamasına gidin: https://github.com/gdgpescara/app-mod-workshop
  2. 🍴 Fork'u tıklayın.
  3. GitHub hesabınız yoksa yeni bir hesap oluşturmanız gerekir.
  4. İstediğiniz gibi düzenleyin.

734e51bfc29ee5df.png

  1. Uygulama kodunu klonlamak için aşağıdaki komutu kullanın:
  2. git clone https://github.com/YOUR-GITHUB-USER/YOUR-REPO-NAME
  1. Klonlanan proje klasörünü tercih ettiğiniz düzenleyiciyle açın. Cloud Shell'i seçerseniz aşağıda gösterildiği gibi "Open Editor"ı (Düzenleyiciyi Aç) tıklayarak bunu yapabilirsiniz.

40f5977ea4c1d1cb.png

Aşağıdaki görselde gösterildiği gibi, Google Cloud Shell Düzenleyici'de ihtiyacınız olan her şey mevcuttur.

a4e5ffb3e9a35e84.png

Bunu görsel olarak yapmak için "Open Folder"ı (Klasör Aç) tıklayıp klasörü seçin. Klasör muhtemelen ana klasörünüzdeki app-mod-workshop dizinindedir.

3. 1. Modül: SQL örneği oluşturma

645902e511a432a6.png

Google Cloud SQL örneği oluşturma

PHP uygulamamız bir MySQL veritabanına bağlanacak. Bu nedenle, sorunsuz bir taşıma işlemi için bu veritabanını Google Cloud'a kopyalamamız gerekiyor. Cloud SQL, bulutta tümüyle yönetilen bir MySQL veritabanı çalıştırmanıza olanak tanıdığı için mükemmel bir seçenektir. Şu adımları uygulayabilirsiniz:

  1. Cloud SQL sayfasına gidin: https://console.cloud.google.com/sql/instances
  2. "Create Instance"ı (Örnek Oluştur) tıklayın.
  3. API'yi etkinleştirin (gerekirse). Bu işlem birkaç saniye sürebilir.
  4. MySQL'i seçin.
  5. (Daha uzun süre kullanabilmeniz için en ucuz sürümü almaya çalışıyoruz):
  • Sürüm: Enterprise
  • Önceden ayarlanmış: development (Sandbox'ı denedik ancak işimize yaramadı)
  • MySQL sürümü: 5.7 (Geçmişten gelen bir sürüm!)
  1. Örnek kimliği: appmod-phpapp seçeneğini belirleyin (bunu değiştirirseniz gelecekteki komut dosyalarını ve çözümleri de buna göre değiştirmeyi unutmayın).
  2. Şifre: İstediğiniz şifreyi belirleyin ancak CLOUDSQL_INSTANCE_PASSWORD olarak not edin.
  3. Bölge: Uygulamanın geri kalanı için seçtiğiniz bölgeyle aynı olmalıdır (ör. Milano = europe-west8)
  4. Bölgesel kullanılabilirlik: Tek Bölge (demo için para biriktiriyoruz)

Cloud SQL veritabanını dağıtmak için Create Instance (Örnek Oluştur) düğmesini tıklayın. ⌛ Bu işlemin tamamlanması yaklaşık 10 dakika sürer.⌛ Bu sırada belgeleri okumaya devam edin. Ayrıca, ilk bölümdeki bu modüle bağımlı olmadığı için bir sonraki modülü ("PHP Uygulamanızı Container'a Yerleştirme") çözmeye başlayabilirsiniz (veritabanı bağlantısını düzeltene kadar).

Not. Bu örneğin maliyeti günde yaklaşık 7 ABD doları olacaktır. Çalıştaydan sonra bu konuyu ayrı bir toplantıda ele almayı unutmayın.

Cloud SQL'de image_catalog veritabanı ve kullanıcı oluşturma

Uygulama projesinde iki SQL dosyası içeren bir db/ klasörü bulunur:

  1. 01_schema.sql: Kullanıcılar ve Resimler verilerini içeren iki tablo oluşturmak için SQL kodu içerir.
  2. 02_seed.sql: Daha önce oluşturulan tablolara veri eklemek için SQL kodunu içerir.

Bu dosyalar, image_catalog veritabanı oluşturulduktan sonra kullanılacaktır. Bunun için aşağıdaki adımları uygulayabilirsiniz:

  1. Örneğinizi açın ve Veritabanları sekmesini tıklayın:
  2. "Create Database"i (Veritabanı Oluştur) tıklayın.
  3. image_catalog olarak adlandırın (PHP uygulama yapılandırmasında olduğu gibi).

997ef853e5ebd857.png

Ardından veritabanı kullanıcısını oluştururuz. Bu sayede image_catalog veritabanında kimlik doğrulaması yapabiliriz.

  1. Şimdi Kullanıcılar sekmesini tıklayın.
  2. "Kullanıcı hesabı ekle"yi tıklayın.
  3. Kullanıcı: Bir tane oluşturalım:
  • Kullanıcı adı: appmod-phpapp-user
  • Şifre: Hatırlayabileceğiniz bir şifre seçin veya "oluştur"u tıklayın.
  • "Herhangi bir ana makineye izin ver (%)" seçeneğini olduğu gibi bırakın.
  1. EKLE'yi tıklayın.

Veritabanını bilinen IP'lere açın.

Cloud SQL'deki tüm veritabanlarının "izole" olarak oluşturulduğunu unutmayın. Erişilebilecek bir ağı açıkça ayarlamanız gerekir.

  1. Örneğinizi tıklayın.
  2. "Bağlantılar" menüsünü açın.
  3. "Networking" (Ağ iletişimi) sekmesini tıklayın.
  4. "Yetkili ağlar" bölümünü tıklayın. Şimdi bir ağ (ör. alt ağ) ekleyin.
  • Şimdilik uygulamanın çalışması için hızlı ancak GÜVENLİ OLMAYAN ayarları seçelim. Daha sonra bu ayarları güvendiğiniz IP'lerle kısıtlayabilirsiniz:
  • Ad: "Dünyadaki herkes - GÜVENLİ DEĞİL".
  • Ağ: "0.0.0.0/0" (Not: Bu, GÜVENLİ OLMAYAN kısımdır.)
  • BİTTİ'yi tıklayın.
  1. Kaydet'i tıklayın.

Aşağıdakine benzer bir tablo görürsünüz:

5ccb9062a7071964.png

Not. Bu çözüm, atölyeyi O(saat) içinde tamamlamak için iyi bir uzlaşmadır. Ancak çözümünüzü üretime hazır hale getirmek için SECURITY belgesini inceleyin.

Veritabanı bağlantısını test etme zamanı geldi.

Daha önce oluşturduğumuz image_catalog kullanıcısının çalışıp çalışmadığını kontrol edelim.

Örnekte "Cloud SQL Studio"ya erişin ve kimlik doğrulaması için veritabanı, kullanıcı ve şifre bilgilerini aşağıda gösterildiği gibi girin:

d56765c6154c11a4.png

Artık SQL Editor'ı açabilir ve sonraki bölüme geçebilirsiniz.

Veritabanını kod tabanından içe aktarma

image_catalog tablolarını verileriyle birlikte içe aktarmak için SQL Editor'ı kullanın. Depodaki dosyalardan (01_schema.sql ve ardından 02_seed.sql) SQL kodunu kopyalayın ve bunları sırayla çalıştırın.

Bu işlemden sonra, image_catalog'da aşağıda gösterildiği gibi users ve images adlı iki tablo elde edersiniz:

65ba01e4c6c2dac0.png

Düzenleyicide şu komutu çalıştırarak test edebilirsiniz: select * from images;

Ayrıca Cloud SQL örneğinin genel IP adresini not edin. Bu adrese daha sonra ihtiyacınız olacak. IP'yi almak için Overview (Genel Bakış) sayfasındaki Cloud SQL örneği ana sayfasına gidin. (Genel Bakış > Bu Örneğe Bağlan > Genel IP Adresi).

4. Modül 2: PHP Uygulamanızı Kapsayıcıya Alma

e7f0e9979d8805f5.png

Bu uygulamayı bulut için geliştirmek istiyoruz.

Bu, kodun bulutta çalıştırılması için gereken tüm bilgileri içeren bir ZIP dosyası halinde paketlenmesi anlamına gelir.

Bunu paketlemenin birkaç yolu vardır:

  • Docker. Çok popülerdir ancak doğru şekilde ayarlanması oldukça karmaşıktır.
  • Buildpack'ler. Daha az popülerdir ancak neyin derleneceğini ve neyin çalıştırılacağını "otomatik olarak tahmin etme" eğilimindedir. Çoğu zaman işe yarar.

Bu atölye kapsamında Docker kullandığınızı varsayacağız.

Cloud Shell'i kullanmayı seçtiyseniz şimdi yeniden açın (Cloud Console'un sağ üst kısmını tıklayın).

ec6a6b90b39e03e.png

Bu işlem, sayfanın alt kısmında kullanışlı bir kabuk açar. Kurulum adımında kodu burada çatallamış olmanız gerekir.

6999b906c0dedeb7.png

Docker

Kontrolün sizde olmasını istiyorsanız bu çözüm sizin için idealdir. Bu, belirli kitaplıkları yapılandırmanız ve belirgin olmayan bazı davranışları (yüklemelerde chmod, uygulamanızda standart olmayan bir yürütülebilir dosya vb.) eklemeniz gerektiğinde mantıklıdır.

Container mimarisine alınmış uygulamamızı Cloud Run'a dağıtmak istediğimiz için aşağıdaki belgeyi inceleyin. PHP 8'den PHP 5.7'ye nasıl geri taşırsınız? Belki bunun için Gemini'ı kullanabilirsiniz. Alternatif olarak, önceden hazırlanmış bu sürümü kullanabilirsiniz:

# 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

En yeni Dockerfile sürümüne buradan ulaşabilirsiniz.

Uygulamamızı yerel olarak test etmek için config.php dosyasını, PHP uygulamamız Google Cloud SQL'de bulunan MySQL veritabanına bağlanacak şekilde değiştirmemiz gerekir. Daha önce ayarladığınız bilgilere göre boşlukları doldurun:

<?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, Cloud SQL genel IP adresidir. Bu adresi SQL konsolunda bulabilirsiniz:

bd27071bf450a8d0.png

  • DB_NAME değişmeden kalmalıdır: image_catalog
  • DB_USER, appmod-phpapp-user olmalıdır.
  • DB_PASS, seçtiğiniz bir şeydir. Tek tırnak içinde ayarlayın ve gerektiğinde çıkış yapın.

Ayrıca, 🇮🇹 İtalyanca olan birkaç parçayı Gemini yardımıyla İngilizceye çevirebilirsiniz.

Dockerfile oluşturuldu ve PHP uygulamanız veritabanınıza bağlanacak şekilde yapılandırıldı. Şimdi bunu deneyelim.

Henüz yüklemediyseniz Docker'ı yükleyin (bağlantı). Cloud Shell kullanıyorsanız buna ihtiyacınız yoktur (bu çok iyi bir özellik).

Şimdi uygun docker derleme ve çalıştırma komutlarıyla container mimarisine alınmış PHP uygulamanızı derleyip çalıştırmayı deneyin.

# 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

Her şey düzgün çalışıyorsa yerel ana makineye bağlandığınızda aşağıdaki web sayfasını görebilirsiniz. Uygulamanız 8080 numaralı bağlantı noktasında çalışıyor. "Web önizlemesi" simgesini (göz simgeli tarayıcı) ve ardından 8080 numaralı bağlantı noktasında önizle'yi (veya başka bir bağlantı noktası için "Bağlantı noktasını değiştir"i) tıklayın.

33a24673f4550454.png

Sonucu tarayıcınızda test etme

Uygulamanız artık aşağıdaki gibi görünecektir:

2718ece96b1f18b6.png

Admin/admin123 ile giriş yaptığınızda şuna benzer bir ekran görürsünüz.

68b62048c2e86aea.png

Harika. İtalyanca metin dışında her şey çalışıyor. 🎉🎉🎉

Docker'laştırma işleminiz doğruysa ancak veritabanı kimlik bilgileri yanlışsa şuna benzer bir sonuç alabilirsiniz:

e22f45b79bab86e1.png

Tekrar deneyin, çok yaklaştınız.

Artifact Registry'ye kaydetme [isteğe bağlı]

Bu aşamada, buluta dağıtılmaya hazır, çalışan bir container mimarisine alınmış PHP uygulamanız olmalıdır. Ardından, Docker görüntümüzü depolamak ve Cloud Run gibi Google Cloud hizmetlerine dağıtım için erişilebilir hale getirmek üzere bulutta bir yere ihtiyacımız var. Bu depolama çözümü, Docker container görüntüleri, Maven paketleri, npm modülleri ve daha fazlası dahil olmak üzere uygulama yapılarını depolamak için tasarlanmış, tümüyle yönetilen bir Google Cloud hizmeti olan Artifact Registry'dir.

Uygun düğmeyi kullanarak Google Cloud Artifact Registry'de bir depo oluşturalım.

e1123f0c924022e6.png

Geçerli bir ad, biçim ve yapıları depolamaya uygun bölgeyi seçin.

4e516ed209c470ee.png

Yerel geliştirme ortamınıza dönün ve uygulama container görüntüsünü etiketleyip yeni oluşturulan Artifact Registry deposuna aktarın. Bunun için aşağıdaki komutları tamamlayın.

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

Sonuç, aşağıdaki ekran görüntüsüne benzer şekilde görünmelidir.

1e498feb4e88be9f.png

Tebrikler 🎉🎉🎉 Bir sonraki seviyeye geçebilirsiniz. O zamana kadar, yükleme/giriş/çıkış işlemlerini deneyerek ve uygulama uç noktalarını tanıyarak 2 dakika geçirebilirsiniz.Bunlara daha sonra ihtiyacınız olacak.

Olası hatalar

Kapsayıcılaştırma hataları alırsanız hatayı açıklamak ve düzeltmek için Gemini'ı kullanmayı deneyin. Bunun için şunları sağlayın:

  • Mevcut Dockerfile dosyanız
  • Alınan hata
  • [Gerekirse] yürütülen PHP kodu.

Yükleme İzinleri. /upload.php uç noktasını da deneyin ve bir resim yüklemeyi deneyin. Aşağıdaki hatayı alabilirsiniz. Bu durumda, Dockerfile içinde düzeltmeniz gereken bazı chmod/chown var.

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" (veya "Errore di connessione: could not find driver"). Dockerfile'ınızda, veritabanına bağlanmak için mysql (pdo_mysql) ile ilgili doğru PDO kitaplıklarının bulunduğundan emin olun. Buradaki çözümlerden ilham alın.

İsteğiniz arka uca yönlendirilemiyor. 8080 numaralı bağlantı noktasındaki bir sunucuya bağlanılamadı. Bu, muhtemelen yanlış bağlantı noktasını kullanıma açtığınız anlamına gelir. Apache/Nginx'in gerçekten hizmet verdiği bağlantı noktasını gösterdiğinizden emin olun. Bu kolay bir iş değildir. Mümkünse bu bağlantı noktasını 8080 yapmaya çalışın (Cloud Run ile hayatı kolaylaştırır). 80 numaralı bağlantı noktasını kullanmaya devam etmek istiyorsanız (ör. Apache bu şekilde istediği için) çalıştırmak için farklı bir komut kullanın:

$ 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. 3. Modül: Uygulamayı Cloud Run'a Dağıtma

9ffca42774f6c5d1.png

Neden Cloud Run?

Haklı bir soru. Yıllar önce olsaydı kesinlikle Google App Engine'i seçerdiniz.

Kısaca açıklamak gerekirse Cloud Run, daha yeni bir teknoloji yığınına sahiptir, daha kolay dağıtılır, daha ucuzdur ve kullanmadığınızda ölçeği 0'a düşürür. Herhangi bir durum bilgisiz container'ı çalıştırma esnekliği ve çeşitli Google Cloud hizmetleriyle entegrasyonu sayesinde, mikro hizmetleri ve modern uygulamaları minimum ek yük ve maksimum verimlilikle dağıtmak için idealdir.

Daha ayrıntılı açıklamak gerekirse Cloud Run, Google Cloud tarafından sunulan ve durum bilgisiz container mimarisine alınmış uygulamaları sunucusuz bir ortamda çalıştırmanıza olanak tanıyan, tümüyle yönetilen bir platformdur. Tüm altyapıyı otomatik olarak yönetir, gelen trafiği karşılamak için sıfırdan ölçeklendirir ve boşta olduğunda ölçeği küçültür. Bu sayede uygun maliyetli ve verimli bir çözüm sunar. Cloud Run, container'da paketlendiği sürece tüm dilleri ve kitaplıkları destekler. Bu sayede geliştirme sürecinde büyük esneklik sağlar. Diğer Google Cloud hizmetleriyle iyi entegre olur ve sunucu altyapısını yönetmeye gerek kalmadan mikro hizmetler, API'ler, web siteleri ve etkinliğe dayalı uygulamalar oluşturmak için uygundur.

Ön koşullar

Bu görevi tamamlamak için yerel makinenizde gcloud yüklü olmalıdır. Aksi takdirde buradaki talimatları inceleyin. Google Cloud Shell kullanıyorsanız herhangi bir işlem yapmanız gerekmez.

Dağıtımdan önce...

Yerel ortamınızda çalışıyorsanız aşağıdaki komutla Google Cloud'da kimlik doğrulaması yapın:

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

Bu işlem, tarayıcınızda bir OAuth girişi aracılığıyla kimliğinizi doğrular. Chrome'da, faturalandırmanın etkin olduğu Google Cloud'a giriş yapan kullanıcıyla (ör. vattelapesca@gmail.com) giriş yaptığınızdan emin olun.

Aşağıdaki komutu kullanarak Cloud Run API'yi etkinleştirin:

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

Bu noktada her şey Cloud Run'a dağıtılmaya hazırdır.

Uygulamanızı gcloud aracılığıyla Cloud Run'a dağıtma

Uygulamayı Cloud Run'a dağıtmanıza olanak tanıyan komut gcloud run deploy komutudur. Hedefinize ulaşmak için ayarlayabileceğiniz çeşitli seçenekler vardır. Minimum seçenek grubu (komut satırı üzerinden sağlayabileceğiniz veya aracın etkileşimli istemle soracağı) şunlardır:

  1. Uygulamanız için dağıtmak istediğiniz Cloud Run hizmetinin adı. Cloud Run hizmeti, uygulamanız için uç nokta sağlayan bir URL döndürür.
  2. Uygulamanızın çalışacağı Google Cloud bölgesi. (--region BÖLGE)
  3. Uygulamanızı sarmalayan Container Image.
  4. Uygulamanızın yürütme sırasında kullanması gereken ortam değişkenleri.
  5. Herkesin daha fazla kimlik doğrulama olmadan uygulamanıza erişmesine izin veren Allow-Unauthenticated işareti.

Bu seçeneği komut satırınıza nasıl uygulayacağınızı öğrenmek için belgelere bakın (veya olası bir çözüm için aşağı kaydırın).

Dağıtım işlemi birkaç dakika sürer. Her şey doğruysa Google Cloud Console'da şuna benzer bir şey görürsünüz.

ef1029fb62f8de81.pngf7191d579c21ca3e.png

Cloud Run tarafından sağlanan URL'yi tıklayın ve uygulamanızı test edin. Kimlik doğrulama tamamlandıktan sonra şuna benzer bir ekran görürsünüz.

d571a90cd5a373f9.png

Bağımsız değişken içermeyen "gcloud run deploy"

gcloud run deploy'ın size doğru soruları sorduğunu ve bıraktığınız boşlukları doldurduğunu fark etmiş olabilirsiniz. Bu harika!

Ancak birkaç modül sonra bu komutu bir Cloud Build derleme tetikleyicisine ekleyeceğimiz için etkileşimli soruları kullanamayız. Komuttaki her seçeneği doldurmamız gerekir. Altın gcloud run deploy --option1 blah --foo bar --region your-fav-region yapmak istiyorsunuz. Nasıl yapacaksınız?

  1. gcloud soru sormayı bırakana kadar 2, 3 ve 4. adımları tekrarlayın:
  2. [LOOP] Şu ana kadar bulunan seçeneklerle gcloud run deploy
  3. [LOOP] sistemleri X seçeneğini soruyor
  4. [LOOP] Search in public docs how to set up X from CLI adding option --my-option [my-value].
  5. gcloud başka soru sormadan tamamlanmazsa 2. adıma geri dönün.
  6. Bu gcloud run deploy BLAH BLAH BLAH harika! Komutu bir yere kaydedin. Cloud Build adımında bu komuta ihtiyacınız olacak.

Olası bir çözümü burada bulabilirsiniz. Belgelere buradan ulaşabilirsiniz.

Tebrikler 🎉🎉🎉 Uygulamanızı Google Cloud'da başarıyla dağıtarak modernizasyonun ilk adımını tamamladınız.

6. 4. modül: Secret Manager ile şifreleri temizleme

95cd57b03b4e3c73.png

Önceki adımda, uygulamamızı Cloud Run'da başarıyla dağıtıp çalıştırabildik. Ancak bunu yaparken güvenlik açısından kötü bir uygulama olan bazı gizli bilgileri şifresiz metin olarak sağlama yöntemini kullandık.

İlk iterasyon: config.php dosyanızı ENV kullanacak şekilde güncelleyin.

Veritabanı şifresini doğrudan config.php dosyasındaki koda eklediğimizi fark etmiş olabilirsiniz. Bu, test amaçları ve uygulamanın çalışıp çalışmadığını görmek için yeterlidir. Ancak bu kodu üretim ortamında uygulayamaz veya kullanamazsınız. Şifre (ve diğer veritabanı bağlantı parametreleri) dinamik olarak okunmalı ve çalışma zamanında uygulamaya sağlanmalıdır. config.php dosyasını, db parametrelerini ENV değişkenlerinden okuyacak şekilde değiştirin. Başarısız olursa varsayılan değerleri ayarlamayı düşünebilirsiniz. Bu, ENV'yi yükleyemediğiniz durumlarda faydalıdır. Sayfa çıkışı, varsayılan değerlerin kullanılıp kullanılmadığını size bildirir. Boşlukları doldurun ve config.php dosyasındaki kodu değiştirin.

<?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();
?>

Uygulamanız container'laştırıldığı için ENV değişkenlerini uygulamaya sağlamanın bir yolunu bulmanız gerekir. Bunu birkaç şekilde yapabilirsiniz:

  • Derleme sırasında, Dockerfile'da. ENV DB_VAR=ENV_VAR_VALUE söz dizimini kullanarak önceki Dockerfile'ınıza 4 parametreyi ekleyin. Bu işlem, çalışma zamanında geçersiz kılınabilecek varsayılan değerleri ayarlar. Örneğin, "DB_NAME" ve "DB_USER" burada ayarlanabilir ve başka bir yerde ayarlanamaz.
  • Çalışma zamanında. Cloud Run için bu değişkenleri CLI veya kullanıcı arayüzünden ayarlayabilirsiniz. 4 değişkeninizin tümünü buraya ekleyebilirsiniz (Dockerfile'da ayarlanan varsayılan değerleri korumak istemiyorsanız).

Localhost'ta ENV değişkenlerinizi bir .env dosyasına yerleştirmek isteyebilirsiniz (solutions klasörüne bakın).

Ayrıca .env dosyasının .gitignore dosyanıza eklendiğinden emin olun. Gizli anahtarlarınızı GitHub'a göndermek istemezsiniz.

echo .env >> .gitignore

Ardından, örneği yerel olarak test edebilirsiniz:

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

Şimdi şunları başardınız:

  1. Uygulamanız, değişkeni ENV'nizden dinamik olarak okur.
  2. Veritabanı şifresini kodunuzdan kaldırdığınız için güvenliği artırdınız.)

Artık Cloud Run'a yeni bir düzeltme dağıtabilirsiniz. Kullanıcı arayüzüne gidip ortam değişkenlerini manuel olarak ayarlayalım:

  • https://console.cloud.google.com/run adresine gidin.
  • Uygulamanızı tıklayın.
  • "Düzenle ve yeni bir düzeltme dağıt"ı tıklayın.
  • İlk sekme olan "Kapsayıcılar"da, alt sekme olan "Değişkenler ve gizli anahtarlar"ı tıklayın.
  • "+ Değişken ekle"yi tıklayın ve gerekli tüm değişkenleri ekleyin. Şuna benzer bir sonuç elde edersiniz:

7a5fbfa448544d3.pngf2780c35585388ca.png

Bu mükemmel mi? Hayır. PASS'iniz çoğu operatör tarafından görülebilir. Bu sorun, Google Cloud Secret Manager ile çözülebilir.

İkinci iterasyon: Secret Manager

Şifreleriniz kendi kodunuzdan kayboldu. İşte zafer! Ancak bir saniye, artık güvende miyiz?

Şifreleriniz, Google Cloud Console'a erişimi olan herkes tarafından görülebilir. Cloud Run YAML dağıtım dosyasına erişirseniz bu bilgiyi alabilirsiniz. Yeni bir Cloud Run düzeltmesini düzenlemeye veya dağıtmaya çalışırsanız şifre, aşağıdaki ekran görüntülerinde gösterildiği gibi Değişkenler ve Gizli Anahtarlar bölümünde görünür.

Google Cloud Secret Manager; API anahtarları, şifreler, sertifikalar ve diğer gizli bilgiler gibi hassas bilgileri yönetmek için kullanılan güvenli ve merkezi bir hizmettir.

Bu sayede, ayrıntılı izinler ve güçlü şifreleme ile gizli anahtarları depolayabilir, yönetebilir ve bunlara erişebilirsiniz. Google Cloud'un Identity and Access Management (IAM) hizmetiyle entegre olan Secret Manager, belirli gizli anahtarlara kimlerin erişebileceğini kontrol etmenize olanak tanıyarak veri güvenliği ve düzenleyici kurumun belirlediği kurallara uygunluk sağlar.

Ayrıca otomatik gizli anahtar rotasyonunu ve sürüm oluşturmayı destekleyerek gizli anahtar yaşam döngüsü yönetimini basitleştirir ve Google Cloud hizmetlerindeki uygulamalarda güvenliği artırır.

Secret Manager'a erişmek için hamburger menüden Güvenlik hizmetlerine gidin ve aşağıdaki ekran görüntüsünde gösterildiği gibi Veri Koruma bölümünde bulun.

6df83a1c3cb757f6.png

Aşağıdaki resimde gösterildiği gibi Secret Manager API'yi etkinleştirin.

a96c312e2c098db1.png

  • Şimdi "Create a secret"ı (Gizli anahtar oluştur) tıklayın. Mantıklı bir ad verelim:
  • Ad: php-amarcord-db-pass
  • Gizli değer: "veritabanı şifreniz" ("dosya yükle" kısmını yoksayın).
  • Bu gizli bağlantıya not ekleyin. projects/123456789012/secrets/php-amarcord-db-pass gibi görünmelidir. Bu, gizli anahtarınızın benzersiz işaretçisidir (Terraform, Cloud Run ve diğerleri için). Bu sayı, benzersiz proje numaranızdır.

İpucu: Gizli anahtarlarınız için soldan sağa doğru özelleşen tutarlı bir adlandırma kuralı kullanmaya çalışın. Örneğin: cloud-devrel-phpamarcord-dbpass

  • Kuruluş (şirketle birlikte)
  • Ekip (kuruluş içinde)
  • Uygulama (ekip içinde)
  • Değişken adı (uygulama içinde)

Bu sayede, tek bir uygulamadaki tüm gizli anahtarlarınızı bulmak için kolay normal ifadeler kullanabilirsiniz.

Yeni bir Cloud Run düzeltmesi oluşturma

Yeni bir gizli anahtarımız olduğuna göre DB_PASS ENV değişkenini kaldırıp yerine yeni gizli anahtarı koymamız gerekiyor. Bu durumda:

  • Google Cloud Console'u kullanarak Cloud Run'a erişme
  • Uygulamayı seçin.
  • "Edit & Deploy a New Revision"ı (Yeni Bir Düzeltmeyi Düzenle ve Dağıt) tıklayın.
  • "Variables & Secrets" (Değişkenler ve Gizli Anahtarlar) sekmesini bulun.
  • DB_PASS ENV değişkenini sıfırlamak için "+ Reference a Secret" (+ Gizli Anahtara Referans Ver) düğmesini kullanın.
  • Referans verilen gizli anahtarlar için aynı "DB_PASS" değerini ve en yeni sürümü kullanın.

9ed4e35be7654dcb.png

İşlem tamamlandığında aşağıdaki hatayı alırsınız.

da0ccd7af39b04ed.png

Sorunu nasıl çözülür bulmaya çalışın. Bu sorunu çözmek için IAM ve Yönetici bölümüne gidip izinleri değiştirmeniz gerekir. İyi hata ayıklamalar!

Sorunu çözdükten sonra Cloud Run'a dönün ve yeni bir düzeltmeyi yeniden dağıtın. Sonuç aşağıdaki resme benzer olmalıdır:

e89f9ca780169b6b.png

İpucu: Developer Console (kullanıcı arayüzü), izin sorunlarını tespit etme konusunda çok başarılıdır. Cloud varlıklarınızın tüm bağlantılarını inceleyin.

7. 5. modül: Cloud Build ile CI/CD'nizi ayarlama

ba49b033c11be94c.png

Neden CI/CD ardışık düzeni?

Şimdiye kadar gcloud run deploy ifadesini birkaç kez yazmış, belki de aynı soruyu tekrar tekrar yanıtlamış olmalısınız.

Uygulamanızı gcloud run deploy komutuyla manuel olarak dağıtmaktan sıkıldınız mı? Git deponuza her yeni değişiklik gönderdiğinizde uygulamanızın kendisini otomatik olarak dağıtması harika olmaz mıydı?

CI/CD ardışık düzenini kullanmak için iki şeye ihtiyacınız vardır:

  1. Kişisel Git deposu: Neyse ki 2. adımda atölye deposunu GitHub hesabınıza zaten kopyalamış olmanız gerekir. Tamamlamadıysanız geri dönüp o adımı tamamlayın. Çatallanmış deponuz şu şekilde görünmelidir: https://github.com/<YOUR_GITHUB_USER>/app-mod-workshop
  2. Cloud Build. Bu muhteşem ve uygun fiyatlı hizmet sayesinde Terraform, Docker'a dönüştürülmüş uygulamalar gibi neredeyse her şey için derleme otomasyonları yapılandırabilirsiniz.

Bu bölümde Cloud Build'i ayarlama konusuna odaklanacağız.

Cloud Build'e giriş

Bunu yapmak için Cloud Build'i kullanacağız:

  • Kaynağınızı (Dockerfile ile) derleme Bunu, derlemek ve çalıştırmak için ihtiyacınız olan her şeyi içeren "büyük bir .zip dosyası" ("derleme yapınız") olarak düşünebilirsiniz.
  • Bu yapıyı Artifact Registry'ye (AR) aktarın.
  • Ardından, "php-amarcord" uygulaması için AR'den Cloud Run'a dağıtım yapın.
  • Bu işlem, mevcut uygulamanın yeni bir sürümünü ("revizyon") oluşturur (yeni kodun bulunduğu bir katman gibi düşünebilirsiniz). Ardından, aktarım başarılı olursa trafiği yeni sürüme yönlendirecek şekilde yapılandırırız.

php-amarcord uygulamam için bazı derlemelerin örneği:

f30f42d4571ad5e2.png

Peki tüm bunları nasıl yapıyoruz?

  1. Tek bir mükemmel YAML dosyası oluşturarak: cloudbuild.yaml
  2. Cloud Build derleme tetikleyicisi oluşturarak
  3. Cloud Build kullanıcı arayüzü üzerinden GitHub depomuza bağlanarak.

Tetikleyici oluşturma (ve depoyu bağlama)

  • https://console.cloud.google.com/cloud-build/triggers adresine gidin.
  • "Tetikleyici oluştur"u tıklayın.
  • Derleme:
  • Ad: on-git-commit-build-php-app gibi anlamlı bir ad girin.
  • Etkinlik: Dala aktarma
  • Kaynak: "Yeni depo bağla" alternatif metin
  • Bu işlem, sağ tarafta "Depoyu bağla" penceresini açar.
  • Kaynak sağlayıcı: "Github" (ilk)
  • "Devam"
  • "Kimlik doğrula" seçeneği, GitHub'da çapraz kimlik doğrulama için bir pencere açar. Akışı takip edin ve sabırlı olun. Çok sayıda deponuz varsa bu işlem biraz zaman alabilir.
  • "Select repo" (Depo seçin) Hesabınızı/deponuzu seçin ve "I understand..." (Anlıyorum...) bölümünü işaretleyin.
  • Şu hatayı aldıysanız: GitHub Uygulaması, depolarınızın hiçbirine yüklenmedi. "Google Cloud Build'i yükle"yi tıklayın ve talimatları uygulayın.
  • 23e0e0f1219afea3.pngBağlan'ı tıklayın.
  • bafd904ec07122d2.png
  • Bingo! Deponuz bağlandı.
  • Tetikleyici bölümüne geri dönelim.
  • Yapılandırma: Otomatik algılanır (*)
  • Gelişmiş: "[PROJECT_NUMBER]- compute@developer.gserviceaccount.com" hizmet hesabını seçin.
  • xxxxx, proje kimliğinizdir.
  • Varsayılan Compute hizmet hesabı, laboratuvar yaklaşımı için uygundur ancak üretimde kullanılmamalıdır. (Daha fazla bilgi edinin).
  • Diğer her şeyi olduğu gibi bırakın.
  • "Oluştur" düğmesini tıklayın.

(*) Dockerfile veya cloudbuild.yaml dosyasını kontrol ettiği için en basit yöntem budur. Ancak cloudbuild.yaml, hangi adımda ne yapacağınıza karar verme konusunda size gerçek bir güç verir.

Güç bende!

Tetikleyicinin çalışması için Cloud Build hizmet hesabına (hizmet hesabı nedir? Bir görev için sizin adınıza hareket eden bir "robot"un e-posta adresidir. Bu durumda, Cloud'da öğeler oluşturur.

Çözüm mimarınız, yetki vermediğiniz sürece derleme ve dağıtım yapamaz. Neyse ki bu kolay bir işlem.

  • "Cloud Build" > "Ayarlar"a gidin.
  • "[PROJECT_NUMBER]- compute@developer.gserviceaccount.com" hizmet hesabı
  • Şu kutuları işaretleyin:
  • Cloud Run
  • Secret Manager
  • Hizmet Hesapları
  • Cloud Build
  • "Tercih edilen hizmet hesabı olarak ayarla" seçeneğini de işaretleyin.

8715acca72286a46.png

Cloud Build YAML dosyası nerede?

Kendi Cloud Build YAML dosyanızı oluşturmak için biraz zaman ayırmanızı önemle tavsiye ederiz.

Ancak zamanınız yoksa veya zaman ayırmak istemiyorsanız şu çözüm klasöründen ilham alabilirsiniz: .solutions

Artık GitHub'a bir değişiklik gönderebilir ve Cloud Build'in görevini yerine getirmesini izleyebilirsiniz.

Cloud Build'i ayarlamak zor olabilir. Şu tarihe kadar birkaç kez görüşme yapmanız gerekebilir:

  • https://console.cloud.google.com/cloud-build/builds;region=global adresinde günlükleri kontrol etme
  • Hatanız bulunuyor.
  • Koddaki hatayı düzeltip git commit / git push komutlarını yeniden çalıştırmak.
  • Bazen hata kodda değil, yapılandırmada olur. Bu durumda, kullanıcı arayüzünden yeni bir derleme oluşturabilirsiniz (Cloud Build > "Tetikleyiciler" > Çalıştır).

97acd16980a144ab.png

Bu çözümü kullanırsanız yapmanız gereken bazı işlemler vardır. Örneğin, yeni oluşturulan geliştirme/üretim uç noktaları için ENV değişkenlerini ayarlamanız gerekir:

3da8723e4ff80c0a.png

Bunu iki şekilde yapabilirsiniz:

  • Kullanıcı arayüzü üzerinden: ENV değişkenlerini tekrar ayarlayarak
  • CLI üzerinden sizin için "mükemmel" komut dosyasını oluşturarak Örnek için gcloud-run-deploy.sh dosyasına göz atabilirsiniz. Uç nokta ve proje numarası gibi birkaç şeyi değiştirmeniz gerekir. Proje numaranızı Cloud'a Genel Bakış bölümünde bulabilirsiniz.

GitHub'a nasıl kod eklerim?

GitHub'a git push yapmanın en iyi yolunu öğretmek bu atölyenin kapsamı dışındadır. Ancak takılırsanız ve Cloud Shell'deyseniz iki yöntem vardır:

  1. CLI. Yerel olarak bir SSH anahtarı ekleyin ve git@github.com:YOUR_USER/app-mod-workshop.git (http yerine) ile bir uzak depo ekleyin.
  2. VSCode. Cloud Shell düzenleyicisini kullanıyorsanız Kaynak denetimi (Ctrl-Üst Karakter-G) sekmesini kullanabilir, "Değişiklikleri senkronize et"i tıklayıp talimatları uygulayabilirsiniz. GitHub hesabınızın kimliğini VS Code'da doğrulayabilmeniz gerekir. Bu işlemden sonra, VS Code'dan çekme/gönderme işlemleri çok kolaylaşır.

f0d53f839c7fa3b6.png

Diğer dosyalar arasında git add clodubuild.yaml yapmayı unutmayın, aksi takdirde çalışmaz.

Derin ve yüzeysel "geliştirme/üretim eşitliği" [isteğe bağlı]

Model sürümünü buradan kopyaladıysanız iki adet aynı DEV ve PROD sürümünüz olur. Bu, On İki Faktörlü Uygulama'nın 10. kuralına uygun, iyi bir yaklaşımdır.

Ancak bir uygulamanın aynı veritabanını işaret etmesi için iki farklı web uç noktası kullanıyoruz. Bu, bir atölye için yeterlidir ancak gerçek hayatta uygun bir üretim ortamı oluşturmak için biraz zaman harcamanız gerekir. Bu, iki veritabanına (biri geliştirme, diğeri üretim için) sahip olmak ve olağanüstü durum kurtarma/yüksek kullanılabilirlik için bunları nerede barındıracağınızı seçmek anlamına gelir. Bu konu, bu atölyenin kapsamı dışında olsa da üzerinde düşünmeye değer.

Prodüksiyonun "derin" bir versiyonunu yapacak vaktiniz varsa kopyalamanız gereken tüm kaynakları göz önünde bulundurun. Örneğin:

  • Cloud SQL veritabanı (ve muhtemelen SQL örneği)
  • GCS paketi
  • Cloud Functions işlevi.
  • Geliştirme aşamasında model olarak Gemini 1.5 Flash'i (daha ucuz, daha hızlı) ve Gemini 1.5 Pro'yu (daha güçlü) kullanabilirsiniz.

Genel olarak, uygulamayla ilgili bir şey yaptığınızda her seferinde eleştirel bir şekilde düşünün: Üretim de aynı değere sahip olmalı mı, olmamalı mı? Değilse çabanızı iki katına çıkarın. Bu işlem, ortamınızı (-dev, -prod) kaynaklarınıza son ek olarak ekleyebileceğiniz Terraform ile çok daha kolaydır.

8. 6. Modül: Google Cloud Storage'a geçiş

a680e0f287dd2dfb.png

Depolama

dc3a4b8ea92aaef6.png

Uygulama şu anda durumu bir Docker container'ında depoluyor. Makine bozulursa, uygulama çökerse veya yalnızca yeni bir düzeltme gönderirseniz yeni ve boş bir depolama alanıyla yeni bir düzeltme planlanır: 🙈

Bunu nasıl düzeltebiliriz? Bunun çeşitli yolları vardır.

  1. Resimleri veritabanında depolama Önceki PHP uygulamamda da bunu yapmıştım. Karmaşıklık yaratmadığı için en basit çözüm bu. Ancak veritabanınıza gecikme ve yük eklediği kesin.
  2. Cloud Run uygulamanızı depolama alanı dostu bir çözüme (GCE + kalıcı disk) taşımak GKE + Storage olabilir mi? Not: Kontrolü artırdığınızda çevikliği kaybedersiniz.
  3. GCS'ye taşıyın. Google Cloud Storage, tüm Google Cloud için sınıfının en iyisi depolama alanını sunar ve bulut için en uygun çözümdür. Ancak bunun için PHP kitaplıklarını kullanmamız gerekir. GCS için PHP 5.7 kitaplıklarımız var mı? PHP 5.7, Composer sürümünü destekliyor mu? (Composer tarafından desteklenen en eski sürüm PHP 5.3.2 gibi görünüyor.)
  4. Docker sepeti kullanabilirsiniz.
  5. Alternatif olarak GCS Cloud Run birim bağlamalarını kullanabilirsiniz. Kulağa harika geliyor.

🤔 Depolama alanını taşıma (açık uçlu)

[Açık Uçlu] Bu alıştırmada, resimlerinizi bir şekilde kalıcı olacak şekilde taşıyabileceğiniz bir çözüm bulmanızı istiyoruz.

Kabul testi

Size çözümü söylemek istemiyorum ancak şunun olmasını istiyorum:

  1. newpic.jpg yüklediniz. Uygulamada görürsünüz.
  2. Uygulamayı yeni bir sürüme yükselttiğinizde
  3. newpic.jpg hâlâ orada ve görünüyor.

💡 Olası çözüm (GCS Cloud Run birim bağlamaları)

Bu, koda HİÇ dokunmadan durum bilgisi olan dosya yüklemeleri yapmamızı sağlayan çok zarif bir çözümdür (resim açıklaması gösterme dışında, ancak bu önemsizdir ve yalnızca göz zevki içindir).

Bu sayede Cloud Run'dan GCS'ye bir klasör bağlayabilirsiniz. Böylece:

  1. GCS'ye yüklenen her şey uygulamanızda görünür.
  2. Uygulamanıza yapılan tüm yüklemeler aslında GCS'ye yüklenir.
  3. GCS'ye yüklenen nesneler üzerinde sihirli işlemler gerçekleştirilecek (7. bölüm).

Not. Lütfen FUSE ile ilgili küçük yazıları okuyun. Performans önemliyse bu kabul edilebilir bir durum DEĞİLDİR.

GCS paketi oluşturma

GCS, Google Cloud'un her yerde bulunan depolama hizmetidir. Savaşta test edilmiştir ve depolama alanına ihtiyaç duyan her GCP hizmeti tarafından kullanılır.

Cloud Shell'in PROJECT_ID'yi GOOGLE_CLOUD_PROJECT olarak dışa aktardığını unutmayın:

$ 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/"

Cloud Run'ı, paketi /uploads/ klasörüne bağlayacak şekilde yapılandırma

Şimdi de şık kısma gelelim. Bir birim php_uploads oluşturur ve Cloud Run'a MOUNT_PATH üzerinde bir FUSE bağlama işlemi yapmasını söyleriz (/var/www/html/uploads/ gibi):

#!/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"

Şimdi, Cloud Storage'a yönlendirmek istediğiniz tüm uç noktalar için bu adımı tekrarlayın.

Aynı işlemi kullanıcı arayüzünden de yapabilirsiniz.

  1. "Volumes" (Birimler) sekmesinde, paketinizi işaret eden "Cloud Storage bucket" (Cloud Storage paketi) türünde bir birim ekleme noktası oluşturun (ör. "php_uploads" adıyla).
  2. Container'lar > Birim Bağlantıları bölümünde, yeni oluşturduğunuz birimi uygulamanızın istediği birim noktasına bağlayın. Bu, dockerfile'a bağlıdır ancak var/www/html/uploads/ gibi görünebilir.

Her iki durumda da, işlem başarılı olursa yeni Cloud Run düzeltmesini düzenlediğinizde şuna benzer bir ekran görürsünüz:

6c2bb98fc1b0e077.png

Şimdi /upload.php uç noktasına yeni bir resim yükleyerek yeni uygulamayı test edin.

Resimler, tek bir satır PHP yazmadan GCS'ye sorunsuz bir şekilde aktarılmalıdır:

70032b216afee2d7.png

Az önce ne oldu?

Sihirli bir şey oldu.

Eski kod içeren eski bir uygulama hâlâ işini yapıyor. Yeni ve modern bir yığın, uygulamamızdaki tüm resimlerin/görüntülerin durum bilgisi olan bir Cloud paketinde rahatça yer almasını sağlar. Artık sınır tanımayın:

  • "Tehlikeli" veya "çıplak" olarak etiketlenen her resim için e-posta göndermek mi istiyorsunuz? Bunu PHP koduna dokunmadan yapabilirsiniz.
  • Her resim geldiğinde çoklu format destekli Gemini modelini kullanarak resmi tanımlamak ve açıklamasıyla birlikte veritabanına yüklemek mi istiyorsunuz? Bunu PHP koduna dokunmadan yapabilirsiniz. Bana inanmıyor musun? 7. bölümde okumaya devam edin.

Burada büyük bir fırsat alanı açtık.

9. 7. Modül: Google Gemini ile Uygulamanızı Güçlendirme

c00425f0ad83b32c.png

Artık bulut tabanlı depolama alanına sahip, modern ve yepyeni bir PHP uygulamanız (2024 model Fiat 126 gibi) var.

Ne işe yarar?

Ön koşullar

Önceki bölümde, model çözüm sayesinde görüntüleri /uploads/ GCS'ye bağlayarak uygulama mantığını görüntü depolama alanından fiilen ayırmıştık.

Bu alıştırmada şunları yapmanız gerekir:

  • 6. bölümdeki (depolama) alıştırmayı başarıyla tamamlamış olmanız gerekir.
  • Kullanıcıların uygulamanıza yüklediği resimlerin aktarıldığı bir GCS paketi oluşturun.

Cloud Functions işlevi oluşturma (Python'da)

Etkinliğe dayalı bir uygulamanın nasıl uygulanacağını hiç merak ettiniz mi? Örneğin:

  • <etkinlik> gerçekleştiğinde => e-posta gönder
  • <event> gerçekleştiğinde => <condition> doğruysa veritabanını günceller.

Etkinlik; BigQuery'de yeni bir kaydın kullanılabilir olması, GCS'deki bir klasörde yeni bir nesnenin değiştirilmesi veya Pub/Sub'daki bir sırada yeni bir mesajın beklemesi gibi herhangi bir şey olabilir.

Google Cloud, bunu başarmak için birden fazla paradigmayı destekler. Özellikle:

Bu alıştırmada, oldukça etkileyici bir sonuç elde etmek için Cloud Functions işlevini ayrıntılı olarak inceleyeceğiz. Ayrıca isteğe bağlı alıştırmalar da sunacağız.

Örnek kodun .solutions/ kapsamında sağlandığını unutmayın.

Cloud Functions işlevi oluşturma (🐍 Python)

Çok iddialı bir GCF oluşturmaya çalışıyoruz.

  1. GCS'de yeni bir resim oluşturulduğunda.. (Muhtemelen birisi uygulamaya yüklediği için ancak tek neden bu olmayabilir.)
  2. .. Gemini'ı çağırarak resmi açıklamasını isteyin ve resmin metin açıklamasını alın .. (MIME'yi kontrol ederek PDF, MP3 veya metin değil, resim olduğundan emin olmak iyi olur)
  3. .. and update the DB with this description. (Bunun için veritabanına yama uygulayarak images tablosuna description sütunu eklemeniz gerekebilir.)

Resimlere description eklemek için veritabanını yamalayın

  1. Cloud SQL Studio'yu açın:

b92b07c4cba658ef.png

  1. Resim veritabanı için kullanıcı adınızı ve şifrenizi girin.
  2. Resim açıklaması için sütun ekleyen bu SQL'i ekleyin:

ALTER TABLE images ADD COLUMN description TEXT;

3691aced78a6389.png

İşte bu kadar! İşe yarayıp yaramadığını kontrol etmek için hemen deneyin:

SELECT * FROM images;

Yeni açıklama sütununu göreceksiniz:

bed69d6ad0263114.png

Gemini f(x) işlevini yazın.

Not. Bu işlev, Gemini Code Assist'in yardımıyla oluşturuldu.

Not. Bu işlevi oluştururken IAM izin hatalarıyla karşılaşabilirsiniz. Bunlardan bazıları aşağıda "Olası hatalar" paragrafında açıklanmıştır.

  1. API'leri etkinleştirme
  2. https://console.cloud.google.com/functions/list adresine gidin.
  3. "Create Function"ı (İşlev Oluştur) tıklayın.
  4. API'leri API sihirbazından etkinleştirme:

d22b82658cfd4c48.png

GCF'yi kullanıcı arayüzünden veya komut satırından oluşturabilirsiniz. Burada komut satırını kullanacağız.

Olası bir kod .solutions/ altında bulunabilir.

  1. Kodunuzu barındıracak bir klasör (ör. "gcf/") oluşturun. Klasöre girin.
  2. requirements.txt dosyası oluşturma:
google-cloud-storage
google-cloud-aiplatform
pymysql
  1. Python işlevi oluşturma Örnek kodu burada bulabilirsiniz: 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. İşlevi gönderin. Şuna benzer bir komut dosyası kullanabilirsiniz: gcf/push-to-gcf.sh.

1. not. ENV'leri doğru değerlerle kaynakladığınızdan emin olun veya bunları en üste ekleyin (GS_BUCKET=blah, ..):

2. not. Bu işlem tüm yerel kodları (.) aktarır. Bu nedenle, kodunuzu belirli bir klasöre yerleştirdiğinizden ve büyük kitaplıkları aktarmamak için .gcloudignore dosyasını profesyonelce kullandığınızdan emin olun. (örnek).

#!/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

Not: Bu örnekte, generate_caption çağrılan yöntem olacak ve Cloud Functions işlevi, GCS etkinliğini tüm alakalı bilgilerle (paket adı, nesne adı vb.) birlikte bu yönteme iletecek. Bu etkinlik Python sözlüğünde hata ayıklamak için biraz zaman ayırın.

İşlevi test etme

Birim Testleri

İşlevin birçok hareketli parçası vardır. Tüm tekli olanları test etmek isteyebilirsiniz.

gcf/test.py dosyasında bir örnek verilmiştir.

Cloud Functions kullanıcı arayüzü

Ayrıca kullanıcı arayüzünde işlevinizi incelemek için biraz zaman ayırın. Her sekme, özellikle de Source (benim favorim), Variables, Trigger ve Logs incelenmeye değerdir. Hataları gidermek için Logs sekmesinde çok zaman harcarsınız (bu sayfanın alt kısmındaki olası hatalara da bakın). Ayrıca Permissions sekmesini de kontrol edin.

cf3ded30d532a2c7.png

E2E Test

Şimdi işlevi manuel olarak test etme zamanı.

  1. Uygulamanıza gidip giriş yapın.
  2. Resim yükleyin (Çok büyük olmasın, büyük resimlerde sorun yaşandığını gördük)
  3. Kullanıcı arayüzünde resmin yüklendiğini kontrol edin.
  4. Cloud SQL Studio'da açıklamanın güncellenip güncellenmediğini kontrol edin. Giriş yapın ve şu sorguyu çalıştırın: SELECT * FROM images.

43a680b12dbbdda0.png

Bu yöntem kesinlikle işe yarıyor! Ayrıca, bu açıklamayı göstermek için ön ucu da güncellemek isteyebiliriz.

PHP'yi [isteğe bağlı] gösterecek şekilde güncelleyin

Uygulamanın çalıştığını kanıtladık. Ancak kullanıcıların da bu açıklamayı görebilmesi iyi olur.

index.php dosyasına açıklama eklemek için PHP uzmanı olmamız gerekmez. Bu kod işe yarayacaktır (evet, bunu da benim için Gemini yazdı):

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

Bu kodu foreach içine dilediğiniz gibi yerleştirin.

Sonraki adımlarda, Gemini Code Assist sayesinde daha güzel bir kullanıcı arayüzü sürümü de göreceğiz. Daha düzgün bir versiyonu şu şekilde görünebilir:

fdc12de0c88c4464.png

Sonuç

GCS'ye gelen yeni nesneler tarafından tetiklenen bir Cloud Functions işleviniz var. Bu işlev, resmin içeriğine bir insanın yapabileceği şekilde ek açıklama ekleyebilir ve veritabanını otomatik olarak güncelleyebilir. İnanılmaz!

Sırada ne var? Aynı mantığı kullanarak iki harika işlev elde edebilirsiniz.

[isteğe bağlı] Başka Cloud Functions işlevleri ekleyin [açık uçlu]

Aklıma birkaç ek özellik geliyor.

📩 E-posta Tetikleyicisi

Birisi her resim gönderdiğinde size e-posta gönderen bir e-posta tetikleyicisi.

  • Çok mu sık? Ek bir kısıtlama ekleyin: BÜYÜK bir resim veya Gemini içeriğinde "çıplak/çıplaklık/şiddet" kelimeleri geçen bir resim.
  • Bunun için EventArc sayfasını inceleyebilirsiniz.

🚫 Uygunsuz resimleri otomatik olarak denetleme

Şu anda bir yönetici, resimleri "uygunsuz" olarak işaretliyor. Gemini'ın zorlu işleri halletmesine ve alanı yönetmesine ne dersiniz? Uygunsuz tetikleyici içeriği işaretlemek için bir test ekleyin ve önceki işlevde öğrendiğimiz gibi veritabanını güncelleyin. Bu, temel olarak önceki işlevi alıp istemi değiştirmek ve veritabanını yanıta göre güncellemek anlamına gelir.

Uyarı. Üretken yapay zekanın çıktıları öngörülemez. Gemini'ın "yaratıcı çıktısının" "raylara oturtulduğundan" emin olun. 0 ile 1 arasında bir güven puanı veya JSON gibi kesin bir yanıt isteyebilirsiniz. Bunu birçok şekilde yapabilirsiniz. Örneğin: * Python kitaplıklarını (pydantic, langchain vb.) kullanma * Gemini Yapılandırılmış Çıktı'yı kullanma

İpucu. BİRDEN FAZLA işleviniz olabilir veya JSON yanıtını zorunlu kılan tek bir isteminiz olabilir (yukarıda vurgulandığı gibi "Gemini Yapılandırılmış Çıkış" ile harika çalışır). Örneğin:

Bunu oluşturmak için hangi istemi kullanırsınız?

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

İsteme ek alanlar ekleyerek "Bu ürünün iyi bir özelliği var mı?" gibi soruların yanıtlarını alabilirsiniz. Kötü mü? Bu yeri tanıyor musunuz? Metin var mı (OCR hiç bu kadar kolay olmamıştı):

  • goods: "Lezzetli bir yemeğe benziyor"
  • bads: "Sağlıksız bir yiyeceğe benziyor"
  • OCR: "Da consumare preferibilmente prima del 10 Novembre 2024"
  • location: "Pescara, Lungomare"

Genellikle N sonuç için N işlev kullanmak daha iyi olsa da 10 işi birden yapan bir işlev oluşturmak inanılmaz derecede tatmin edicidir. Nasıl yapıldığını öğrenmek için Riccardo'nun bu makalesine göz atın.

Olası hatalar (çoğunlukla IAM/izinler)

Bu çözümü ilk geliştirdiğimde bazı IAM izin sorunlarıyla karşılaştım. Empati kurmak ve bu sorunların nasıl çözüleceğine dair fikir vermek için bunları buraya ekleyeceğim.

Hata: Hizmet hesabı için yeterli izin yok

  1. Bir GCS paketini dinleyen GCF işlevini dağıtmak için iş için kullandığınız hizmet hesabına uygun izinleri ayarlamanız gerekir. Bu izinler aşağıdaki resimde gösterilmiştir:

22f51012fa6b4a24.png

EventArc API'lerini de etkinleştirmeniz gerekebilir. Tam olarak kullanılabilir hale gelmeleri için birkaç dakika bekleyin.

Hata: Cloud Run çağırıcısı eksik

  1. GCF izinleri için kullanıcı arayüzünden gelen bir diğer yorum da şudur (Cloud Run Çağırıcı rolü):

be72e17294f2d3f3.png

Bu hata, resimdeki komut çalıştırılarak düzeltilebilir. Bu komut, fix-permissions.sh komutuna benzer.

Bu sorun şu adreste açıklanmıştır: https://cloud.google.com/functions/docs/securing/authenticating

Hata: Bellek sınırı aşıldı

İlk çalıştırdığımda günlüklerimde şu ifade yer alabilir: "244 MiB bellek sınırı, 270 MiB kullanılarak aşıldı. Bellek sınırını artırabilirsiniz. https://cloud.google.com/functions/docs/configuring/memory adresine göz atın." GCF'nize RAM ekleyin. Bunu kullanıcı arayüzünde yapmak çok kolaydır. Olası bir sorun:

bed69d6ad0263114.png

Alternatif olarak, MEM/CPU'yu artırmak için Cloud Run dağıtım komut dosyanızı da düzeltebilirsiniz. Bu işlem biraz daha uzun sürer.

Hata: PubSub Yayınlandı

GCF v1 ile tetikleyici oluşturulurken bir kez şu hata alındı:

e5c338ee35ad4c24.png

Bu sorunu da IAM'e gidip hizmet hesabınıza "Pub/Sub Yayıncısı" rolünü vererek kolayca çözebilirsiniz.

Hata: Vertex AI kullanılmadı

Bu hatayı alırsanız:

Permission Denied: 403 Vertex AI API has not been used in project YOUR_PROJECT before or it is disabled. https://console.developers.google.com/apis/api/aiplatform.googleapis.com/overview?project=YOR_PROJECT adresini ziyaret ederek etkinleştirin.

Vertex AI API'lerini etkinleştirmeniz yeterlidir. Gerekli TÜM API'leri etkinleştirmenin en kolay yolu şudur:

  1. https://console.cloud.google.com/vertex-ai
  2. "Önerilen tüm API'leri etkinleştir"i tıklayın.

492f05ac377f3630.png

Hata: EventArc tetikleyicisi bulunamadı.

Bu hatayı alırsanız lütfen işlevi yeniden dağıtın.

8ec4fc11833d7420.png

Hata: 400 Hizmet aracılarının temel hazırlığı yapılıyor

400 Hizmet aracısı sağlanıyor ( https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents ). Sağlanan Cloud Storage dosyasını okumak için hizmet aracısı gerekir. Lütfen birkaç dakika sonra tekrar deneyin.

Bu durumda bir süre bekleyin veya bir Google çalışanına danışın.

10. 8. Modül: Kullanılabilirlik SLO'ları Oluşturma

Bu bölümde şunları yapmaya çalışacağız:

  1. SLI oluşturma
  2. HGD'lere dayalı HHD'ler oluşturma
  3. Hizmet düzeyi hedeflerine (SLO) dayalı uyarılar oluşturma

f63426182c052123.png

Riccardo, Google Cloud'un SRE/DevOps alanında çalıştığı için bu konu yazar için çok önemlidir.

(Açık uçlu) Bu uygulama için SLI'lar ve SLO'lar oluşturun

Çalışmadığını anlayamadığınız bir uygulama ne kadar iyi olabilir?

Hizmet seviyesi hedefi (SLO) nedir?

Eyvah! Hizmet düzeyi hedeflerini Google icat etti. Bu konu hakkında daha fazla bilgi edinmek için şunları okuyabilirsiniz:

1. adım: Kullanılabilirlik SLI/SLO'su oluşturun

Ölçmek istediğiniz en kolay ve muhtemelen en önemli şey olduğu için kullanılabilirlik SLO'su ile başlayalım.

Neyse ki Cloud Run, Istio sayesinde önceden oluşturulmuş SLO desteğiyle birlikte gelir.

Uygulamanız Cloud Run'da olduğunda bunu yapmak çok kolaydır ve yalnızca 30 saniye sürer.

  • Cloud Run sayfanıza gidin.
  • Uygulamanızı tıklayın/seçin.
  • SLOs sekmesini seçin.
  • "+ Hizmet seviyesi hedefi oluştur"u tıklayın.
  • Kullanılabilirlik, isteğe bağlı
  • Devam
  • Takvim ayı / %99.
  • "Hizmet seviyesi hedefi oluştur"u tıklayın.

e471c7ebdc56cdf6.png

2. adım: Bu SLO için uyarı oluşturun

2 uyarı oluşturmanızı öneririm:

  1. Düşük tükenme oranına ("Yavaş tükenme") sahip olan, sizi e-posta yoluyla uyarır (düşük öncelikli destek kaydını simüle eder).
  2. SMS ile sizi uyarmak için yüksek tükenme hızına ("Hızlı tükenme") sahip bir uyarı (yüksek öncelikli destek kaydı/sayfa gezgini simülasyonu yapar)

Önceki SLO tab sayfanıza gidin.

Bunu iki kez yapın:

314bfd6b9ef0a260.png

  • "Create SLO Alert"ü (sağda, içinde artı işareti bulunan 🔔 düğmesi) tıklayın.
  • Yeniden inceleme süresi, tükenme hızı eşiği:
  • [FAST]. İlk: 60 dk. / 10 x
  • [SLOW]. İkinci: 720 dk. / 2 x
  • Bildirim kanalı: Bildirim kanallarını yönet'i tıklayın.
  • Önce "E-posta" -> Yeni ekle -> ..
  • İkinci olarak, "SMS" -> Yeni ekle -> Telefonda doğrula.
  • İpucu: Adlarda emoji kullanmayı seviyorum. Demolar için eğlencelidir.
  • İşiniz bittiğinde sağ üstteki büyük X simgesini tıklayın.
  • Önce telefonu (hızlı), ardından e-postayı (yavaş) seçin.
  • Aşağıdakiler gibi örnek belgeler ekleyin:
  • [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.

Bingo!

Maç sonucu

Kullanılabilirlik için 1 çalışan SLO + 2 uyarı oluşturduğunuzda ve bu uyarılar e-postanıza ve telefonunuza gönderildiğinde bu alıştırmayı tamamlanmış sayabiliriz.

İsterseniz Gecikme ekleyebilirsiniz (bunu yapmanızı önemle tavsiye ederiz) veya daha karmaşık bir kural da ekleyebilirsiniz. Gecikme için makul olduğunu düşündüğünüz bir gecikme seçin. Emin değilseniz 200 ms'yi seçin.

11. Sonraki adımlar

HER ŞEYİ tamamladınız, eksik olan ne?

Üzerinde düşünülmesi gereken bazı noktalar:

Gemini'ı kullanma

Gemini'ı iki şekilde kullanabilirsiniz:

  1. Vertex AI. 7. bölümde (GCF + Gemini) incelediğimiz, GCP'nizle iç içe geçmiş"kurumsal yöntem". Tüm kimlik doğrulama işlemleri sorunsuz bir şekilde çalışır ve hizmetler birbirine mükemmel şekilde bağlanır.
  2. Google AI. "Tüketici yöntemi". Buradan bir Gemini API anahtarı alıp mevcut iş yüklerinize (özel çalışmalar, diğer bulutlar, yerel ana makine vb.) bağlanabilecek küçük komut dosyaları oluşturmaya başlarsınız. API anahtarınızı değiştirmeniz yeterlidir. Kod, sihirli bir şekilde çalışmaya başlar.

Kendi projelerinizde (2) özelliğini denemenizi öneririz.

Kullanıcı arayüzü yükseltme

Kullanıcı arayüzleri konusunda iyi değilim. Ancak Gemini bunu yapabilir. Tek bir PHP sayfası alıp şöyle bir şey diyebilirsiniz:

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!]

Cloud Build ile bu işlemi 5 dakikadan kısa sürede kolayca tamamlayabilirsiniz. :)

Gemini'ın yanıtı mükemmeldi (yani hiçbir şeyi değiştirmem gerekmedi):

8a3d5fe37ec40bf8.png

Yazarın kişisel uygulamasındaki yeni düzen ise şu şekilde:

81620eb90ae3229a.png

Not: Kodu kopyalayıp yapıştırmanızı değil, Gemini'ın kendi yaratıcı kullanıcı arayüzü/ön uç kısıtlamalarınızla kodu sizin için yazmasını istiyoruz. Bu nedenle, kod resim olarak yapıştırılmıştır. Gemini'ın yazdığı kodda daha sonra çok küçük değişiklikler yapmanız yeterli olacaktır.

Güvenlik

Bu uygulamanın güvenliğini sağlamak, bu 4 saatlik atölye çalışmasının hedefleri arasında değildir. Çünkü bu, atölye çalışmasının tamamlanma süresini 1-2 kat artırır.

Ancak bu konu çok önemlidir. SECURITY sayfasında bazı fikirler topladık.

12. Tebrikler!

Tebrikler 🎉🎉🎉 , eski PHP uygulamanızı Google Cloud ile başarıyla modernize ettiniz.

24cb9a39b1841fbd.png

Özetle, bu codelab'de şunları öğrendiniz:

  • Google Cloud SQL'de veritabanı dağıtma ve mevcut veritabanınızı buraya taşıma
  • PHP uygulamanızı Docker ve Buildpacks ile container mimarisine alma ve görüntüsünü Google Cloud Artifact Registry'de depolama
  • Container mimarisine alınmış uygulamanızı Cloud Run'a dağıtma ve Cloud SQL ile çalıştırma
  • Google Secret Manager'ı kullanarak hassas yapılandırma parametrelerini (ör. veritabanı şifresi) gizli bir şekilde depolama ve kullanma
  • GitHub deponuza kod gönderildiğinde PHP uygulamanızı otomatik olarak derlemek ve dağıtmak için Google Cloud Build ile CI/CD ardışık düzeninizi ayarlama
  • Uygulama kaynaklarınızı "buluta taşımak" için Cloud Storage'ı kullanma
  • Uygulama kodunuza dokunmadan Google Cloud üzerinde muhteşem iş akışları oluşturmak için sunucusuz teknolojilerden nasıl yararlanacağınızı öğreneceksiniz.
  • Çoklu format destekli Gemini'ın özelliklerini uygun bir kullanım alanında kullanın.
  • Google Cloud'da SRE ilkelerini uygulama

Google Cloud ile uygulama modernizasyonu yolculuğunuz için harika bir başlangıç yaptınız.

🔁 Geri bildirim

Bu atölye çalışmasıyla ilgili deneyiminizi bizimle paylaşmak isterseniz bu geri bildirim formunu doldurabilirsiniz.

Geri bildirimlerinizi ve özellikle gurur duyduğunuz kod parçaları için PR'lerinizi bekliyoruz.

🙏 Teşekkürler

Yazar, makalenin yazılmasına ve çözümün test edilmesine yardımcı olan Datatonic'ten Mirko Gilioli ve Maurizio Ipsale'ye teşekkür eder.