Google Cloud Beginner Guide

$ docker run -d --name pubsub -p 8085:8085 gcr.io/google.com/cloudsdktool/google-cloud-cli:emulators gcloud beta emulators pubsub start --host-port=0.0.0.0:8085 --project=shop-dev
c3b179e5790af64c70fca9732acd56451551b428c3e31f783ec2990b66592b2a

$ docker run -d --name firestore -p 8086:8086 gcr.io/google.com/cloudsdktool/google-cloud-cli:emulators gcloud emulators firestore start --host-port=0.0.0.0:8086
80a1fd17c7bd4e87f3c262afaf79f493bf00808d8200eeaf0474cb0f609fd478

$ docker run -d --name gcs -p 4443:4443 fsouza/fake-gcs-server -scheme http -port 4443 -public-host localhost:4443
8c347b7d9d50b176e584f86926fe1d629dc7f3e19875ac88077fbf80931dccd4

$ docker logs pubsub 2>&1 | tail -n 2
[pubsub] Oct 05, 2026 7:44:19 PM com.google.cloud.pubsub.testing.v1.Main main
[pubsub] INFO: Server started, listening on 8085

$ gcloud version | head -n 1
Google Cloud SDK 587.0.0

$ gcloud config list
[api_endpoint_overrides]
pubsub = http://localhost:8085/
storage = http://localhost:4443/storage/v1/
[component_manager]
disable_update_check = true
[core]
disable_prompts = 1
disable_usage_reporting = true
project = shop-dev
[metrics]
environment = docker_image_emulator

Your active configuration is: [default]

gcloud config list shows the endpoint overrides from the environment, so every pubsub and storage command goes to the emulators. The [metrics] and [component_manager] lines come from the Docker image. shop-dev is a made-up project; emulators accept any name.gcloud config list แสดง endpoint ที่ถูกแทนที่จากตัวแปรสภาพแวดล้อม ทุกคำสั่ง pubsub และ storage จึงไปที่ emulator บรรทัด [metrics] และ [component_manager] มาจาก Docker image ส่วน shop-dev เป็นชื่อโปรเจกต์สมมติ emulator รับชื่อใดก็ได้

$ gcloud storage buckets create gs://shop-photos --location=asia-southeast1
Creating gs://shop-photos/...

$ gcloud storage cp cat.jpg gs://shop-photos/2026/cat.jpg
Copying file://cat.jpg to gs://shop-photos/2026/cat.jpg

$ gcloud storage ls -l 'gs://shop-photos/**'
        33  2026-10-05T19:44:27Z  gs://shop-photos/2026/cat.jpg
TOTAL: 1 objects, 33 bytes (33.00B)

$ gcloud storage cat gs://shop-photos/2026/cat.jpg
pretend this is a photo of a cat

$ gcloud storage objects describe gs://shop-photos/2026/cat.jpg --format='yaml(name,size,content_type,storage_class)'
content_type: image/jpeg
name: 2026/cat.jpg
size: 33
storage_class: STANDARD

** matches objects at any depth; like an S3 key, the 2026/ is just part of the object's name. gcloud set content_type from the .jpg extension, and --format picks the fields to print, here as YAML.** จับคู่ object ทุกระดับความลึก 2026/ เป็นแค่ส่วนหนึ่งของชื่อ object เหมือน key ของ S3 gcloud ตั้ง content_type จากนามสกุล .jpg และ --format เลือกฟิลด์ที่จะพิมพ์ ในที่นี้เป็น YAML

$ gcloud pubsub topics create order-events
Created topic [projects/shop-dev/topics/order-events].

$ gcloud pubsub subscriptions create emails --topic=order-events
$ gcloud pubsub subscriptions create analytics --topic=order-events
Created subscription [projects/shop-dev/subscriptions/emails].
Created subscription [projects/shop-dev/subscriptions/analytics].

$ gcloud pubsub topics publish order-events --message="order 1001 paid" --attribute=type=paid
messageIds:
- '1'

$ gcloud pubsub subscriptions pull emails --auto-ack
┌─────────────────┬────────────┬──────────────┬────────────┬──────────────────┬────────────┐
│       DATA      │ MESSAGE_ID │ ORDERING_KEY │ ATTRIBUTES │ DELIVERY_ATTEMPT │ ACK_STATUS │
├─────────────────┼────────────┼──────────────┼────────────┼──────────────────┼────────────┤
│ order 1001 paid │ 1          │              │ type=paid  │                  │ SUCCESS    │
└─────────────────┴────────────┴──────────────┴────────────┴──────────────────┴────────────┘

$ gcloud pubsub subscriptions pull analytics --auto-ack --format='value(message.data, message.attributes.type)'
order 1001 paid	paid

One publish, two copies: emails and analytics each received the message. --auto-ack acks it straight away, and value(...) prints chosen fields instead of the table, separated by a tab: the data, then the type attribute. The emulator numbers messages from 1; real message IDs are long numbers.ส่งครั้งเดียวได้สองสำเนา ทั้ง emails และ analytics ต่างได้รับข้อความ --auto-ack ทำการ ack ทันที และ value(...) พิมพ์เฉพาะฟิลด์ที่เลือกแทนตาราง โดยคั่นด้วย tab คือข้อมูล ตามด้วย attribute type emulator นับเลขข้อความจาก 1 ส่วน ID ของข้อความจริงเป็นตัวเลขยาว

