1. Genel Bakış
Bu codelab'de, Cloud Run'da etkinlikleri almak için yeni bir hizmet olan Eventarc tarafından tetiklenecek yeni bir Cloud Run hizmeti (resim çöp toplayıcısı) oluşturacaksınız. Resimler paketinden bir resim silindiğinde hizmet, Eventarc'tan bir etkinlik alır. Ardından, resmi küçük resimler paketinden siler ve Firestore resimler koleksiyonundan da kaldırır.

Neler öğreneceksiniz?
- Cloud Run
- Cloud Storage
- Cloud Firestore
- Eventarc
2. Kurulum ve Gereksinimler
Yönlendirmesiz ortam kurulumu
- Google Cloud Console'da oturum açın ve yeni bir proje oluşturun veya mevcut bir projeyi yeniden kullanın. Gmail veya Google Workspace hesabınız yoksa hesap oluşturmanız gerekir.



- Proje adı, bu projenin katılımcıları için görünen addır. Bu, Google API'leri tarafından kullanılmayan bir karakter dizesidir ve istediğiniz zaman güncelleyebilirsiniz.
- Proje kimliği, tüm Google Cloud projelerinde benzersiz olmalıdır ve değiştirilemez (ayarlandıktan sonra değiştirilemez). Cloud Console, benzersiz bir dizeyi otomatik olarak oluşturur. Genellikle bu dizeyi dikkate almanız gerekmez. Çoğu codelab'de proje kimliğine (genellikle
PROJECT_IDolarak tanımlanır) başvurmanız gerekir. Bu nedenle, oluşturulan dizeyi beğenmezseniz başka bir rastgele dize oluşturun veya kendi dizeyi deneyip kullanılabilir olup olmadığına bakın. Proje oluşturulduktan sonra ise "dondurulur". - Bazı API'lerin kullandığı üçüncü bir değer olan proje numarası da vardır. Bu üç değer hakkında daha fazla bilgiyi belgelerde bulabilirsiniz.
- Ardından, Cloud kaynaklarını/API'lerini kullanmak için Cloud Console'da faturalandırmayı etkinleştirmeniz gerekir. Bu codelab'i tamamlamak için çok az ücret ödemeniz gerekir veya hiç ücret ödemeniz gerekmez. Bu eğitimden sonra faturalandırma ücreti alınmaması için kaynakları kapatmak üzere codelab'in sonunda yer alan "temizleme" talimatlarını uygulayın. Google Cloud'un yeni kullanıcıları, 300 ABD doları değerinde ücretsiz deneme programından yararlanabilir.
Cloud Shell'i başlatma
Google Cloud'u dizüstü bilgisayarınızdan uzaktan çalıştırabilirsiniz ancak bu codelab'de, Cloud'da çalışan bir komut satırı ortamı olan Google Cloud Shell'i kullanacaksınız.
GCP Console'da, sağ üstteki araç çubuğunda bulunan Cloud Shell simgesini tıklayın:

Birkaç saniye içinde ortamın temel hazırlığı yapılır ve bağlantı kurulur. İşlem tamamlandığında şuna benzer bir sonuç görürsünüz:

Bu sanal makine, ihtiyaç duyacağınız tüm geliştirme araçlarıyla yüklüdür. 5 GB boyutunda kalıcı bir ana dizin bulunur ve Google Cloud'da çalışır. Bu sayede ağ performansı ve kimlik doğrulama önemli ölçüde güçlenir. Bu laboratuvardaki tüm çalışmalarınızı yalnızca bir tarayıcı kullanarak yapabilirsiniz.
3. Eventarc'a giriş
Eventarc, Cloud Run hizmetlerini çeşitli kaynaklardan gelen etkinliklere bağlamayı kolaylaştırır. Etkinlik besleme, yayınlama, güvenlik, yetkilendirme ve hata işleme işlemlerini sizin yerinize gerçekleştirir.

