本頁說明如何設定專用的記憶體內磁碟區，以便使用 Cloud Run 磁碟區掛接功能讀取及寫入檔案。請注意，這項功能與 Cloud Run 提供的內建記憶體內檔案系統不同。
在 Cloud Run 中掛接記憶體內磁碟區時，記憶體內磁碟區會顯示為容器檔案系統中的檔案。掛接記憶體內磁碟區後，您可以使用程式設計語言的檔案系統作業和程式庫，存取該磁碟區，就像存取本機檔案系統中的目錄一樣。
您可以使用記憶體內磁碟區執行下列操作：
- 限制記憶體內磁碟區的大小。限制磁碟區大小後，寫入已滿磁碟區的作業會失敗，這比 Cloud Run 因磁碟區耗用過多記憶體而終止執行個體要好。
- 在一個 Cloud Run 執行個體中，於不同容器之間共用記憶體內磁碟區。當 Cloud Run 擴大為多個工作站集區執行個體時，每個工作站集區都會有自己的記憶體內磁碟區，並由該工作站集區上的所有容器共用。當 Cloud Run 擴充資源來處理流量時，所有容器都能使用這個磁碟區。
行為
建立記憶體內磁碟區時，建議您指定大小限制。如果磁碟區達到大小上限，後續寫入作業就會因記憶體不足而失敗。您的執行個體可以處理這項錯誤，並繼續執行。
請注意，大小限制只是限制，不會為記憶體內磁碟區分配額外空間。而是會耗用您為容器設定的記憶體。如果部署多個容器，每次寫入磁碟區的資料都會耗用記憶體，並計入寫入資料的容器記憶體用量。
如未指定大小限制，系統會自動設為工作或服務中所有容器總大小的一半。舉例來說，磁碟區大小 = [記憶體 (容器 A) + 記憶體 (容器 B) + 記憶體 (容器 N)]/2。emptyDir這項預設行為可能會導致記憶體內磁碟區的大小上限，高於為部分容器分配的記憶體。即使尚未達到磁碟區大小上限，如果單一容器在嘗試將更多資料寫入磁碟區時，超過自身分配到的記憶體，就可能導致非預期的當機。
雖然設定大小限制是選用功能，但建議您設定限制，以免容器記憶體不足而當機。
不允許的路徑
Cloud Run 不允許您在 /dev、/proc 和 /sys 或其子目錄中掛接磁碟區。
必要的角色
如需與 Cloud Run 相關聯的 IAM 角色和權限清單，請參閱 Cloud Run IAM 角色和 Cloud Run IAM 權限。如果 Cloud Run 工作站集區與Google Cloud API (例如 Cloud 用戶端程式庫) 介接，請參閱服務身分設定指南。如要進一步瞭解如何授予角色，請參閱部署權限和管理存取權。
設定記憶體內磁碟區
變更任何設定都會建立新的修訂版本。除非您明確做出更新，變更這項設定，否則後續的修訂版本也會自動取得這個設定。
為 Cloud Run 服務設定記憶體內磁碟區後，系統會為啟動的每個 Cloud Run 執行個體建立空白磁碟區，且只要該執行個體正在執行，磁碟區就會存在。執行個體停止執行後，磁碟區中的資料就會永久刪除。
當您建立新的 worker 集區或部署新的修訂版本時，可以使用 Google Cloud CLI 設定記憶體內磁碟區掛接。
gcloud
如要新增磁碟區並掛接，請按照下列步驟操作：
gcloud beta run worker-pools update WORKER_POOL \ --add-volume=name=VOLUME_NAME,type=in-memory,size-limit=SIZE_LIMIT \ --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH
取代：
- WORKER_POOL 改為您的工作站集區名稱。
- VOLUME_NAME 改成您要的磁碟區名稱。VOLUME_NAME 值用於將磁碟區對應至磁碟區掛接點。
- MOUNT_PATH，例如
/mnt/my-volume。 - SIZE_LIMIT，並以 MiB 或 GiB (指定為 Mi 或 Gi) 為單位，設定要指派給磁碟區的記憶體上限，例如
500Mi。這個上限必須低於為容器指定的記憶體總量。
如果您使用多個容器，請先指定磁碟區，然後為每個容器指定磁碟區掛接點：
gcloud beta run worker-pools update WORKER_POOL \ --add-volume=name=VOLUME_NAME,type=in-memory,size-limit=SIZE_LIMIT \ --container=CONTAINER_1 \ --add-volume-mount=volume=VOLUME_NAME,mount-path=MOUNT_PATH \ --container=CONTAINER_2 \ --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH2
查看工作站集區的環境變數設定
前往 Google Cloud 控制台的 Cloud Run：
按一下「工作站集區」，即可顯示已部署的工作站集區清單。
按一下要檢查的 worker 集區，顯示詳細資料窗格。
按一下「Containers」(容器) 分頁標籤，即可顯示工作站集區容器設定。
讀取及寫入磁碟區
如果您使用 Cloud Run 磁碟區掛接功能，可以透過程式設計語言中用來讀取及寫入本機檔案系統的相同程式庫，存取已掛接的磁碟區。
如果您使用現有容器，且該容器預期資料會儲存在本機檔案系統，並使用一般檔案系統作業存取資料，這個方法就特別實用。
下列程式碼片段假設磁碟區掛接點的 mountPath 已設為 /mnt/my-volume。
NodeJS
使用檔案系統模組，在磁碟區中建立新檔案或附加至現有檔案，/mnt/my-volume：
var fs = require('fs');
fs.appendFileSync('/mnt/my-volume/sample-logfile.txt', 'Hello logs!', { flag: 'a+' });Python
寫入磁碟區中保留的檔案 /mnt/my-volume：
f = open("/mnt/my-volume/sample-logfile.txt", "a")Go
使用 os 套件建立新檔案，並保留在磁碟區中：/mnt/my-volume
f, err := os.Create("/mnt/my-volume/sample-logfile.txt")Java
使用 Java.io.File 類別在磁碟區中建立記錄檔 /mnt/my-volume：
import java.io.File;
File f = new File("/mnt/my-volume/sample-logfile.txt");清除及移除磁碟區和磁碟區掛接
您可以清除所有磁碟區和掛接點，也可以移除個別磁碟區和磁碟區掛接點。
清除所有磁碟區和磁碟區掛接點
如要從單一容器工作站集區清除所有磁碟區和磁碟區掛接點，請執行下列指令：
gcloud beta run worker-pools update WORKER_POOL \ --clear-volumes --clear-volume-mounts
如果您有多個容器，請按照 Sidecar CLI 慣例清除磁碟區和磁碟區掛接：
gcloud beta run worker-pools update WORKER_POOL \ --container=container1 \ --clear-volumes -–clear-volume-mounts \ --container=container2 \ --clear-volumes \ -–clear-volume-mounts
移除個別磁碟區和磁碟區掛接點
如要移除磁碟區，也必須移除使用該磁碟區的所有磁碟區掛接。
如要移除個別磁碟區或磁碟區掛接，請使用 remove-volume 和 remove-volume-mount 標記：
gcloud beta run worker-pools update WORKER_POOL \ --remove-volume VOLUME_NAME \ --container=container1 \ --remove-volume-mount MOUNT_PATH \ --container=container2 \ --remove-volume-mount MOUNT_PATH