$ cd sdk && npm install --no-fund --no-audit
npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead
npm warn deprecated glob@10.5.0: Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me

added 117 packages in 4s

$ cd sdk && node firestore.mjs
(node:92304) MetadataLookupWarning: received unexpected error = All promises were rejected code = ETIMEDOUT, ENOTFOUND
(Use `node --trace-warnings ...` to show where the warning was created)
one document: 1002 { customer: 'mya', total: 45, items: [ 'coffee' ] }
mya's orders: 1001=120, 1002=45
after update: { customer: 'mya', items: [ 'coffee' ], paid: true, total: 50 }

The npm warnings are about packages the SDK uses internally; they aren't errors. The MetadataLookupWarning comes from Google's auth library: it asked the metadata server, which exists only on Google Cloud, whether the code runs there. With the emulator on a laptop it is harmless. FieldValue.increment(5) changed 45 to 50 on the server, without reading the document first.คำเตือนของ npm เกี่ยวกับแพ็กเกจที่ SDK ใช้ภายใน ไม่ใช่ข้อผิดพลาด ส่วน MetadataLookupWarning มาจากไลบรารี auth ของ Google ซึ่งถาม metadata server (มีอยู่บน Google Cloud เท่านั้น) ว่าโค้ดรันอยู่บน Google Cloud หรือไม่ เมื่อใช้ emulator บนโน้ตบุ๊กจึงไม่เป็นอันตราย FieldValue.increment(5) เปลี่ยน 45 เป็น 50 ที่ฝั่งเซิร์ฟเวอร์ โดยไม่ต้องอ่านเอกสารก่อน

$ cd run && docker build -q -t shop-run .
sha256:7373aa8ba385446a346f3bdceb5952d22511f57eb8e2cf31a1885d992e47ede2

$ docker run -d --name shop-run -p 8096:8080 -e PORT=8080 shop-run
2d45fd7425cfa1ca2e1edaa36dc04ae20be9007ce65ecab53ada5df5832475bd

$ curl -s localhost:8096/orders
{"message":"Hello from Cloud Run","revision":"local","path":"/orders"}

$ docker logs shop-run
listening on 8080

$ time docker stop shop-run
shop-run

real	0m0.170s
user	0m0.007s
sys	0m0.005s

Docker passes PORT=8080 the way Cloud Run does; on Cloud Run, revision would show the revision's name from K_REVISION. docker stop sends SIGTERM first. The server exits at once, so the stop took 0.17 s instead of Docker's 10-second wait. Cloud Run sends the same signal before it shuts an instance down.Docker ส่ง PORT=8080 แบบเดียวกับที่ Cloud Run ทำ บน Cloud Run ค่า revision จะเป็นชื่อ revision จาก K_REVISION docker stop ส่ง SIGTERM ก่อน เซิร์ฟเวอร์ออกทันที การหยุดจึงใช้เวลา 0.17 วินาที แทนที่จะรอ 10 วินาทีตามค่าของ Docker Cloud Run ก็ส่งสัญญาณเดียวกันก่อนปิด instance

$ cd fn && npm install --no-fund --no-audit
npm warn deprecated uuid@8.3.2: uuid@10 and below is no longer supported.  For ESM codebases, update to uuid@latest.  For CommonJS codebases, use uuid@11 (but be aware this version will likely be deprecated in 2028).

added 128 packages in 6s

$ npx functions-framework --target=hello --port=8097
Serving function...
Function: hello
Signature type: http
URL: http://localhost:8097/

$ curl -s "localhost:8097/?name=Mya"; echo
Hello, Mya!

$ npx functions-framework --target=onOrder --signature-type=cloudevent --port=8098
Serving function...
Function: onOrder
Signature type: cloudevent
URL: http://localhost:8098/
order event 41: order 1001 paid

$ curl -s -o /dev/null -w "%{http_code}\n" localhost:8098 \
  -H "ce-id: 41" -H "ce-specversion: 1.0" -H "ce-source: //pubsub.googleapis.com/projects/shop-dev/topics/order-events" \
  -H "ce-type: google.cloud.pubsub.topic.v1.messagePublished" -H "Content-Type: application/json" \
  -d "{\"message\": {\"data\": \"$(printf 'order 1001 paid' | base64)\"}}"
204

204 means the function finished without an error. Its log line, order event 41: order 1001 paid, is the last line in the second terminal.204 หมายถึงฟังก์ชันทำงานเสร็จโดยไม่มีข้อผิดพลาด บรรทัด log ของมัน order event 41: order 1001 paid คือบรรทัดสุดท้ายในเทอร์มินัลที่สอง

$ cd tf && terraform init -no-color
Initializing the backend...

Initializing provider plugins...
- Finding hashicorp/google versions matching "~> 7.0"...
- Installing hashicorp/google v7.46.1...
- Installed hashicorp/google v7.46.1 (signed by HashiCorp)