Google Cloud kaynaklarından ve Cloud Pub/Sub'da yayınlanan özel uygulamalardan etkinlikleri alıp Google Cloud Run havuzlarına gönderebilirsiniz.
Çeşitli Google Cloud kaynaklarından gelen etkinlikler, Cloud Denetleme Günlükleri aracılığıyla yayınlanır. Bu kaynaklardan etkinlik yayınlamanın gecikme süresi ve kullanılabilirliği, Cloud Denetleme Günlükleri'ne bağlıdır. Bir Google Cloud kaynağından etkinlik tetiklendiğinde ilgili Cloud Denetleme Günlüğü girişi oluşturulur.
Cloud Pub/Sub'da yayın yapan özel uygulamalar, belirttikleri bir Pub/Sub konusuna herhangi bir biçimde mesaj yayınlayabilir.
Etkinlik tetikleyicileri, hangi etkinliklerin hangi havuza gönderileceğini belirten filtreleme mekanizmasıdır.
Tüm etkinlikler, hizmetler arası birlikte çalışabilirlik için CloudEvents v1.0 biçiminde yayınlanır.
4. Başlamadan önce
API'leri etkinleştir
Cloud Run hizmetini tetiklemek için Eventarc hizmetini kullanmanız gerekir. Etkinleştirildiğinden emin olun:
gcloud services enable eventarc.googleapis.com
İşlemin başarıyla tamamlandığını görmeniz gerekir:
Operation "operations/acf.5c5ef4f6-f734-455d-b2f0-ee70b5a17322" finished successfully.
Hizmet hesaplarını yapılandır
Tetikleyicilerde varsayılan Compute hizmet hesabı kullanılır. Varsayılan Compute hizmet hesabına eventarc.eventReceiver rolünü verin:
PROJECT_NUMBER=$(gcloud projects describe $GOOGLE_CLOUD_PROJECT --format='value(projectNumber)')
gcloud projects add-iam-policy-binding $GOOGLE_CLOUD_PROJECT \
--member serviceAccount:$PROJECT_NUMBER-compute@developer.gserviceaccount.com \
--role roles/eventarc.eventReceiver
Cloud Storage hizmet hesabına pubsub.publisher rolünü verin. Bu, Eventarc Cloud Storage tetikleyicisi için gereklidir:
SERVICE_ACCOUNT=$(gsutil kms serviceaccount -p $PROJECT_NUMBER)
gcloud projects add-iam-policy-binding $PROJECT_NUMBER \
--member serviceAccount:$SERVICE_ACCOUNT \
--role roles/pubsub.publisher
Pub/Sub hizmet hesabını 8 Nisan 2021'de veya daha önce etkinleştirdiyseniz Pub/Sub hizmet hesabına iam.serviceAccountTokenCreator rolünü verin:
gcloud projects add-iam-policy-binding $PROJECT_ID \ --member serviceAccount:service-$PROJECT_NUMBER@gcp-sa-pubsub.iam.gserviceaccount.com \ --role roles/iam.serviceAccountTokenCreator
5. Kodu klonlama
Önceki kod laboratuvarında klonlamadıysanız kodu klonlayın:
git clone https://github.com/GoogleCloudPlatform/serverless-photosharing-workshop
Ardından, hizmeti içeren dizine gidebilirsiniz:
cd serverless-photosharing-workshop/services/garbage-collector/nodejs
Hizmet için aşağıdaki dosya düzenine sahip olursunuz:
services
|
├── garbage-collector
|
├── nodejs
|
├── index.js
├── package.json
Klasörün içinde 3 dosya var:
index.js, Node.js kodunu içerir.package.json, kitaplık bağımlılıklarını tanımlar
6. Kodu inceleme
Bağımlılıklar
package.json dosyası, gerekli kitaplık bağımlılıklarını tanımlar:
{
"name": "garbage_collector_service",
"version": "0.0.1",
"main": "index.js",
"scripts": {
"start": "node index.js"
},
"dependencies": {
"cloudevents": "^4.0.1",
"express": "^4.17.1",
"@google/events": "^3.1.0",
"@google-cloud/firestore": "^4.9.9",
"@google-cloud/storage": "^5.8.3"
}
}
Cloud Storage'daki resimleri silmek için Cloud Storage kitaplığını kullanırız. Daha önce depoladığımız resim meta verilerini de silmek için Cloud Firestore'a bağımlılık bildiririz. Ayrıca Eventarc tarafından gönderilen CloudEvents'i okumak için CloudEvents SDK'sı ve Google Events kitaplıklarını kullanırız. Express, bir JavaScript/Node web çerçevesidir. Bluebird, promise'leri işlemek için kullanılır.
index.js
index.js kodumuzu daha yakından inceleyelim:
const express = require('express');
const {Storage} = require('@google-cloud/storage');
const Firestore = require('@google-cloud/firestore');
const { HTTP } = require("cloudevents");
const {toStorageObjectData} = require('@google/events/cloud/storage/v1/StorageObjectData');
Programımızın çalışması için gereken çeşitli bağımlılıklar vardır: Express, kullanacağımız Node web çerçevesidir; Bluebird, JavaScript vaatlerini işlemek için kullanılan bir kitaplıktır; Storage ve Firestore ise sırasıyla Google Cloud Storage (resim paketlerimiz) ve Cloud Firestore veri deposu ile çalışmak için kullanılır. Ayrıca CloudEvent'in Cloud Storage etkinlik gövdesini okumak için Google Events kitaplığından Eventarc StoreObjectData tarafından gönderilen CloudEvent'i okumak üzere CloudEvent'e ihtiyacımız vardır.
const app = express();
app.use(express.json());
app.post('/', async (req, res) => {
try {
const cloudEvent = HTTP.toEvent({ headers: req.headers, body: req.body });
console.log(cloudEvent);
/* ... */
} catch (err) {
console.log(`Error: ${err}`);
res.status(500).send(err);
}
});
Yukarıda Node işleyicimizin yapısını görüyoruz: Uygulamamız HTTP POST isteklerine yanıt veriyor. HTTP isteğinden CloudEvent'i okur ve bir şeyler ters giderse diye hata işleme yapar. Şimdi bu yapının içinde neler olduğuna bakalım.
Sonraki adımda CloudEvent gövdesini alıp ayrıştırın ve nesne adını alın:
const storageObjectData = toStorageObjectData(cloudEvent.data);
console.log(storageObjectData);
const objectName = storageObjectData.name;
Resmin adını öğrendikten sonra resmi küçük resimler paketinden silebiliriz:
try {
await storage.bucket(bucketThumbnails).file(objectName).delete();
console.log(`Deleted '${objectName}' from bucket '${bucketThumbnails}'.`);
}
catch(err) {
console.log(`Failed to delete '${objectName}' from bucket '${bucketThumbnails}': ${err}.`);
}
Son adım olarak, resim meta verilerini Firestore koleksiyonundan da silin:
try {
const pictureStore = new Firestore().collection('pictures');
const docRef = pictureStore.doc(objectName);
await docRef.delete();
console.log(`Deleted '${objectName}' from Firestore collection 'pictures'`);
}
catch(err) {
console.log(`Failed to delete '${objectName}' from Firestore: ${err}.`);
}
res.status(200).send(`Processed '${objectName}'.`);
Şimdi Node komut dosyamızın gelen istekleri dinlemesini sağlayalım. Gerekli ortam değişkenlerinin ayarlanıp ayarlanmadığını da kontrol edin:
app.listen(PORT, () => {
if (!bucketThumbnails) throw new Error("BUCKET_THUMBNAILS not set");
console.log(`Started service on port ${PORT}`);
});
7. Yerel olarak test etme
Kodu buluta dağıtmadan önce yerel olarak test ederek çalıştığından emin olun.
garbage-collector/nodejs klasöründe npm bağımlılıklarını yükleyin ve sunucuyu başlatın:
export BUCKET_THUMBNAILS=thumbnails-$GOOGLE_CLOUD_PROJECT npm install; npm start
Her şey yolunda gittiyse sunucu 8080 numaralı bağlantı noktasında başlatılır:
Started service on port 8080
Çıkmak için CTRL-C tuşuna basın.
8. Cloud Run'da derleme ve dağıtma
Cloud Run'a dağıtmadan önce Cloud Run bölgesini desteklenen bölgelerden birine, platformu ise managed olarak ayarlayın:
REGION=europe-west1 gcloud config set run/region $REGION gcloud config set run/platform managed
Yapılandırmanın ayarlandığını kontrol edebilirsiniz:
gcloud config list ... [run] platform = managed region = europe-west1
Cloud Build'i kullanarak container görüntüsünü manuel olarak oluşturup yayınlamak yerine, Google Cloud Buildpacks ile container görüntüsünü sizin için oluşturması için Cloud Run'ı da kullanabilirsiniz.
Google Cloud Buildpack'leri kullanarak container görüntüsünü derlemek ve ardından container görüntüsünü Cloud Run'a dağıtmak için aşağıdaki komutu çalıştırın:
SERVICE_NAME=garbage-collector-service
gcloud run deploy $SERVICE_NAME \
--source . \
--no-allow-unauthenticated \
--update-env-vars BUCKET_THUMBNAILS=$BUCKET_THUMBNAILS
–-source işaretine dikkat edin. Bu, Cloud Run'ı Dockerfile. olmadan container görüntüsünü oluşturmak için Google Cloud Buildpacks'i kullanacak şekilde işaretler. --no-allow-unauthenticated işareti, Cloud Run hizmetini yalnızca belirli hizmet hesapları tarafından tetiklenecek dahili bir hizmet haline getirir. Daha sonra, dahili Cloud Run hizmetlerini çağırmak için run.invoker rolüne sahip varsayılan Compute Engine hizmet hesabıyla bir tetikleyici oluşturacaksınız.
9. Tetikleyici oluşturma
Eventarc'ta tetikleyici, hangi hizmetin ne tür etkinlikler alması gerektiğini tanımlar. Bu durumda, bir paketteki dosya silindiğinde hizmetin etkinlikleri almasını istersiniz.
Tetikleyicinin konumunu, yüklenen resimler paketinin bulunduğu bölgeye ayarlayın:
gcloud config set eventarc/location eu
storage.objects.delete etkinliklerini filtrelemek ve Cloud Run hizmetine göndermek için bir AuditLog tetikleyicisi oluşturun:
BUCKET_IMAGES=uploaded-pictures-$GOOGLE_CLOUD_PROJECT gcloud eventarc triggers create trigger-$SERVICE_NAME \ --destination-run-service=$SERVICE_NAME \ --destination-run-region=$REGION \ --event-filters="type=google.cloud.storage.object.v1.deleted" \ --event-filters="bucket=$BUCKET_IMAGES" \ --service-account=$PROJECT_NUMBER-compute@developer.gserviceaccount.com
Tetikleyicinin oluşturulduğunu şu komutla doğrulayabilirsiniz:
gcloud eventarc triggers list
10. Hizmeti test etme
Hizmetin çalışıp çalışmadığını test etmek için uploaded-pictures paketine gidin ve resimlerden birini silin. Hizmetin günlüklerinde, thumbnails paketindeki ilgili resmi ve pictures Firestore koleksiyonundaki dokümanını sildiğini görebilirsiniz.

11. Temizleme (isteğe bağlı)
Serideki diğer laboratuvarlara devam etmeyi düşünmüyorsanız maliyetleri azaltmak ve genel olarak iyi bir bulut vatandaşı olmak için kaynakları temizleyebilirsiniz. Kaynakları aşağıdaki gibi tek tek temizleyebilirsiniz.
Hizmeti silin:
gcloud run services delete $SERVICE_NAME -q
Eventarc tetikleyicisini silin:
gcloud eventarc triggers delete trigger-$SERVICE_NAME -q
Alternatif olarak, projenin tamamını silebilirsiniz:
gcloud projects delete $GOOGLE_CLOUD_PROJECT
12. Tebrikler!
Tebrikler! Cloud Run'da etkinlikleri almak için yeni bir hizmet olan Eventarc tarafından tetiklenen bir Cloud Run hizmeti (görüntü çöp toplayıcısı) oluşturdunuz. Resimler paketinden bir resim silindiğinde hizmet, Eventarc'tan bir etkinlik alır. Ardından, resmi küçük resimler paketinden siler ve Firestore resimler koleksiyonundan da kaldırır.
İşlediklerimiz
- Cloud Run
- Cloud Storage
- Cloud Firestore
- Eventarc