Artifact Registry - 東東 GCP 教學 - GCP 實戰講師

儲存容器映像檔的 Artifact Registry 簡介與上傳 Docker 映像檔教學

admin — Sun, 20 Jul 2025 08:18:56 +0000

Artifact Registry 簡介

Artifact Registry 是 Google Cloud 中專門的容器映像檔儲存庫，當時在 Artifact Registry 推出之前，己經有 Container Registry，但 Container Registry 只支援 Docker 映像檔，並且功能較為簡單，也沒有細緻的權限管理機制，所以 Google 在 2020 年推出 Artifact Registry，作為 Container Registry 的全面升級。

Artifact Registry 除了 Docker 映像外，還支援 Maven Artifacts（Java）、Npm Packages、Python Packages、Helm Charts 等等。

建立容器映像檔示範

準備 Nodejs 程式檔案

接著我們就開始打造一個容器映像檔，並上傳到 Artifact Registry 吧！

首先我們一樣開啟 Cloud Shell，建立一個資料夾例如 nodejs01，然後先建立第一個檔案 server.js

var http = require('http');
var handleRequest = function(request, response) {
  response.writeHead(200);
  response.end("Hello World from Dongdong Nodejs!!");
}
var www = http.createServer(handleRequest);
www.listen(8080);

然後測試程式能否運作，輸入 node server.js，可以點擊預覽網頁的按鈕，看看網頁是否秀出內容：

執行 Nodejs 程式並預覽網頁

準備 Dockerfile

如果確認沒問題，再按下 ctrl + C 取回游標，接著準備第二個檔案 Dockerfile 內容如下：

FROM node:6.9.2
EXPOSE 8080
COPY server.js .
CMD node server.js

Dockerfile 是說明檔，告訴 Docker 要如何打包這個 Image，包含這個容器使用什麼程式語言、對外開放哪個 Port、程式的檔案在哪裡、用什麼指令來跑程式等等。

現在我們已經準備好兩個檔案如下：

確認目前準備好兩個檔案

建立 Artifact Registry 存放區

接著我們回到 Google Cloud Console，去 Artifact Registry 建立一個存放區：

建立 Artifact Registry 存放區

我們命名「nodejs-1」，格式選擇 Docker，Region 選在 asia-east1，再按下「建立」。完成之後就會看到它顯示在存放區的列表：

設定映像檔存放區的名稱、格式和儲存位置

取得憑證

點擊「設定操作說明」，它會開啟一個視窗，並提供一個 gcloud 指令，把它複製起來，這樣之後才能從 Cloud Shell 直接推送映像檔上去：

設定 gcloud 為憑證輔助程式

直接將指令貼到 Cloud Shell 並執行，等它完成即可，你會看到它說 gcloud credentials 註冊成功：

等待指令執完成

建立 Docker 容器映像檔

接下來準備 Docker image 的完整名稱，它同時也是存放在 Artifact Registry 的路徑，格式如下：

[位置]/[project-id]/[repo_name]/[image_name]:v1

我的映像檔名字就像這樣：

asia-east1-docker.pkg.dev/dong-dong-gcp-2-bigquery/nodejs-1/nodejs-web:v1

準備好之後，就執行以下指令：

docker build -t [位置]/[project-id]/[repo_name]/[image_name]:v1

我的範例指令：

docker build -t asia-east1-docker.pkg.dev/dong-dong-gcp-2-bigquery/nodejs-1/nodejs-web:v1 .

你注意指令最後有一個句點，代表要把當前資料夾 (nodejs01) 內的檔案都打包進這個映像檔。

建立容器映像檔

測試 Docker Image 運作

我們再直接使用 Image 跑一次容器，確認應用程式正常

docker run -d -p [port]:[port] [位置]/[project-id]/[repo_name]/[image_name]:v1

我的範例指令：

docker run -d -p 8080:8080 asia-east1-docker.pkg.dev/dong-dong-gcp-2-bigquery/nodejs-1/nodejs-web:v1

參數 -d ，指的是背景執行

參數 -p 8080:8080 ，指的是把主機的 8080 Port 所有流量轉發到 web 這個Container 的 8080 Port

確認容器已開始運作

然後我們點擊 Cloud Shell 視窗右上角的預覽按鈕，可以看到網頁已經正常顯示：

確認能看到網頁

停止 Docker 應用程式

確認無誤的話，我們要停止 Container 運作之前，要先查詢目前正在運作 Container 的 ID：

docker ps

取得 ID 之後，停止指定的 Container

docker stop [container-id]

停止容器運作

推送 Docker Image 到 Artifact Registry

現在就可以正式 Push Docker Image 到 Artifact Registry 了，執行以下指令：

docker push [位置]/[project-id]/[repo_name]/[image_name]:v1

我的範例指令：

docker push asia-east1-docker.pkg.dev/dong-dong-gcp-2-bigquery/nodejs-1/nodejs-web:v1