Terraform has created a lock file .terraform.lock.hcl to record the provider
selections it made above. Include this file in your version control repository
so that Terraform can guarantee to make the same selections by default when
you run "terraform init" in the future.

Terraform has been successfully initialized!
⋯ 8 more lines ⋯⋯ อีก 8 บรรทัด ⋯

$ cd tf && terraform plan -no-color
Terraform used the selected providers to generate the following execution
plan. Resource actions are indicated with the following symbols:
  + create

Terraform will perform the following actions:
⋯ 20 more lines ⋯⋯ อีก 20 บรรทัด ⋯
  # google_pubsub_subscription.emails will be created
  + resource "google_pubsub_subscription" "emails" {
      + ack_deadline_seconds       = 20
      + deletion_policy            = "DELETE"
      + effective_labels           = {
          + "goog-terraform-provisioned" = "true"
        }
      + id                         = (known after apply)
      + message_retention_duration = "604800s"
      + name                       = "emails"
      + project                    = "shop-dev"
      + terraform_labels           = {
          + "goog-terraform-provisioned" = "true"
        }
      + topic                      = (known after apply)

      + expiration_policy (known after apply)
    }
⋯ 17 more lines ⋯⋯ อีก 17 บรรทัด ⋯
Plan: 3 to add, 0 to change, 0 to destroy.

Changes to Outputs:
  + topic_id = (known after apply)

─────────────────────────────────────────────────────────────────────────────

Note: You didn't use the -out option to save this plan, so Terraform can't
guarantee to take exactly these actions if you run "terraform apply" now.

$ cd tf && terraform apply -auto-approve -no-color
⋯ 60 lines: the same plan as above ⋯⋯ 60 บรรทัด: แผนเดียวกับข้างบน ⋯
Plan: 3 to add, 0 to change, 0 to destroy.
⋯ 3 lines: the same plan as above ⋯⋯ 3 บรรทัด: แผนเดียวกับข้างบน ⋯
google_pubsub_topic.orders: Creating...
google_pubsub_topic.orders: Creation complete after 0s [id=projects/shop-dev/topics/order-events]
google_pubsub_subscription.analytics: Creating...
google_pubsub_subscription.emails: Creating...
google_pubsub_subscription.emails: Creation complete after 0s [id=projects/shop-dev/subscriptions/emails]
google_pubsub_subscription.analytics: Creation complete after 0s [id=projects/shop-dev/subscriptions/analytics]

Apply complete! Resources: 3 added, 0 changed, 0 destroyed.

Outputs:

topic_id = "projects/shop-dev/topics/order-events"

$ cd tf && terraform state list
google_pubsub_subscription.analytics
google_pubsub_subscription.emails
google_pubsub_topic.orders

$ gcloud pubsub subscriptions list --format="value(name.basename(), ackDeadlineSeconds, messageRetentionDuration)"
analytics	10	86400s
emails	20	604800s

$ cd tf && terraform plan -no-color | grep -E "^No changes|^Plan:"
No changes. Your infrastructure matches the configuration.

+ means create. Values marked (known after apply) come from Google once the resource exists. The provider adds the label goog-terraform-provisioned by itself, so you can see in the console which resources Terraform made. -no-color only keeps this recording plain; leave it off in your terminal.+ หมายถึงสร้างใหม่ ค่าที่มีป้าย (known after apply) จะได้จาก Google เมื่อทรัพยากรถูกสร้างแล้ว provider เพิ่มป้ายกำกับ goog-terraform-provisioned ให้เอง จึงดูใน console ได้ว่าทรัพยากรไหน Terraform สร้าง ส่วน -no-color ใช้แค่ให้การบันทึกนี้เป็นข้อความเรียบๆ ในเทอร์มินัลของเราไม่ต้องใส่

$ cd tf && terraform plan -no-color | grep -E "~|Plan:"
  ~ update in-place
  ~ resource "google_pubsub_subscription" "emails" {
      ~ ack_deadline_seconds         = 20 -> 30
Plan: 0 to add, 1 to change, 0 to destroy.

~ means update in place: the subscription stays and only the setting changes. The emulator can't apply updates (it rejects the request the provider sends), so this guide stops at the plan; on Google Cloud, terraform apply makes the change. Set it back to 20 before you go on.~ หมายถึงอัปเดตในที่เดิม subscription ยังอยู่ เปลี่ยนแค่ค่าตั้ง emulator ใช้การอัปเดตไม่ได้ (มันปฏิเสธคำขอที่ provider ส่งไป) คู่มือนี้จึงหยุดที่ plan บน Google Cloud จริง terraform apply จะทำการเปลี่ยนแปลงให้ แก้ค่ากลับเป็น 20 ก่อนทำต่อ

$ cd tf && terraform destroy -auto-approve -no-color | tail -n 4
google_pubsub_topic.orders: Destroying... [id=projects/shop-dev/topics/order-events]
google_pubsub_topic.orders: Destruction complete after 0s

Destroy complete! Resources: 3 destroyed.