Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

인스턴스의 인메모리 볼륨 마운트 구성

이 페이지에서는 Cloud Run 볼륨 마운트를 사용하여 파일 읽기 및 쓰기에 사용할 수 있는 전용 인메모리 볼륨을 구성하는 방법을 설명합니다. 이 기능은 Cloud Run에서 제공하는 기본 인메모리 파일 시스템과 다릅니다.

Cloud Run에서 인메모리 볼륨을 마운트하면 인메모리 볼륨이 컨테이너 파일 시스템에 파일로 표시됩니다. 인메모리 볼륨을 마운트한 후에는, 프로그래밍 언어의 파일 시스템 작업 및 라이브러리를 사용하여 로컬 파일 시스템의 디렉터리처럼 파일 공유에 액세스할 수 있습니다.

인메모리 볼륨을 사용하여 다음을 수행할 수 있습니다.

인메모리 볼륨 크기 제한. 볼륨 크기를 제한하면 전체 볼륨에 대한 쓰기가 실패하게 되는데, 이는 볼륨이 너무 많은 메모리를 사용하는 탓에 Cloud Run이 인스턴스를 종료하는 것보다 바람직합니다.

행동

인메모리 볼륨을 만들 때는 크기 한도를 지정하는 것이 좋습니다. 볼륨 크기가 크기 한도에 도달하면 추가 쓰기는 메모리 부족 오류로 인해 실패합니다. 인스턴스는 이 오류를 처리하고 계속 실행할 수 있습니다.

참고로 크기 제한은 한도 설정일 뿐이며, 인메모리 볼륨에 추가 공간을 할당하지는 않습니다. 대신 인메모리 볼륨은 컨테이너에 구성된 메모리를 사용합니다. 컨테이너를 여러 개 배포하는 경우 볼륨에 쓸 때마다 사용되는 메모리는 데이터를 작성한 컨테이너의 메모리 사용량으로 계산됩니다.

크기 한도를 지정하지 않으면 인스턴스의 모든 컨테이너 총 크기의 절반으로 자동 설정됩니다. 예를 들어 emptyDir 볼륨 크기는 [메모리 (컨테이너 A) + 메모리 (컨테이너 B) + 메모리 (컨테이너 N)]/2입니다. 이러한 기본 동작으로 인해 인메모리 볼륨의 크기 한도가 일부 컨테이너에 할당된 메모리보다 높을 수 있습니다. 볼륨 크기 한도에 도달하지 않았더라도 단일 컨테이너가 볼륨에 더 많은 데이터를 쓰려고 하는 동안 자체 할당된 메모리를 초과하면 예기치 않은 비정상 종료가 발생할 수 있습니다.

크기 한도는 선택사항이지만 컨테이너가 메모리 부족 및 비정상 종료로부터 보호되도록 크기 한도를 설정하는 것이 좋습니다.

허용되지 않는 경로

Cloud Run에서는 볼륨을 /dev, /proc, /sys 또는 해당 하위 디렉터리에 마운트할 수 없습니다.

필요한 역할

Cloud Run과 연결된 IAM 역할 및 권한 목록은 다음 항목을 참조하세요. Cloud Run IAM 역할 및 Cloud Run IAM 권한 Cloud Run 인스턴스가 Google Cloud Cloud 클라이언트 라이브러리와 같은 API와 상호작용하는 경우에는 서비스 ID 구성 가이드를 참조하세요. 역할 부여에 대한 자세한 내용은 배포 권한 및 액세스 관리를 참조하세요.

인메모리 볼륨 구성

Cloud Run 인스턴스에 인메모리 볼륨을 구성하면 시작되는 모든 Cloud Run 인스턴스에 빈 볼륨이 생성되고 해당 인스턴스가 실행되는 동안 볼륨이 존재합니다. 인스턴스 실행이 중지되면 볼륨의 데이터가 영구 삭제됩니다.

Google Cloud CLI 또는 YAML을 사용하여 인메모리 볼륨 마운트를 구성합니다.

gcloud

볼륨을 마운트하려면 다음 단계를 따르세요.
```
gcloud beta run instances update INSTANCE \
  --add-volume mount-path=MOUNT_PATH,type=in-memory,size-limit=SIZE_LIMIT
```
다음을 바꿉니다.
- INSTANCE: 인스턴스의 이름.
- MOUNT_PATH: 볼륨을 마운트할 컨테이너 파일 시스템 내 상대 경로(예: /mnt/my-volume)
- SIZE_LIMIT: 볼륨에 할당하려는 메모리 한도(MiB 또는 GiB 단위. Mi 또는 Gi 단위로 지정)(예: 500Mi). 이 한도는 컨테이너에 지정된 총 메모리보다 작아야 합니다.

여러 컨테이너를 사용하는 경우 먼저 볼륨을 지정한 후 볼륨 마운트를 각 컨테이너에 지정합니다.

gcloud beta run instances update INSTANCE \
  --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

YAML

새 인스턴스를 만드는 경우 이 단계를 건너뜁니다. 기존 인스턴스를 업데이트하는 경우 YAML 구성을 다운로드합니다.
```
gcloud beta run instances describe INSTANCE --format export > instance.yaml
```
다음 예시에는 YAML 구성이 포함되어 있습니다.
```
apiVersion: run.googleapis.com/v1
kind: Instance
metadata:
  name: INSTANCE
  annotations:
    run.googleapis.com/launch-stage: BETA
spec:
    containers:
      - name: CONTAINER_NAME
        image: IMAGE_URL
        volumeMounts:
        - name: VOLUME_NAME
          mountPath: MOUNT_PATH
      volumes:
      - name: VOLUME_NAME
        emptyDir:
          medium: Memory
          sizeLimit: SIZE_LIMIT
```
다음을 바꿉니다.
- INSTANCE: Cloud Run 인스턴스의 이름.
- CONTAINER_NAME: 컨테이너의 이름.
- IMAGE_URL: 컨테이너 이미지에 대한 참조(예: us-docker.pkg.dev/cloudrun/container/hello:latest)
- VOLUME_NAME: 볼륨에 사용할 이름 VOLUME_NAME 값은 볼륨을 볼륨 마운트에 매핑하는 데 사용됩니다.
- MOUNT_PATH: 볼륨을 마운트할 상대 경로(예: /mnt/my-volume).
- SIZE_LIMIT: 볼륨에 할당하려는 메모리 한도(MiB 또는 GiB 단위. Mi 또는 Gi 단위로 지정)(예: 500Mi). 이 한도 는 컨테이너에 지정된 총 메모리 보다 작아야 합니다.
다음 명령어를 사용하여 인스턴스를 만들거나 업데이트합니다.
```
gcloud beta run instances replace instance.yaml
```

볼륨에 읽기 및 쓰기

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 instances update INSTANCE \
    --clear-volumes \
    --clear-volume-mounts

개별 볼륨 및 볼륨 마운트 삭제

볼륨을 삭제하려면 해당 볼륨을 사용하는 모든 볼륨 마운트도 삭제해야 합니다.

개별 볼륨이나 볼륨 마운트를 삭제하려면 remove-volume 및 remove-volume-mount 플래그를 사용합니다.

gcloud beta run instances update INSTANCE \
    --remove-volume VOLUME_NAME \
    --container=container1 \
    --remove-volume-mount MOUNT_PATH \
    --container=container2 \
    --remove-volume-mount MOUNT_PATH