映像檔推送完成

我們看到映像檔已經推上去了，我們可以回到 Console 上按重新整理：

在 Artifact Registry 上看到映像檔出現了

現在我們有一個映像檔在上面，之後就可以部署到 Cloud Run 或 Google Kubernetes Engine 囉！

影片版教學：

The post 儲存容器映像檔的 Artifact Registry 簡介與上傳 Docker 映像檔教學 first appeared on 東東 GCP 教學 - GCP 實戰講師.

[Cloud Run 教學] 如何收集在 Cloud Run 上運作的 Nginx Log？寫入 Cloud Logging

東東 — Mon, 17 Jun 2024 13:20:12 +0000

Cloud Run 是無狀態的，

代表它的容器重啟之後，

容器裡面的 Log 全部消失不見，徹底的無狀態。

那我們如果想要除錯，只能看到 Cloud Run 本身的 Log，

怕資訊不足，怎麼辦？

你又不能直接連進去 Container，

因為它又是「無伺服器」的，根本不能連到它 Command Line。

怎麼辦呢？

其實它是可以設定輸出 Log 的位置的，

這裡做一個簡單的範例給大家參考～

我先在 Cloud Shel l 開一個目錄

mkdir nginx

cd nginx

mkdir write-to-logging

cd write-to-logging

在資料夾裡建立3個檔案，各位直接複製貼上就好了：

第一個 index.html 首頁檔案

vim index.html




    Welcome to Nginx!


    Success! Dongdong Nginx server is running!

截圖

第二個是 Nginx 的設定檔

vim nginx.conf

重點是設定 Nginx 把日志寫到 stdout 和 stderr，

然後讓 Cloud Run 自動收集這些 Log 並傳送到 Cloud Logging。

worker_processes  1;

events {
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    keepalive_timeout  65;

    access_log /dev/stdout;
    error_log /dev/stderr;

    server {
        listen       8080;
        server_name  localhost;

        location / {
            root   /usr/share/nginx/html;
            index  index.html index.htm;
        }

        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   /usr/share/nginx/html;
        }
    }
}

截圖

第三個是 Dockerfile

vim Dockerfile

# Use the official Nginx image from the Docker Hub
FROM nginx:latest

# Copy the Nginx configuration file
COPY nginx.conf /etc/nginx/nginx.conf

# Copy the index.html file to the default Nginx directory
COPY index.html /usr/share/nginx/html/index.html

# Expose the port that Cloud Run will use
EXPOSE 8080

# Start Nginx when the container launches
CMD ["nginx", "-g", "daemon off;"]

我在自己專案的 Artifact Registry 建立 Repository 為 nginx

然後在 Cloud Shel l 建立 Docker Image 名字叫 write-to-logging

(dong-dong-gcp-3 請改成你的專案 ID 喔)

(注意下面指令有一個句號喔)

docker build -t asia-east1-docker.pkg.dev/dong-dong-gcp-3/nginx/write-to-logging .

接下來就把 Image Push 到 Artifact Registry

docker push asia-east1-docker.pkg.dev/dong-dong-gcp-3/nginx/write-to-logging

接下來就看到 nginx 這個 repo 有一個新的 Image

如果都沒問題的話，就可以部署到 Cloud Run，

如果懶得在 Console 上點，可以直接複製下面的指令 (記得改掉 Project ID 喔 )：

gcloud run deploy nginx-logging \
–image asia-east1-docker.pkg.dev/dong-dong-gcp-3/nginx/write-to-logging \
–platform managed \
–region asia-east1 \
–allow-unauthenticated

其實我本來就部署成功了，

但我再輸入部署指令時，它不會報錯，

只會幫我增加最新的版本，蠻貼心的。

接下來看一下 Cloud Run 的 Console：

那個 nginx-logging 就是我剛部署的服務，點 “nginx-logging” 看看

再點開它的超連結

會看到

代表部署成功了！

那要怎麼證明，它的 Log 有寫入 Cloud Logging 呢？

我們先故意在網址列尾巴增加 “?” 和其他英文數字

然後按 Enter，它顯示畫面是不變的，

但是這個網址會記錄到 Nginx 的 Log 裡面。

你可以點開它的 Log 查看

你會在左邊的 Log 欄位看到有 stdout 和 stderr 的選項，點擊篩選：

就可以看到 Nginx Container 寫到 Cloud Logging 的 Log 了！

現在看到是長這樣，這些都是 Cloud Run 本身沒有記錄的 Log 喔！

如果把篩選器移除，才會同時看到 Cloud Run 和 Nginx 本身收集到的 Log：

今天就簡單分享到這裡，謝謝大家！

The post [Cloud Run 教學] 如何收集在 Cloud Run 上運作的 Nginx Log？寫入 Cloud Logging first appeared on 東東 GCP 教學 - GCP 實戰講師.