gcloud CLI를 사용하여 Filestore 인스턴스 만들기

이 빠른 시작에서는 Google Cloud CLI를 사용하여 Filestore를 빠르게 시작하고 실행하는 방법을 보여줍니다. 이 빠른 시작에서 설명하는 사항은 다음과 같습니다.

Filestore 인스턴스를 만듭니다.
해당 인스턴스의 파일 공유를 Compute Engine 클라이언트 VM에 마운트합니다.
마운트된 파일 공유에서 파일을 만듭니다.
Filestore 인스턴스를 삭제합니다.

시작하기 전에

Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

Google Cloud CLI를 설치합니다.

외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

gcloud CLI를 초기화하려면, 다음 명령어를 실행합니다.

gcloud init

Google Cloud 프로젝트를 만들거나 선택합니다.

프로젝트를 선택하거나 만드는 데 필요한 역할

프로젝트 선택: 프로젝트를 선택하는 데는 특정 IAM 역할이 필요하지 않습니다. 역할이 부여된 프로젝트를 선택하면 됩니다.
프로젝트 만들기: 프로젝트를 만들려면 resourcemanager.projects.create 권한이 포함된 프로젝트 생성자 역할(roles/resourcemanager.projectCreator)이 필요합니다. 역할 부여 방법 알아보기

Google Cloud 프로젝트를 만듭니다.
```
gcloud projects create PROJECT_ID
```
PROJECT_ID를 만들려는 Google Cloud 프로젝트의 이름으로 바꿉니다.
생성한 Google Cloud 프로젝트를 선택합니다.
```
gcloud config set project PROJECT_ID
```
PROJECT_ID을 Google Cloud 프로젝트 이름으로 바꿉니다.

이 가이드에 기존 프로젝트를 사용하는 경우 이 가이드를 완료하는 데 필요한 권한이 있는지 확인합니다. 새 프로젝트를 만든 경우에는 이미 필요한 권한이 있습니다.

Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

Filestore API를 사용 설정합니다.

API 사용 설정에 필요한 역할

API를 사용 설정하려면 serviceusage.services.enable 권한이 포함된 서비스 사용량 관리자 IAM 역할 (roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기

gcloud services enable file.googleapis.com

Google Cloud CLI를 설치합니다.

외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

gcloud CLI를 초기화하려면, 다음 명령어를 실행합니다.

gcloud init

Google Cloud 프로젝트를 만들거나 선택합니다.

프로젝트를 선택하거나 만드는 데 필요한 역할

프로젝트 선택: 프로젝트를 선택하는 데는 특정 IAM 역할이 필요하지 않습니다. 역할이 부여된 프로젝트를 선택하면 됩니다.
프로젝트 만들기: 프로젝트를 만들려면 resourcemanager.projects.create 권한이 포함된 프로젝트 생성자 역할(roles/resourcemanager.projectCreator)이 필요합니다. 역할 부여 방법 알아보기

Google Cloud 프로젝트를 만듭니다.
```
gcloud projects create PROJECT_ID
```
PROJECT_ID를 만들려는 Google Cloud 프로젝트의 이름으로 바꿉니다.
생성한 Google Cloud 프로젝트를 선택합니다.
```
gcloud config set project PROJECT_ID
```
PROJECT_ID을 Google Cloud 프로젝트 이름으로 바꿉니다.

Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

Filestore API를 사용 설정합니다.

API 사용 설정에 필요한 역할

gcloud services enable file.googleapis.com

필요한 역할

빠른 시작을 완료하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

Filestore 인스턴스 만들기 및 관리: Cloud Filestore 편집자 (roles/file.editor)
Compute Engine 인스턴스 만들기 및 관리: Compute 인스턴스 관리자 (v1) (roles/compute.instanceAdmin.v1)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

이 문서에 설명된 태스크를 완료했으면 만든 리소스를 삭제하여 청구가 계속되는 것을 방지할 수 있습니다. 자세한 내용은 삭제를 참조하세요.

Compute Engine VM 만들기

Linux

Compute Engine 인스턴스를 생성합니다. 다음과 같이 인스턴스를 구성합니다.
- 인스턴스 이름을 nfs-client로 지정합니다.
- --zone 플래그를 us-central1-c로 설정합니다.
- --image-project 플래그를 debian-cloud로 설정합니다.
- --image-family 플래그를 debian-11로 설정합니다.
- --tags 플래그를 http-server로 설정합니다.
```
gcloud compute instances create nfs-client --zone=us-central1-c --image-project=debian-cloud --image-family=debian-11 --tags=http-server
```

Windows

Compute Engine 인스턴스를 생성합니다. 다음과 같이 인스턴스를 구성합니다.
- 인스턴스 이름을 nfs-client로 지정합니다.
- --zone 플래그를 us-central1-c로 설정합니다.
- --image-project 플래그를 windows-cloud로 설정합니다.
- --image-family 플래그를 windows-2012-r2로 설정합니다.
- --tags 플래그를 http-server로 설정합니다.
```
gcloud compute instances create nfs-client --zone=us-central1-c --image-project=windows-cloud --image-family=windows-2012-r2 --tags=http-server
```

Filestore 인스턴스 만들기

이 빠른 시작에서는 맞춤 성능이 사용 설정된 리전 서비스 등급에서 인스턴스를 만드는 방법을 보여줍니다. 인스턴스 만들기에 대한 자세한 내용은 인스턴스 만들기를 참고하세요.

Filestore 인스턴스를 만듭니다. 다음과 같이 인스턴스를 구성합니다.
- 인스턴스 이름을 nfs-server로 지정합니다.
- --region 플래그를 us-central1로 설정합니다.
- --tier 플래그를 REGIONAL로 설정합니다.
- --performance 플래그를 max-iops-per-tb=17000로 설정합니다.
  
  참고: 인스턴스에 맞춤 성능을 활성화한 후에는 해당 인스턴스에 맞춤 성능을 비활성화할 수 없습니다. 맞춤 성능이 활성화된 인스턴스는 구매한 IOPS에 따라 요금이 청구됩니다. 자세한 내용은 맞춤 성능 구성 및 Filestore 가격 책정을 참고하세요.
- --file-share 플래그를 name="vol1",capacity=1TB로 설정합니다.
- --network 플래그를 name="default"로 설정합니다.
```
gcloud filestore instances create nfs-server --region=us-central1 --tier=REGIONAL --performance=max-iops-per-tb=17000 --file-share=name="vol1",capacity=1TB --network=name="default"
```

만든 Filestore 인스턴스에 대한 정보를 가져옵니다.

  gcloud filestore instances describe nfs-server --region=us-central1

이 명령어는 다음과 비슷한 결과를 반환합니다.

    createTime: '2025-02-12T09:15:08.163246004Z'
    customPerformanceSupported: true
    fileShares:
     -capacityGb: '1024'
        name: vol1
    name: projects/yourproject/locations/us-central1/instances/nfs-server
    networks:
    -connectMode: DIRECT_PEERING
      ipAddresses:
       - 10.0.0.2
      network: default
      reservedIpRange: 10.0.0.2/26
    performanceConfig:
      iopsPerTb:
        maxIopsPerTb: '17000'
    performanceLimits:
      maxIops: '17000'
      maxReadIops: '17000'
      maxReadThroughputBps: '417792000'
      maxWriteIops: '5100'
      maxWriteThroughputBps: '139264000'
    protocol: NFS_V3
    state: READY
    tier: REGIONAL

파일 공유를 마운트할 때 사용하기 위해 인스턴스의 IP 주소를 복사합니다. 이 빠른 시작에서는 IP 주소 10.0.0.2가 사용됩니다.

Filestore 파일 공유를 `nfs-client` 인스턴스에 마운트

Linux

인스턴스에 SSH 연결을 설정합니다.nfs-client
```
gcloud compute ssh nfs-client
```

nfs-client의 터미널 창에서 다음 명령어를 실행하여 NFS를 설치합니다.
```
sudo apt-get -y update &&
sudo apt-get -y install nfs-common
```
Filestore 파일 공유에 대해 nfs-client 인스턴스에 마운트 디렉터리를 만듭니다.
```
sudo mkdir /mnt/test
```
Filestore 인스턴스의 IP 주소, 파일 공유 이름, 마운트할 마운트 디렉터리를 지정하여 mount 명령어로 nfs-client 인스턴스에 파일 공유를 마운트합니다.
```
sudo mount MOUNT-POINT-DIRECTORY /mnt/test
```
각 항목의 의미는 다음과 같습니다.

MOUNT-POINT-DIRECTORY는 Filestore 파일 공유가 마운트된 디렉터리의 경로입니다. 예를 들면 10.0.0.2:/vol1입니다.

참고: NFS 마운트 옵션 권장사항은 파일 공유 마운트를 참고하세요.
선택사항: Filestore 파일 공유가 마운트되었는지 확인합니다.

df -h --type=nfs
파일 공유 액세스가 가능하도록 권한을 변경합니다.
```
sudo chmod go+rw /mnt/test
```

Windows

`nfs-client` 인스턴스에 로그인하고 관리자로 명령 프롬프트를 엽니다.

계정을 만들고 nfs-client 인스턴스에 대해 초기 비밀번호를 설정합니다.
```
gcloud compute reset-windows-password nfs-client
```

직렬 포트에 연결할 수 있도록 인스턴스를 구성합니다.

gcloud compute instances add-metadata nfs-client --metadata=serial-port-enable=1

대화형 세션을 입력합니다.

gcloud compute connect-to-serial-port nfs-client --port=2

SAC> 프롬프트에서 새 채널을 만듭니다.
```
cmd
```
이름이 Cmd0001인 채널이 생성됩니다.
채널에 연결합니다.
```
ch -sn Cmd0001
```
nfs-client 인스턴스의 사용자 이름과 비밀번호를 입력하고 Domain 필드를 비워 둡니다. nfs-client 인스턴스의 Command Prompt 인터페이스에 연결됩니다.

NFS 클라이언트 설치

nfs-client의 Command Prompt에서 Windows PowerShell로 전환합니다.
```
powershell
```

NFS 클라이언트를 설치합니다.

Install-WindowsFeature -Name NFS-Client

메시지가 표시되면 nfs-client 인스턴스를 다시 시작합니다.
```
restart-computer
```
SAC> 프롬프트에서 다음 알림이 표시될 때까지 기다립니다.
```
EVENT: The CMD command is now available.
```
그런 후 이전 안내에 따라 cmd 및 ch -sn 명령어를 실행하여 로그인하고 nfs-client 인스턴스에 다시 연결합니다.

NFS 클라이언트에 사용되는 사용자 ID 구성

명령 프롬프트에서 powershell을 실행하여 Windows PowerShell로 전환합니다.

PowerShell에서 다음 명령어를 실행하여 2개의 새 레지스트리 항목 AnonymousUid 및 AnonymousGid를 만듭니다.

New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" `
    -Name "AnonymousUid" -Value "0" -PropertyType DWORD

New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" `
    -Name "AnonymousGid" -Value "0" -PropertyType DWORD

NFS 클라이언트 서비스를 다시 시작합니다.
```
nfsadmin client stop

nfsadmin client start
```

`vol1` 파일 공유를 `nfs-client` 인스턴스에 매핑

PowerShell을 종료합니다.
```
exit
```
Command Prompt에서 Filestore 인스턴스의 IP 주소, 파일 공유 이름, 마운트할 드라이브 문자를 지정하여 mount 명령어로 nfs-client 인스턴스에 파일 공유를 마운트합니다.
```
mount -o mtype=hard 10.0.0.2:/vol1 z:
```

마운트된 파일 공유에서 파일 만들기

Linux

nfs-client 터미널 창에서 다음 명령어를 실행하여 이름이 testfile인 파일을 만듭니다.
```
echo 'This is a test' > /mnt/test/testfile
```
다음 명령어를 실행하고 testfile이 반환된 디렉터리 콘텐츠에 있는지 확인하여 파일이 생성되었는지 확인합니다.
```
ls /mnt/test
```

Windows

nfs-client 인스턴스의 명령 프롬프트 창에서 이름이 testfile인 파일을 만듭니다.
```
echo 'This is a test' > Z:\testfile
```
다음 명령어를 실행하여 파일이 생성되었는지 확인합니다.
```
dir Z:
```
그리고 testfile이 반환된 디렉터리 콘텐츠에 있는지 확인합니다.

삭제

이 페이지에서 사용한 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 리소스가 포함된 Google Cloud 프로젝트를 삭제하세요.

Google Cloud 프로젝트 삭제

주의: 프로젝트를 삭제하면 다음과 같은 결과가 발생합니다.

프로젝트의 모든 항목이 삭제됩니다. 이 문서의 태스크에 기존 프로젝트를 사용한 경우 프로젝트를 삭제하면 프로젝트에서 수행한 다른 작업도 삭제됩니다.
커스텀 프로젝트 ID가 손실됩니다. 이 프로젝트를 만들 때 앞으로 사용할 커스텀 프로젝트 ID를 만들었을 수 있습니다. appspot.com URL과 같이 프로젝트 ID를 사용하는 URL을 보존하려면 전체 프로젝트를 삭제하는 대신 프로젝트 내에서 선택한 리소스만 삭제합니다.

여러 아키텍처, 튜토리얼 또는 빠른 시작을 살펴보려는 경우 프로젝트를 재사용하면 프로젝트 할당량 한도 초과를 방지할 수 있습니다.

Google Cloud 프로젝트를 삭제합니다.

gcloud projects delete PROJECT_ID

Filestore 인스턴스 삭제

nfs-server 인스턴스를 삭제합니다.

gcloud filestore instances delete nfs-server --zone=us-central1-c

Compute Engine 인스턴스 삭제

인스턴스를 삭제합니다.

gcloud compute instances delete nfs-client

다음 단계

Filestore 개요를 읽고 Filestore의 기본 사항에 대해 자세히 알아봅니다.
인스턴스 만들기의 안내에 따라 직접 Filestore 인스턴스를 설정합니다.
액세스 제어를 읽어 Filestore 작업 및 인스턴스의 리소스에 대한 액세스를 제어하는 방법을 알아봅니다.
Filestore 인스턴스로 또는 Filestore 인스턴스에서 데이터를 복사하는 방법을 알아보세요.
Cloud Storage에서 Filestore로 대규모 데이터 세트를 전송하는 방법을 알아보세요.

gcloud CLI를 사용하여 Filestore 인스턴스 만들기

시작하기 전에

필요한 역할

Compute Engine VM 만들기

Linux

Windows

Filestore 인스턴스 만들기

Filestore 파일 공유를 nfs-client 인스턴스에 마운트

Linux

Windows

nfs-client 인스턴스에 로그인하고 관리자로 명령 프롬프트를 엽니다.

NFS 클라이언트 설치

NFS 클라이언트에 사용되는 사용자 ID 구성

vol1 파일 공유를 nfs-client 인스턴스에 매핑

마운트된 파일 공유에서 파일 만들기

Linux

Windows

삭제

Google Cloud 프로젝트 삭제

Filestore 인스턴스 삭제

Compute Engine 인스턴스 삭제

다음 단계

Filestore 파일 공유를 `nfs-client` 인스턴스에 마운트

`nfs-client` 인스턴스에 로그인하고 관리자로 명령 프롬프트를 엽니다.

`vol1` 파일 공유를 `nfs-client` 인스턴스에 매핑