베어메탈 솔루션 환경 유지보수

베어메탈 솔루션 환경이 준비되고 실행되면 이 가이드에 포함된 정보를 통해 베어메탈 솔루션 서버, 스토리지, 네트워킹을 유지관리합니다.

베어메탈 솔루션 환경에서 SAP HANA를 실행하는 경우 베어메탈 솔루션용 SAP HANA 계획 가이드를 참조하세요.

베어메탈 솔루션 API를 사용하도록 Google Cloud 프로젝트 설정

베어메탈 솔루션 API는 베어메탈 솔루션 환경을 모니터링 및 유지보수할 수 있는 여러 도구를 제공합니다. 일반적으로 이러한 절차는 베어메탈 솔루션 API를 처음 사용할 때만 필요합니다. 하지만 API가 예상한 대로 응답하지 않는 등의 문제 해결 목적에 따라 이 안내를 다시 따를 수 있습니다.

베어메탈 솔루션 관리자 또는 베어메탈 솔루션 편집자 사전 정의된 IAM 역할을 주 구성원에 할당합니다. IAM 역할을 매핑하는 방법을 알아보려면 IAM 역할 부여를 참조하세요.
Cloud 프로젝트에서 베어메탈 솔루션 API를 사용 설정합니다.

참고: API 서비스를 사용 설정하려면 소유자 또는 서비스 사용량 관리자 등, 서비스를 활성화하는 권한을 부여하는 IAM 역할이 있어야 합니다. 자세한 내용은 액세스 제어를 참조하세요.
콘솔
1. Google Cloud 콘솔 대시보드에서 베어메탈 솔루션 API로 이동합니다. 또한 API 라이브러리(API 및 서비스 > 라이브러리)에서 베어메탈 솔루션 API를 검색할 수도 있습니다.
2. 베어메탈 솔루션 API 페이지에서 사용 설정을 클릭합니다.
3. 브라우저에서 뒤로 버튼을 클릭합니다. API 사용 설정됨 단어 옆에 녹색 체크표시가 표시되면 API를 사용할 수 있습니다.
gcloud
- gcloud를 통해 베어메탈 솔루션 API를 사용 설정하려면 다음 명령어에 gcloud CLI 프로젝트 ID를 입력하고, 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고, Enter 또는 Return 키를 누릅니다.
```
 gcloud services enable baremetalsolution.googleapis.com --project=PROJECT_ID
 
```
Google Cloud CLI가 Cloud 프로젝트에서 작동하도록 허용합니다.
1. Cloud Shell 창에서 gcloud auth login 명령어를 입력합니다.
```
gcloud auth login
```
2. 생성된 URL을 복사하여 별도의 브라우저 탭 또는 창에 붙여넣습니다.
3. Cloud 프로젝트와 연결된 사용자 이름을 사용하여 페이지에 로그인합니다.
4. 허용을 클릭하여 gcloud CLI를 사용 설정합니다.
5. 승인 코드를 복사합니다.
6. 코드를 Cloud Shell 클라이언트 명령줄에 붙여넣습니다.
7. Enter 또는 Return 키를 누릅니다.

Google Cloud에서 API를 설정하는 데 필요한 일반적인 단계에 대한 자세한 내용은 Google Cloud API 시작하기를 참조하세요.

베어메탈 솔루션 서버 운영

베어메탈 솔루션 서버에서 다음 작업을 수행할 수 있습니다.

시작: 서버의 전원을 켭니다.
중지: 서버의 전원을 끕니다.
재설정: 서버를 다시 시작합니다.

콘솔

서버에서 이 작업을 수행하려면 다음 단계를 따르세요.

Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
시작, 중지, 재설정하려는 서버에서 를 클릭합니다.
다음 단계를 따르세요.
- 서버 전원을 켜려면 전원을 클릭합니다.
- 서버 전원을 끄려면 중지를 클릭합니다.
- 서버를 다시 시작하려면 재설정을 클릭합니다.

gcloud

베어메탈 솔루션 서버의 전원을 끄고 다시 시작하려면 다음 단계를 따르세요.
1. 반드시 API 설정 단계를 따라야 합니다.
  
  서버를 다시 시작하려면 베어메탈 솔루션 API와 gcloud CLI를 사용 설정해야 합니다. 또한 베어메탈 솔루션 관리자 또는 베어메탈 솔루션 편집자 IAM 역할을 주 구성원에 부여해야 합니다. 설정 단계를 완료하려면 베어메탈 솔루션 API를 사용하도록 Google Cloud 프로젝트 설정을 참조하세요.
2. 베어메탈 솔루션 서버를 종료하고 다시 시작하려면 gcloud bms instances reset 명령어를 실행합니다.
  
  참고: 기본적으로 이 명령어는 동기 모드로 실행되며 재시작 작업이 완료될 때까지 다른 명령어를 추가로 실행할 수 없습니다. 자동화된 환경이거나 재시작 작업 중에 다른 작업을 수행해야 하는 경우 --async 옵션을 추가하여 이 명령어를 비동기 모드로 실행하세요.
```
gcloud bms instances reset SERVER_NAME --project=PROJECT_ID --region=REGION
```
  출력에 서버 재시작 요청의 상태가 표시됩니다.
```
Reset request issued for: [SERVER_NAME]

Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
```
  명령어를 입력하면 베어메탈 솔루션 서버가 다시 시작됩니다. 서버 구성에 따라 다시 시작하는 데 15~60분 정도 걸립니다.
  
  이 명령어의 출력은 재시작 상태를 확인하는 데 사용할 수 있는 작업 ID를 제공합니다. 작업 ID를 사용하여 재시작 상태를 확인하려면 장기 실행 작업 상태 보기를 참조하세요.
서버 전원을 켜려면 gcloud bms instances start 명령어를 사용합니다.

참고: 기본적으로 이 명령어는 동기 모드로 실행되며 시작 작업이 완료될 때까지 다른 명령어를 추가로 실행할 수 없습니다. 자동화된 환경이거나 시작 작업 중에 다른 작업을 수행해야 하는 경우 --async 옵션을 추가하여 이 명령어를 비동기 모드로 실행하세요.
```
gcloud bms instances start SERVER_NAME --project=PROJECT_ID --region=REGION
```
출력에 서버 재시작 요청의 상태가 표시됩니다.
```
Start request issued for: [SERVER_NAME]

Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
```
대부분의 경우 서버 전원이 켜진 상태로 유지됩니다. 전원을 꺼야 하는 경우 다음 옵션을 사용하세요.
- 서버 운영체제의 종료 명령어를 사용합니다.
- 일부 애플리케이션은 이미지 재처리 후 서버 전원을 자동으로 끕니다.
서버 전원을 끄려면 gcloud bms instances stop 명령어를 사용합니다.
```
gcloud bms instances stop --project=PROJECT_ID --region=REGION SERVER_NAME
```

API

베어메탈 솔루션 서버의 전원을 끄고 다시 시작하려면 다음 단계를 따르세요.
1. 반드시 API 설정 단계를 따라야 합니다.
  
  서버를 다시 시작하려면 베어메탈 솔루션 API와 gcloud CLI를 사용 설정해야 합니다. 또한 베어메탈 솔루션 관리자 또는 베어메탈 솔루션 편집자 IAM 역할을 부여해야 합니다. 설정 단계를 완료하려면 베어메탈 솔루션 API를 사용하도록 Google Cloud 프로젝트 설정을 참조하세요.
2. 베어메탈 솔루션 서버에 로그인하여 서버 재시작을 확인합니다.
  - Google Cloud 콘솔 창을 엽니다.
  - 점프 호스트 VM 인스턴스로 이동합니다. Compute Engine > VM 인스턴스
  - SSH 버튼을 클릭하여 점프 호스트 VM 인스턴스에 연결합니다.
  - 베어메탈 솔루션 서버에 로그인하려면 점프 호스트 명령줄에 SSH 명령어를 입력하세요.
```
[username@instance-jump-host ~]$ ssh customeradmin@bms-ip-address>
customeradmin@bms-ip-address's password: bms-password
Last login: Mon Mar 15 22:43:19 2022 from bms-ip-address
[customeradmin@BMS_SERVER_NAME ~]$
```
  - top 명령어를 입력하여 서버가 실행 중인지 확인합니다. 이 창을 사용하여 재부팅 진행 상황을 모니터링할 수 있습니다.
3. 재시작 명령어 실행
  - Cloud Shell 창을 엽니다.
  - 클라우드 프로젝트 ID, 리전 및 베어메탈 솔루션 서버 이름을 다음 명령어에 추가합니다.
```
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/BMS_SERVER_NAME:reset"
```
    참고: 이 명령어의 V2 버전은 V1 버전을 대체했습니다. 이 명령어의 V2 버전을 사용하는 것이 좋습니다.
  - Cloud Shell 창에 명령어를 복사하여 붙여넣고 Enter 또는 Return 키를 누릅니다.
    
    베어메탈 솔루션 서버가 다시 시작합니다. 서버 구성에 따라 다시 시작하는 데 15~60분 정도 걸립니다.
    
    이 명령어의 출력은 재시작 상태를 확인하는 데 사용할 수 있는 작업 ID를 제공합니다. 작업 ID를 사용하여 상태를 확인하려면 장기 실행 작업 상태 보기를 참조하세요.
```
{
 "name": "operations/5c0c8b3f-5edc-4117-be9f-812af9740aaf"
}
```
    서버가 재부팅되는 동안 점프 호스트 VM 인스턴스에서 핑 또는 SSH를 사용하여 베어메탈 솔루션 서버에 연결할 수 없습니다. 몇 분 후면 베어메탈 솔루션 서버가 다시 온라인 상태가 됩니다.
    
    서버가 온라인 상태가 되면 호스트 VM 인스턴스에서 핑을 실행하거나 SSH를 사용하여 베어메탈 솔루션 서버에 연결할 수 있습니다.
    
    참고: 재시작이 완료되는 데 15~60분 정도 걸립니다. 서버가 준비되기 전에 재시작 명령어를 다시 실행하려고 하면 오류 메시지가 표시됩니다. 서버가 다시 온라인 상태가 되기를 기다린 후 명령어를 다시 실행합니다.
베어메탈 솔루션 서버 다시 시작에 대한 자세한 내용은 베어메탈 솔루션 API를 참조하세요.
서버의 전원을 켜려면 프로젝트 ID, 리전, 서버 이름을 입력한 후 다음 curl 명령어를 실행합니다.
```
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME:start"
```
대부분의 경우 서버 전원이 켜진 상태로 유지됩니다. 전원을 꺼야 하는 경우 다음 옵션을 사용하세요.
- 서버 운영체제의 종료 명령어를 사용합니다.
- 일부 애플리케이션은 이미지 재처리 후 서버 전원을 자동으로 끕니다.

서버 전원을 끄려면 프로젝트 ID, 리전, 서버 이름을 입력하고 다음 curl 명령어를 실행합니다.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME:stop"

서버 시작, 중지, 다시 시작을 완료하는 데 시간이 오래 걸리므로 장기 실행 작업 상태 보기의 단계를 수행하여 상태를 확인할 수 있습니다.

서버 상태 확인

서버는 수명 주기의 일부로 여러 상태로 전환합니다. 서버를 시작할 때 베어메탈 솔루션은 서버의 리소스를 프로비저닝합니다. 그런 다음 서버가 부팅 시퀀스를 준비합니다. 서버가 시작되면 서버가 실행 중 상태로 이동합니다. 정상 작동 중에는 실행 중인 서버를 중지했다가 다시 시작할 수 있습니다.

서버는 다음 상태 중 하나일 수 있습니다.

프로비저닝 : 서버에 리소스가 할당됩니다. 서버가 아직 실행 중이 아닙니다.
시작 중 : 리소스가 확보되었습니다. 서버를 부팅하는 중입니다.
실행 중 : 서버가 실행 중입니다.
중지 중 : 서버를 중지하는 중입니다.
종료 : 서버가 중지되고 전원이 꺼집니다.
삭제됨 : 서버가 삭제되었습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
상태 열에서 서버의 상태를 볼 수 있습니다.

gcloud

서버 상태를 확인하려면 gcloud bms instances describe 명령어를 실행합니다.

gcloud bms instances describe --project=PROJECT_ID --region=REGION SERVER_NAME

출력의 state 필드에서 서버 상태를 볼 수 있습니다. 예를 들면 다음과 같습니다.

state: RUNNING

API

서버 상태를 확인하려면 프로젝트 ID, 리전, 서버 이름을 다음 curl 명령어에 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"

출력의 state 필드에서 서버 상태를 볼 수 있습니다. 예를 들면 다음과 같습니다.

"state" : "RUNNING"

베어메탈 솔루션 환경에서 리소스 관리

베어메탈 솔루션 관리 API, gcloud 명령어, Google Cloud 콘솔을 사용하면 서버, 네트워킹, 스토리지와 같은 베어메탈 솔루션 환경에서 리소스 상태를 볼 수 있습니다.

베어메탈 솔루션 API 설정 확인

리소스 상태를 보려면 베어메탈 솔루션 API와 gcloud CLI를 사용 설정해야 합니다. 또한 베어메탈 솔루션 관리자 또는 베어메탈 솔루션 편집자와 같은 베어메탈 솔루션 IAM 역할 중 하나를 주 구성원에 부여해야 합니다. 리소스 관리 전 API 설정 단계를 완료하려면 베어메탈 솔루션 API를 사용하도록 Google Cloud 프로젝트 설정을 참조하세요.

서버 관리

다음 방법으로 베어메탈 솔루션 환경에서 서버를 관리할 수 있습니다.

베어메탈 솔루션 환경에서 서버 보기

베어메탈 솔루션 관리 API를 호출하기 위해 명령어를 실행할 때 베어메탈 솔루션 환경의 기기 상태를 확인할 수 있습니다. 현재 상태를 보려면 다음 명령어 옵션 중 하나를 선택합니다.

콘솔

Google Cloud 콘솔에서 베어메탈 솔루션 서버 상태와 관련 네트워킹 및 스토리지 구성요소를 확인할 수 있습니다.

Compute Engine > 베어메탈 솔루션 > 서버로 이동합니다.

제공되는 정보를 확인합니다.

필드	설명	예시
상태	서버의 가용성을 나타냅니다.	체크표시가 있는 녹색 원은 서버가 프로비저닝되었으며 사용할 수 있음을 나타냅니다.
ID	서버에 할당된 식별자입니다. 서버에 대한 기본 정보를 보려면 ID를 클릭합니다. 이 리소스의 문제를 해결할 때 Google Cloud 지원팀에 ID를 공유하세요.	`at-1234567-svr001`
이름	서버 이름. 서버에 대한 추가 정보를 확인하려면 이름을 클릭합니다. 참고: 서버를 프로비저닝할 때 이름을 입력하지 않으면 이 필드에 ID가 표시됩니다.	`server-1`
위치	베어메탈 솔루션 리전	`asia-southeast1`
서버 유형	서버 사양	`o2-standard-32-metal`
클라이언트 IP	Google Virtual Private Cloud에 연결되는 서버 IP 주소	`10.200.0.5`
비공개 IP	다른 베어메탈 솔루션 환경 리소스에 연결되는 서버 IP 주소	`192.168.2.5`
라벨	이 서버에 추가한 라벨이 표시됩니다. 라벨의 텍스트를 복사하여 상태 필드 바로 위에 있는 필터 상자에 붙여넣으면 라벨을 사용하여 콘솔 출력을 필터링할 수 있습니다.	`environment:test`

서버와 서버의 네트워킹 및 스토리지 기능에 대한 추가 정보를 보려면 서버의 이름을 클릭합니다.
- 기본 정보에서 서버가 하이퍼스레딩을 지원하는지 여부를 확인할 수 있습니다.
- 네트워킹에서 네트워크 인터페이스 이름, 인터페이스 유형(클라이언트 또는 비공개), IP 주소, MAC 주소를 볼 수 있습니다.
- 스토리지의 경우 상태, 이름, 볼륨, 크기, 유형과 같은 논리 단위 번호(LUN) 정보를 볼 수 있습니다. 또한 LUN이 공유 가능하고 부팅 가능한지 여부를 확인할 수 있습니다.

gcloud

베어메탈 솔루션 환경의 서버를 나열하고 상태를 확인하려면 프로젝트 ID를 입력하고 gcloud bms instances list 명령어를 실행합니다.
```
gcloud bms instances list --project=PROJECT_ID
```
다음 출력 예시는 서버 이름, 유형, IP 주소, 상태와 같은 서버 관련 정보를 보여줍니다.
```
NAME               PROJECT              REGION           MACHINE_TYPE          IP_ADDRESSES             STATE
SERVER_NAME      PROJECT_ID        REGION         o2-standard-32-metal  192.168.1.1,192.168.2.1  RUNNING
```
추가 명령어 옵션은 다음과 같습니다.
- --region: 특정 Google Cloud 리전의 기기를 열람합니다.
- --limit: 특정 기기 수를 표시하도록 출력을 제한합니다.

베어메탈 솔루션 환경에서 특정 서버에 대한 네트워크 및 스토리지 정보를 가져오려면 서버 이름, 프로젝트 ID, 리전을 입력하고 gcloud bms instances describe 명령어를 실행합니다.

gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION

다음 출력 예시는 12개 LUN, 192.168.1.1의 클라이언트 네트워크, 192.168.2.1의 비공개 네트워크로 구성된 운영 서버를 보여줍니다.

luns:
- bootLun: true
  name: SERVER_NAME-lun000-b1
  sizeGb: '200'
  state: READY
  storageVolume: SERVER_NAME-vol000-b1
- name: STORAGE_DEVICE_NAME-lun001
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun002
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun003
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun004
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun005
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun006
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun007
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun008
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun009
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun010
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun011
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun012
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
machineType: o2-standard-32-metal
name: projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME
networks:
- ipAddress: 192.168.1.1
  macAddress:
  - 34:80:0D:52:AF:28
  - 34:80:0D:15:3E:0D
  network: STORAGE_DEVICE_NAME-vlan001
- ipAddress: 192.168.2.1
  macAddress:
  - 34:80:0D:52:AF:38
  - 34:80:0D:15:3E:1D
  network: STORAGE_DEVICE_NAME-vlan002
state: RUNNING

API

Google Cloud 콘솔에서 Cloud Shell 터미널 창을 엽니다.
베어메탈 솔루션 환경에 서버를 나열하고 상태를 보려면 다음 curl 명령어에 프로젝트 ID와 리전을 입력하고 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣은 후 Enter 또는 Return 키를 누릅니다.
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances"
```

베어메탈 솔루션 환경에서 서버에 대한 네트워크 및 스토리지 정보를 가져오려면 다음 명령어를 실행합니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"

라벨을 사용하여 서버 구성

서버 구성을 돕기 위해 라벨을 사용할 수 있습니다. 라벨은 각 서버에 연결할 수 있는 키-값 쌍으로, 라벨에 따라 서버를 필터링할 수 있습니다. 예를 들어 라벨을 사용하여 용도, 환경, 위치, 부서 등을 기준으로 서버를 그룹화할 수 있습니다. 라벨은 선택사항입니다.

서버 라벨 추가 또는 업데이트

기존 서버의 라벨을 추가하거나 업데이트할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
라벨을 지정하려는 서버에서 을 클릭합니다.
라벨 수정을 클릭합니다.
라벨 편집기 페이지에서 다음을 수행합니다.
1. 라벨 추가를 클릭하고 키-값 쌍을 추가합니다.
2. 라벨을 업데이트하려면 기존 라벨을 선택하고 값을 수정합니다.
3. 제출을 클릭합니다.
서버 페이지로 돌아와서 페이지를 새로고침하여 변경사항을 확인합니다.

gcloud

서버의 라벨을 추가하거나 업데이트하려면 --update-labels 옵션과 함께 gcloud bms instances update 명령어를 사용합니다.

다음 샘플 명령어는 environment = dev 및 location = branch 라벨을 추가합니다.

gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

이미 존재하는 라벨에 새 값을 제공하면 시스템에서 기존 키를 새 라벨 값으로 업데이트합니다. 새 라벨을 제공하면 시스템에서 라벨 목록에 새 라벨을 추가합니다.

API

서버의 라벨을 추가하거나 업데이트하려면 다음 curl 명령어에 프로젝트 ID, 리전, 서버 이름, 라벨 목록을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

다음 샘플 명령어는 environment = test의 라벨을 할당합니다.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

서버에서 라벨 삭제

서버에서 라벨을 삭제할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
라벨을 삭제할 서버의 경우 을 클릭합니다.
라벨 수정을 클릭합니다.
라벨 편집기 페이지에서 다음을 수행합니다.
1. 라벨을 삭제하려면 을 클릭합니다.
2. 제출을 클릭합니다.
서버 페이지로 돌아와서 페이지를 새로고침하여 변경사항을 확인합니다.

gcloud

서버에서 라벨을 삭제하려면 다음 옵션과 함께 gcloud bms instances update 명령어를 사용합니다.

--remove-labels: 지정된 라벨을 삭제합니다.
--clear-labels: 모든 라벨을 삭제합니다.

다음 샘플 명령어는 서버에서 department 라벨을 삭제합니다.

gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

다음 샘플 명령어는 서버에서 모든 라벨을 삭제합니다.

gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

서버에서 라벨을 삭제하려면 다음 curl 명령어에 프로젝트 ID, 리전, 서버 이름을 입력합니다. 비어 있는 라벨 목록을 제공하여 모든 라벨을 삭제하거나 유지하려는 라벨 목록을 제공합니다(삭제하려는 라벨은 생략). 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

다음 샘플 명령어는 environment = test를 제외한 모든 라벨을 삭제합니다.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

라벨을 사용하여 서버 필터링

라벨을 사용하여 서버를 검색하고 결과를 필터링할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
서버 목록 위에 있는 필터 표시줄을 클릭합니다.
속성 목록에서 라벨을 선택합니다.
라벨의 키, 값 또는 키-값 쌍을 입력합니다.

예를 들어 env:dev 라벨이 있는 서버만 보려면 다음 중 하나를 입력하면 됩니다.
- env 키를 입력합니다.
- dev 값을 입력합니다.
- env:dev 키-값 쌍을 입력합니다.
라벨 필터를 적용하려면 필터 표시줄 외부의 아무 곳을 클릭합니다.

gcloud

라벨을 사용하여 서버를 필터링하려면 --filter 옵션과 함께 gcloud bms instances list 명령어를 사용하세요.

--filter 옵션의 값은 labels.KEY=VALUE 형식이어야 합니다. 예를 들어 env 키 및 dev 값으로 라벨을 필터링하려면 다음 명령어를 실행합니다.

gcloud bms instances list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

gcloud CLI의 필터 구문에 대한 상세 설명은 gcloud topic filters 문서를 참조하세요.

API

라벨을 사용하여 서버를 필터링하려면 filter=labels 및 키-값 쌍 라벨과 함께 프로젝트 ID 및 리전을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

다음 샘플 명령어는 키-값 쌍 라벨이 environment = test인 서버를 찾도록 출력을 제한합니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances"?filter=labels.environment=test

서버의 초기 비밀번호 검색

베어메탈 솔루션 서버를 처음 받거나 운영체제를 변경하면 서버가 기본 상태로 시작되며 초기 비밀번호가 있습니다. 서버에 처음 액세스할 때 이 비밀번호를 사용해야 합니다. 초기 비밀번호를 입력하면 서버에서 비밀번호를 변경하라는 메시지를 표시합니다.

초기 비밀번호를 찾으려면 다음 안내를 따르세요.

gcloud

비밀번호를 검색하기 전에 Google Cloud에서 제공한 서비스 계정이 활성화되어 있는지 확인합니다.
베어메탈 솔루션 리소스가 포함된 프로젝트에서 Cloud Shell을 활성화하고 gcloud bms instances describe 명령어를 실행하세요.
```
gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION
```
출력에서 loginInfo 필드를 찾은 후 안내를 따릅니다.
loginInfo 필드에 gcloud beta secrets versions access 명령어가 포함되어 있으면 명령어를 복사하여 명령줄 프롬프트에 붙여넣고 Enter 키 또는 Return 키를 누릅니다.
사용자 이름(일반적으로 customeradmin) 및 비밀번호를 검색합니다.
이 사용자 인증 정보를 사용하여 서버에 로그인합니다.
비밀번호를 변경합니다.

API

비밀번호를 검색하기 전에 Google Cloud에서 제공한 서비스 계정이 활성화되어 있는지 확인합니다.
베어메탈 솔루션 리소스가 포함된 프로젝트에서 Cloud Shell에 액세스합니다.

다음 curl 명령어에 프로젝트 ID, 리전, 서버 이름을 입력하고, 명령줄 프롬프트에 명령어를 복사하여 붙여넣은 다음 Enter 또는 Return 키를 누릅니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"

출력에서 loginInfo 필드를 찾은 후 안내를 따릅니다.
loginInfo 필드에 gcloud beta secrets versions access 명령어가 포함되어 있으면 명령어를 복사하여 명령줄 프롬프트에 붙여넣고 Enter 키 또는 Return 키를 누릅니다.
사용자 이름(일반적으로 customeradmin) 및 비밀번호를 검색합니다.
이 사용자 인증 정보를 사용하여 서버에 로그인합니다.
비밀번호를 변경합니다.

서버의 운영체제 변경

베어메탈 솔루션 서버를 다른 OS 이미지로 이미지 재설치할 수 있습니다. OS 이미지를 변경하는 데 오랜 시간이 걸리며 서버의 전원을 껐다 켜야 합니다. 사용 가능한 OS 이미지 중 하나를 선택하려면 운영체제를 방문하세요.

콘솔

Google Cloud 콘솔에서 베어메탈 솔루션 서버의 이미지를 만들 수 있습니다.

Compute Engine > 베어메탈 솔루션 > 서버로 이동합니다.
이미지를 만들려는 서버에서 메뉴를 클릭합니다.
수정을 클릭합니다.
서버 수정 페이지에서 다음을 수행합니다.
- 이미지 재이미지 체크박스를 선택합니다.
- OS 이미지 목록에서 설치할 OS 이미지를 선택합니다.
- 저장을 클릭합니다.

gcloud

gcloud bms instances update 명령어를 실행하여 서버의 OS 이미지를 변경합니다.

gcloud bms instances update SERVER_NAME --region REGION --os-image=OS_IMAGE

API

베어메탈 솔루션 서버에서 OS 이미지를 업데이트하려면 프로젝트 ID, 리전, 서버 이름 및 OS 이미지를 입력한 후 다음 curl 명령어를 실행하세요.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=os_image"
 -d "{
  'osImage' : 'OS_IMAGE'
}"

이 변경이 완료되는 데 다소 시간이 걸리므로 장기 실행 작업 상태 보기의 단계에 따라 상태를 확인할 수 있습니다.

서버에서 하이퍼스레딩 사용 설정

베어메탈 솔루션 서버에서 하이퍼스레딩을 사용 설정 또는 사용 중지할 수 있습니다. 이 작업은 완료하는 데 시간이 많이 걸리며 서버의 전원을 껐다 켜야 합니다.

콘솔

Google Cloud 콘솔의 베어메탈 솔루션 서버에서 하이퍼 스레딩을 사용 설정하거나 사용 중지할 수 있습니다.

Compute Engine > 베어메탈 솔루션 > 서버로 이동합니다.
하이퍼 스레딩을 사용 설정/사용 중지하려는 서버에서 메뉴를 클릭합니다.
수정을 클릭합니다.
서버 수정 페이지에서 다음을 수행합니다.
- 하이퍼 스레딩을 사용 설정하려면 하이퍼 스레드 사용 설정 체크박스를 선택합니다.
- 하이퍼 스레딩을 사용 중지하려면 하이퍼 스레드 사용 설정 체크박스를 선택 취소합니다.
- 저장을 클릭합니다.

gcloud

하이퍼스레딩을 사용 설정 또는 중지하려면 gcloud bms instances update 명령어를 실행합니다.

–enable-hyperthreading 옵션을 포함하여 사용 설정합니다.
–no-enable-hyperthreading 옵션을 포함하여 사용 중지합니다.

gcloud bms instances update SERVER_NAME --region REGION --enable-hyperthreading

API

서버의 현재 하이퍼스레딩 기능을 변경하려면 다음 curl 명령어에 프로젝트 ID, 리전, 서버 이름을 입력합니다. 하이퍼스레딩 값을 사용하려면 true를 추가하고 이를 중지하려면 false를 추가합니다.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=hyperthreading_enabled"
 -d "{
  'hyperthreadingEnabled' : 'HYPERTHREADING_VALUE'
}"

이 변경이 완료되는 데 다소 시간이 걸리므로 장기 실행 작업 상태 보기의 단계에 따라 상태를 확인할 수 있습니다.

네트워크 관리하기

다음 방법으로 베어메탈 솔루션 환경에서 네트워크를 관리할 수 있습니다.

베어메탈 솔루션 환경에서 네트워크 보기

베어메탈 솔루션 환경에서 네트워크 리소스를 모니터링하면 서버가 다른 리소스에 연결하는 방법을 알 수 있습니다. 네트워킹 상태를 보려면 다음 옵션 중 하나를 선택합니다.

콘솔

Google Cloud 콘솔에서 Compute Engine > 베어메탈 솔루션 > 네트워크로 이동합니다.

제공되는 정보를 확인합니다.

필드	설명	예시
상태	네트워크의 가용성을 나타냅니다.	체크표시가 있는 녹색 원은 네트워크가 프로비저닝되었으며 사용 가능한 상태임을 나타냅니다.
ID	네트워크에 할당된 식별자입니다. 네트워크에 대한 기본 정보를 보려면 ID를 클릭합니다. 이 리소스의 문제를 해결할 때 Google Cloud 지원팀에 ID를 공유하세요.	`at-1234567-vlan001`
이름	네트워크 이름. 네트워크에 대한 추가 정보를 확인하려면 이름을 클릭합니다. 참고: 네트워크를 프로비저닝할 때 이름을 입력하지 않으면 이 필드에 ID가 표시됩니다.	`network-1`
위치	네트워크가 위치한 리전	`asia-southeast1`
유형	클라이언트 또는 비공개 네트워크	`Client`
CIDR	네트워크의 IP 주소 범위	`192.168.1.0/24`
VLAN ID	Google Cloud에서 할당한 VLAN 식별자	`100`
라벨	이 네트워킹 리소스에 추가한 라벨이 표시됩니다. 라벨의 텍스트를 복사하여 상태 필드 바로 위에 있는 필터 상자에 붙여넣으면 라벨을 사용하여 콘솔 출력을 필터링할 수 있습니다.	`environment:test`

gcloud

베어메탈 솔루션 환경의 모든 네트워크를 보고 해당 상태를 확인하려면 프로젝트 ID를 입력하고 gcloud bms networks list 명령어를 실행합니다.
```
gcloud bms networks list --project=PROJECT_ID
```
다음 출력 예시에서는 각 네트워크의 네트워크 이름, 리전, IP 주소 범위, 네트워크 유형, VLAN ID를 보여줍니다.
```
NAME                REGION           RANGE           TYPE     VLAN_ID
at-1111111-vlan001  REGION         192.168.1.0/24  CLIENT   122
at-1111111-vlan002  REGION         192.168.2.0/24  PRIVATE  123
```

단일 네트워크의 세부정보를 보려면 프로젝트 ID, 리전, 네트워크 이름을 입력하고 gcloud bms networks describe 명령어를 실행합니다.

gcloud bms networks describe NETWORK_NAME --project=PROJECT_ID --region=REGION

다음 출력 예시는 IP 주소 범위, 네트워크 이름, 상태, 네트워크 유형, VLAN ID, 가상 라우팅 및 전달(VRF) 세부정보를 보여줍니다.

cidr: 192.168.1.0/24
name: projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME
state: PROVISIONED
type: CLIENT
vlanId: '122'
vrf:
  autonomousSystemNumber: '65500'
  juniperAlias: g00000-at-1111111-ic001
  name: at-1111111-ic001
  routeTarget: '282'
  state: PROVISIONED

API

Google Cloud 콘솔에서 Cloud Shell 터미널 창을 엽니다.
베어메탈 솔루션 환경의 모든 네트워크를 보고 상태를 보려면 다음 curl 명령어에 프로젝트 ID와 리전을 입력하고 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣은 후 Enter 또는 Return 키를 누릅니다.
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks"
```

단일 네트워크의 세부정보를 보려면 프로젝트 ID, 리전, 네트워크 이름을 입력하고 다음 명령어를 실행합니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME"

라벨을 사용하여 네트워크 정리

라벨을 사용하여 네트워크를 정리할 수 있습니다. 라벨은 각 네트워크에 연결할 수 있는 키-값 쌍으로, 라벨에 따라 네트워크를 필터링할 수 있습니다. 예를 들어 라벨을 사용하여 용도, 환경, 위치, 부서 등을 기준으로 네트워크를 그룹화할 수 있습니다. 라벨은 선택사항입니다.

네트워크 라벨 추가 또는 업데이트

기존 네트워크의 라벨을 추가하거나 업데이트할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 네트워크 페이지로 이동합니다.
라벨을 지정하려는 네트워크에서 을 클릭합니다.
라벨 수정을 클릭합니다.
라벨 편집기 페이지에서 다음을 수행합니다.
1. 라벨 추가를 클릭하고 키-값 쌍을 추가합니다.
2. 라벨을 업데이트하려면 기존 라벨을 선택하고 값을 수정합니다.
3. 제출을 클릭합니다.
네트워크 페이지로 돌아와서 페이지를 새로고침하여 변경사항을 확인합니다.

gcloud

네트워크의 라벨을 추가하거나 업데이트하려면 --update-labels 옵션과 함께 gcloud bms networks update 명령어를 사용합니다.

다음 샘플 명령어는 environment = dev 및 location = branch 라벨을 추가합니다.

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

이미 존재하는 라벨에 새 값을 제공하면 시스템에서 기존 라벨을 새 값으로 업데이트합니다. 새 라벨을 제공하면 시스템에서 라벨 목록에 새 라벨을 추가합니다.

API

네트워크의 라벨을 추가하거나 업데이트하려면 다음 curl 명령어에 프로젝트 ID, 리전, 네트워크 이름, 라벨 목록을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

다음 샘플 명령어는 environment = test의 라벨을 할당합니다.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

네트워크에서 라벨 삭제

네트워크에서 라벨을 삭제할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 네트워크 페이지로 이동합니다.
라벨을 삭제할 네트워크의 경우 을 클릭합니다.
라벨 수정을 클릭합니다.
라벨 편집기 페이지에서 다음을 수행합니다.
1. 라벨을 삭제하려면 을 클릭합니다.
2. 제출을 클릭합니다.
네트워크 페이지로 돌아와서 페이지를 새로고침하여 변경사항을 확인합니다.

gcloud

네트워크에서 라벨을 삭제하려면 다음 옵션과 함께 gcloud bms networks update 명령어를 사용합니다.

--remove-labels: 지정된 라벨을 삭제합니다.
--clear-labels: 모든 라벨을 삭제합니다.

다음 샘플 명령어는 네트워크에서 department 라벨을 삭제합니다.

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

다음 샘플 명령어는 네트워크에서 모든 라벨을 삭제합니다.

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

네트워크에서 라벨을 삭제하려면 다음 curl 명령어에 프로젝트 ID, 리전, 네트워크 이름을 입력합니다. 비어 있는 라벨 목록을 제공하여 모든 라벨을 삭제하거나 유지하려는 라벨 목록을 제공합니다(삭제하려는 라벨은 생략). 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

다음 샘플 명령어는 environment = test를 제외한 모든 라벨을 삭제합니다.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

라벨을 사용하여 네트워크 필터링

라벨을 사용하여 네트워크를 검색하고 결과를 필터링할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 네트워크 페이지로 이동합니다.
네트워크 목록 위에 있는 필터 막대를 클릭합니다.
속성 목록에서 라벨을 선택합니다.
라벨의 키, 값 또는 키-값 쌍을 입력합니다.

예를 들어 env:dev 라벨이 있는 네트워크만 보려면 다음 중 하나를 입력하면 됩니다.
- env 키를 입력합니다.
- dev 값을 입력합니다.
- env:dev 키-값 쌍을 입력합니다.
라벨 필터를 적용하려면 필터 표시줄 외부의 아무 곳을 클릭합니다.

gcloud

라벨을 사용하여 네트워크를 필터링하려면 --filter 옵션과 함께 gcloud bms networks list 명령어를 사용합니다.

--filter 옵션의 값은 labels.KEY=VALUE 형식이어야 합니다. 예를 들어 env 키 및 dev 값으로 라벨을 필터링하려면 다음 명령어를 실행합니다.

gcloud bms networks list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

gcloud CLI의 필터 구문에 대한 상세 설명은 gcloud topic filters 문서를 참조하세요.

API

라벨을 사용하여 네트워크를 필터링하려면 filter=labels 및 키-값 쌍 라벨과 함께 프로젝트 ID 및 리전을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

다음 샘플 명령어는 키-값 쌍 라벨이 environment = test인 네트워크를 찾도록 출력을 제한합니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks"?filter=labels.environment=test

서버에 네트워크 추가 및 연결

베어메탈 솔루션을 사용하면 다음 두 가지 방법으로 네트워크를 추가할 수 있습니다.

새 네트워크 만들기 및 서버에 연결

새 네트워크 생성 및 연결

콘솔

Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
서버 이름을 클릭합니다.
서버 세부정보 페이지에서 네트워크 연결을 클릭합니다.
네트워크 연결 페이지에서 새 네트워크를 선택합니다.
이름 필드에 네트워크의 이름을 입력합니다.
네트워크 유형을 선택합니다.
1. 클라이언트 네트워크를 만들려면 클라이언트를 선택합니다.
2. 비공개 네트워크를 만들려면 비공개를 선택합니다.
(클라이언트 네트워크 유형을 선택한 경우에만 적용 가능) VLAN 연결을 추가하려면 항목 추가를 클릭합니다.

참고 새 VLAN 연결을 만들 대역폭이 없으면 기존 VLAN 연결을 삭제하거나 Google Cloud 영업팀에 추가 대역폭을 요청합니다.
1. 현재 프로젝트에서 VLAN 연결을 추가하려면 다음 안내를 따르세요.
  1. 현재 프로젝트에서 VLAN 연결 선택 옵션을 선택합니다.
  2. VLAN 연결 목록에서 추가할 VLAN 연결을 선택합니다.
2. 다른 프로젝트의 VLAN 연결을 추가하려면 다음 안내를 따르세요.
  1. 현재 프로젝트에서 VLAN 연결 선택 체크박스를 선택 해제합니다.
  2. VLAN 연결 페어링 키 필드에 페어링 키를 입력합니다.
    
    키 페어링에 대한 자세한 내용은 Cloud Interconnect 연결을 위한 VLAN 연결 만들기를 참조하세요.
3. 대역폭 목록에서 VLAN 연결에 할당할 대역폭 양을 선택합니다.
4. 완료를 클릭합니다.
네트워크 IP 주소 범위 필드에 네트워크의 IP 주소 범위를 입력합니다.
(선택사항) 서비스 IP 주소 범위 필드에 네트워크의 서비스 IP 주소 범위를 입력합니다.

참고: 서비스 IP 주소 범위는 네트워크 IP 주소 범위가 리전 내 다른 베어메탈 솔루션 네트워크와 겹치지 않는 경우에만 정의할 수 있습니다.
네트워크의 MTU를 선택합니다.
1. 1500—표준 크기 프레임의 경우
2. 9000—점보 프레임의 경우
인터페이스 구성을 설정합니다.

참고: 여기에 설정된 구성 외에도 서버의 인터페이스를 구성해야 합니다. OS 문서를 참조하세요.
1. 인터페이스 목록에서 이 네트워크의 결합 인터페이스를 선택합니다.
  
  대부분의 경우 클라이언트 네트워크에는 bond0을, 비공개 네트워크에는 bond1을 선택합니다.
2. IP 주소 필드에 연결하려는 네트워크의 IP 주소를 입력합니다.
(선택사항) 이 네트워크를 기본 게이트웨이로 설정하려면 기본 게이트웨이 체크박스를 선택합니다.
네트워크 연결을 클릭합니다.

서버 상태가 '프로비저닝'으로 변경됩니다. 네트워크를 연결하는 데 다소 시간이 걸리므로 장기 실행 작업 상태 보기의 단계에 따라 상태를 확인할 수 있습니다. 작업이 완료되면 서버 상태가 '실행 중'으로 변경됩니다.

서버에 기존 네트워크 연결

다음 두 가지 조건에 따라 기존 네트워크를 서버에 연결할 수 있습니다.

네트워크가 아직 서버에 연결되어 있지 않습니다.
네트워크의 IP 주소 범위가 서버에 연결된 다른 네트워크와 겹치지 않습니다.

기존 네트워크를 연결하려면 다음 안내를 따르세요.

콘솔

Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
서버 이름을 클릭합니다.
서버 세부정보 페이지에서 네트워크 연결을 클릭합니다.
네트워크 연결 페이지에서 기존 네트워크를 선택합니다.
네트워크를 선택합니다.
1. 현재 프로젝트에서 네트워크를 선택하려면 다음 안내를 따르세요.
  1. 조직의 다른 프로젝트에서 네트워크 선택 옵션이 표시되지 않았는지 확인합니다.
  2. 기존 네트워크 선택 목록에서 서버에 연결할 네트워크를 선택합니다.
2. 조직의 다른 프로젝트에서 네트워크를 선택하려면 다음 안내를 따르세요.
  1. 조직의 다른 프로젝트에서 네트워크 선택 옵션을 선택합니다.
  2. 기존 네트워크 선택 목록에서 서버에 연결할 네트워크를 선택합니다.
인터페이스 구성을 설정합니다.

참고: 여기에 설정된 구성 외에도 서버의 인터페이스를 구성해야 합니다. OS 문서를 참조하세요.
1. 인터페이스 목록에서 이 네트워크의 결합 인터페이스를 선택합니다.
  
  대부분의 경우 클라이언트 네트워크에는 bond0을, 비공개 네트워크에는 bond1을 선택합니다.
2. IP 주소 필드에 연결하려는 네트워크의 IP 주소를 입력합니다.
(선택사항) 이 네트워크를 기본 게이트웨이로 설정하려면 기본 게이트웨이 체크박스를 선택합니다.
네트워크 연결을 클릭합니다.

서버에서 네트워크 분리

한 번에 하나의 네트워크만 서버에서 분리할 수 있으며, 서버는 실행 중이거나 전원이 꺼질 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
서버 이름을 클릭합니다.
서버 세부정보 페이지에서 분리할 네트워크를 선택합니다.
네트워크 분리를 클릭합니다.
메시지가 나타나면 확인을 클릭합니다.

서버 상태가 '프로비저닝'으로 변경됩니다. 네트워크를 분리하는 데 다소 시간이 걸리므로 장기 실행 작업 상태 보기의 단계에 따라 상태를 확인할 수 있습니다. 작업이 완료되면 서버 상태가 '실행 중'으로 변경됩니다.

네트워크 삭제

네트워크를 삭제하려면 다음 안내를 따르세요.

콘솔

Compute Engine > 베어메탈 솔루션 > 네트워크 페이지로 이동합니다.
삭제할 네트워크를 선택합니다.
Delete(삭제)를 클릭합니다.
메시지가 나타나면 확인을 클릭합니다.

네트워크 삭제를 완료하는 데 다소 시간이 걸리므로 장기 실행 작업 상태 보기의 단계에 따라 상태를 확인할 수 있습니다.

VLAN 연결 관리

다음 방법으로 VLAN 연결을 관리할 수 있습니다.

VLAN 연결 추가

하나 이상의 VLAN 연결을 클라이언트 네트워크에 추가할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 네트워크 페이지로 이동합니다.
네트워크 이름을 클릭합니다.
네트워크 세부정보 페이지의 VLAN 연결 섹션에서 연결을 클릭합니다.
네트워크에 새 VLAN 연결 페이지에서 다음을 수행합니다.
1. 항목 추가를 클릭합니다.
2. 현재 프로젝트에서 VLAN 연결을 추가하려면 다음 안내를 따르세요.
  1. 현재 프로젝트에서 VLAN 연결 선택 옵션을 선택합니다.
  2. VLAN 연결 목록에서 추가할 VLAN 연결을 선택합니다.
3. 다른 프로젝트의 VLAN 연결을 추가하려면 다음 안내를 따르세요.
  1. 현재 프로젝트에서 VLAN 연결 선택 체크박스를 선택 해제합니다.
  2. VLAN 연결 페어링 키 필드에 페어링 키를 입력합니다.
    
    키 페어링에 대한 자세한 내용은 Cloud Interconnect 연결을 위한 VLAN 연결 만들기를 참조하세요.
4. 대역폭 목록에서 VLAN 연결에 할당할 대역폭 양을 선택합니다.
5. 중복화 및 고가용성을 위해 다른 VLAN 연결을 추가하려면 항목 추가를 클릭하고 위 단계를 반복합니다.
6. 완료를 클릭합니다.
만들기를 클릭합니다.

VLAN 연결을 만드는 데 다소 시간이 걸리므로 장기 실행 작업 상태 보기의 단계에 따라 상태를 확인할 수 있습니다.

VLAN 연결 업데이트

VLAN 연결의 대역폭을 업데이트할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 네트워크 페이지로 이동합니다.
네트워크 이름을 클릭합니다.
네트워크 세부정보 페이지에서 업데이트할 VLAN 연결을 선택합니다.
업데이트를 클릭합니다.
VLAN 연결 업데이트 페이지에서 다음을 수행합니다.
1. 업데이트할 VLAN 연결을 확장합니다.
2. 대역폭을 수정합니다.
3. 완료를 클릭합니다.
업데이트를 클릭합니다.

VLAN 연결을 업데이트하는 데 다소 시간이 걸리므로 장기 실행 작업 상태 보기의 단계에 따라 상태를 확인할 수 있습니다.

VLAN 연결 삭제

VLAN 연결을 삭제할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 네트워크 페이지로 이동합니다.
네트워크 이름을 클릭합니다.
네트워크 세부정보 페이지에서 삭제할 VLAN 연결을 선택합니다.
Delete(삭제)를 클릭합니다.

VLAN 연결 삭제를 완료하는 데 다소 시간이 걸리므로 장기 실행 작업 상태 보기의 단계를 수행하여 상태를 확인할 수 있습니다.

베어메탈 솔루션 환경의 고급 네트워킹 정보 보기

베어메탈 솔루션 환경에서 복잡한 배포를 위한 고급 네트워킹 옵션을 선택한 경우 다음 서버 명령어를 사용하여 이 정보를 확인할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
서버 이름을 클릭합니다.
서버 세부정보 페이지에서 다음 정보를 볼 수 있습니다.
1. 기본 세부정보에서 네트워크 템플릿을 볼 수 있습니다.
2. 네트워크 섹션에서 다음 정보를 볼 수 있습니다.
  - 네트워크 이름
  - 네트워크 유형
  - IP 주소
  - 기본 게이트웨이
  - 인터페이스 이름

gcloud

gcloud bms instances describe 명령어를 실행하여 서버의 고급 네트워킹 설정을 확인합니다.

gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION

API

서버의 고급 네트워킹 설정을 보려면 프로젝트 ID, 리전, 서버 이름을 입력한 후 다음 curl 명령어를 실행하세요. 출력의 네트워크 섹션에서 각 인터페이스에 할당된 네트워크 템플릿, 논리 인터페이스, 결합 인터페이스, 네트워크 유형을 볼 수 있습니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"

베어메탈 솔루션 환경에서 IP 주소 관리 구현

베어메탈 솔루션 환경 내에서 네트워크 토폴로지를 관리할 수 있어야 합니다. IP 주소 관리는 리소스의 IP 주소를 생성, 확인 및 삭제하는 데 도움이 됩니다. 이 정보를 사용하여 IP 주소 중복을 방지하고 새 리소스를 요청할 때 충돌을 해결할 수 있습니다.

IP 주소 예약 보기

기존 예약의 IP 주소를 보려면 다음 안내를 따르세요.

gcloud

gcloud bms networks list-ip-reservations 명령어를 실행합니다.

gcloud bms networks list-ip-reservations --project=PROJECT_ID --region REGION

API

기존 리소스의 IP 주소 예약을 보려면 프로젝트 ID, 리전, 네트워크 이름을 입력한 후 다음 curl 명령어를 실행하세요. 출력의 reservations 섹션에는 예약된 IP 주소 범위가 표시됩니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME"

IP 주소 예약 만들기 및 업데이트

새 IP 주소 예약을 만들거나 기존 IP 주소를 업데이트하려면 다음 안내를 따르세요.

gcloud

gcloud bms networks update 명령어를 실행하여 IP 주소 예약을 관리합니다.

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region REGION --add-ip-range-reservation=start-address=START_ADDRESS,end-address=END_ADDRESS,note="NOTE"

모든 IP 주소 예약을 삭제하려면 --clear-ip-range-reservations 옵션을 추가합니다.
예약된 주소 블록 중 하나를 삭제하려면 --remove-ip-range-reservation 옵션을 추가하고 삭제하려는 예약된 IP 주소 블록의 시작 주소와 종료 주소를 지정합니다.

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region REGION --remove-ip-range-reservation=start-address=START_ADDRESS,end-address=END_ADDRESS

API

새 IP 주소 예약을 만들거나 기존 IP 주소 예약을 업데이트하려면 다음 명령어에 프로젝트 ID, 리전, 네트워크 이름을 입력합니다. 예약하려는 각 IP 주소 블록에 대해 시작 주소, 종료 주소, 메모를 추가한 후 curl 명령어를 실행합니다.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME?updateMask=reservations"
 -d "{
  'reservations' : [
    {
      'startAddress' : 'START_ADDRESS_1',
      'endAddress' : 'END_ADDRESS_1',
      'note' : 'NOTES_1'
    },
    {
      'startAddress' : 'START_ADDRESS_2',
      'endAddress' : 'END_ADDRESS_2',
      'note' : 'NOTES_2'
    }
  ]
}"

IP 주소 예약 블록은 대상 네트워크의 CIDR 범위 내에 있어야 합니다.
예약 블록에 .1(게이트웨이 IP 주소)을 사용하지 마세요.
이 curl 명령어를 실행할 때마다 이전 예약 세트를 덮어씁니다. 업데이트해야 하는 경우 명령어를 실행하기 전에 모든 예약 블록 세트를 포함해야 합니다.
모든 예약을 삭제하려면 명령어의 끝을 다음으로 바꿉니다.
```
-d "{
'reservations' : []
}"
```

저장소 관리

다음 방법으로 베어메탈 솔루션 환경에서 스토리지를 관리할 수 있습니다.

베어메탈 솔루션 환경에서 스토리지 보기

베어메탈 솔루션 환경의 스토리지 리소스에 주의하면 서버에 애플리케이션과 워크로드를 위한 충분한 스토리지 용량이 있는지 확인하는 데 도움이 됩니다. 스토리지 상태를 보려면 다음 옵션 중 하나를 선택합니다.

콘솔

Google Cloud 콘솔에서 Compute Engine > 베어메탈 솔루션 > 볼륨으로 이동합니다.

제공되는 정보를 확인합니다.

필드	설명	예시
상태	스토리지 볼륨의 가용성을 나타냅니다.	체크표시가 있는 녹색 원은 스토리지 볼륨이 준비되었음을 나타냅니다.
ID	스토리지 볼륨에 할당된 식별자입니다. LUN 및 스냅샷을 포함하여 스토리지 볼륨에 대한 기본 정보를 보려면 ID를 클릭합니다. 이 리소스의 문제를 해결할 때 Google Cloud 지원팀에 ID를 공유하세요.	부팅 볼륨: `at-1234567-svr001-vol000-b1` Fibre 채널 볼륨: `at-1111111-vol001` NFS 공유: `at-2222222-nfs001-vol000`
이름	스토리지 볼륨 이름입니다. 이름을 클릭하여 LUN 및 스냅샷을 포함하여 스토리지 볼륨에 대한 추가 정보를 확인합니다. 참고: 스토리지 볼륨을 프로비저닝할 때 이름을 입력하지 않으면 이 필드에 ID가 표시됩니다.	부팅 볼륨: `boot-volume-1` Fibre 채널 볼륨: `fibre-channel-volume-5` NFS 공유: `nfs-share-7`
위치	스토리지 볼륨이 위치한 리전	`asia-southeast1`
유형	하드 드라이브 또는 솔리드 스테이트 드라이브	`HDD - Hard drive`
라벨	이 스토리지 리소스에 추가한 라벨이 표시됩니다. 라벨의 텍스트를 복사하여 상태 필드 바로 위에 있는 필터 상자에 붙여넣으면 라벨을 사용하여 콘솔 출력을 필터링할 수 있습니다.	`environment:test`

gcloud

베어메탈 솔루션 환경의 모든 스토리지 볼륨을 보고 해당 상태를 확인하려면 프로젝트 ID를 입력하고 gcloud bms volumes list 명령어를 실행합니다.

gcloud bms volumes list --project=PROJECT_ID

다음 출력 예시는 세 가지 스토리지 볼륨, 즉 프로젝트 ID, 리전, 볼륨 크기, 스토리지 유형을 보여줍니다.

NAME                         PROJECT              REGION           REQUESTED_SIZE_GIB  STORAGE_TYPE  STATE
at-1234567-svr001-vol000-b1  PROJECT_ID         REGION         200                 SSD           READY
at-1111111-vol001            PROJECT_ID         REGION         1024                SSD           READY
at-2222222-nfs001-vol000     PROJECT_ID         REGION         400                 HDD           READY

단일 스토리지 볼륨을 보려면 스토리지 볼륨 이름, 프로젝트 ID, 리전을 입력하고 gcloud bms volumes describe 명령어를 실행합니다.

gcloud bms volumes describe VOLUME_NAME --project=PROJECT_ID --region=REGION

다음 출력 예시에서는 스토리지 볼륨 크기, 이름, 스냅샷 자동 삭제 정책, 상태, 스토리지 유형을 보여줍니다.

currentSizeGib: '250'
name: projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME
requestedSizeGib: '250'
snapshotAutoDeleteBehavior: OLDEST_FIRST
snapshotReservationDetail:
  reservedSpaceGib: '50'
  reservedSpaceRemainingGib: '50'
state: READY
storageType: SSD

스토리지 볼륨의 모든 LUN을 보려면 프로젝트 ID, 리전, 스토리지 볼륨 이름을 입력하고 gcloud bms volumes luns list 명령어를 실행합니다.
```
gcloud bms volumes luns list --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME
```
다음 출력 예시는 LUN, 리전, 스토리지 볼륨 이름, 볼륨 크기, 상태의 이름을 보여줍니다.
```
NAME                         REGION           VOLUME       SIZE_GB  STATE
at-11111111-vol001-lun000    REGION        VOLUME_NAME 200      READY
```

단일 LUN의 세부정보를 보려면 프로젝트 ID, 리전, LUN 이름을 입력하고 gcloud bms volumes luns describe 명령어를 실행합니다.

gcloud bms volumes luns describe LUN_NAME --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME

다음 출력 예시는 LUN 이름과 크기, 상태, 스토리지 유형, 이름, ID와 같은 스토리지 볼륨 정보를 보여줍니다.

bootLun: true
name: projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns/LUN_NAME
sizeGb: '200'
state: READY
storageType: SSD
storageVolume: VOLUME_NAME
wwid: 600a09803831434434244f774d616b94

API

Google Cloud 콘솔에서 Cloud Shell 터미널 창을 엽니다.
베어메탈 솔루션 환경의 모든 스토리지 볼륨과 그 상태를 확인하려면 curl curl 명령어에 프로젝트 ID와 리전을 입력하고 해당 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣은 후 Enter 또는 Return 키를 누릅니다.
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes"
```
참고: 볼륨 업데이트가 진행 중이면 상태 필드가 생성 중으로 표시됩니다. 볼륨 업데이트가 완료되면 상태 필드가 준비로 표시됩니다.

단일 스토리지 볼륨을 보려면 프로젝트 ID, 리전, 스토리지 볼륨 이름을 입력하고 다음 명령어를 실행합니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME"

스토리지 볼륨의 모든 논리 단위 번호(LUN)를 보려면 프로젝트 ID, 리전, 스토리지 볼륨 이름을 입력한 후 다음 명령어를 실행합니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns

단일 LUN의 세부정보를 보려면 프로젝트 ID, 리전, 스토리지 볼륨 이름, LUN 이름을 입력하고 다음 명령어를 실행합니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns/LUN_NAME"

라벨을 사용하여 스토리지 볼륨 정리

라벨을 사용하여 스토리지 볼륨을 정리할 수 있습니다. 라벨은 각 스토리지 볼륨에 연결할 수 있는 키-값 쌍으로, 해당 라벨을 기준으로 스토리지 볼륨을 필터링할 수 있습니다. 예를 들어 라벨을 사용하여 용도, 환경, 위치, 부서 등을 기준으로 스토리지 볼륨을 그룹화할 수 있습니다. 라벨은 선택사항입니다.

스토리지 볼륨 라벨 추가 또는 업데이트

기존 스토리지 볼륨의 라벨을 추가하거나 업데이트할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 볼륨 페이지로 이동합니다.
라벨을 지정할 스토리지 볼륨에서 을 클릭합니다.
라벨 수정을 클릭합니다.
라벨 편집기 페이지에서 다음을 수행합니다.
1. 라벨 추가를 클릭하고 키-값 쌍을 추가합니다.
2. 라벨을 업데이트하려면 기존 라벨을 선택하고 값을 수정합니다.
3. 제출을 클릭합니다.
볼륨 페이지로 돌아와서 페이지를 새로고침하여 변경사항을 확인합니다.

gcloud

스토리지 볼륨의 라벨을 추가하거나 업데이트하려면 --update-labels 옵션과 함께 gcloud bms volumes update 명령어를 사용합니다.

다음 샘플 명령어는 environment = dev 및 location = branch 라벨을 추가합니다.

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

API

스토리지 볼륨의 라벨을 추가하거나 업데이트하려면 다음 curl 명령어에 프로젝트 ID, 리전, 볼륨 이름, 라벨 목록을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

다음 샘플 명령어는 environment = test의 라벨을 할당합니다.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

스토리지 볼륨에서 라벨 삭제

스토리지 볼륨에서 라벨을 삭제할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 볼륨 페이지로 이동합니다.
라벨을 삭제할 스토리지 볼륨의 경우 을 클릭합니다.
라벨 수정을 클릭합니다.
라벨 편집기 페이지에서 다음을 수행합니다.
1. 라벨을 삭제하려면 을 클릭합니다.
2. 제출을 클릭합니다.
볼륨 페이지로 돌아와서 페이지를 새로고침하여 변경사항을 확인합니다.

gcloud

스토리지 볼륨에서 라벨을 제거하려면 gcloud bms volumes update 옵션과 함께 다음 명령어를 사용합니다.

--remove-labels: 지정된 라벨을 삭제합니다.
--clear-labels: 모든 라벨을 삭제합니다.

다음 샘플 명령어는 스토리지 볼륨에서 department 라벨을 삭제합니다.

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

다음 샘플 명령어는 스토리지 볼륨에서 모든 라벨을 삭제합니다.

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

스토리지 볼륨에서 라벨을 삭제하려면 다음 curl 명령어에 프로젝트 ID, 리전, 스토리지 볼륨 이름을 입력합니다. 비어 있는 라벨 목록을 제공하여 모든 라벨을 삭제하거나 유지하려는 라벨 목록을 제공합니다(삭제하려는 라벨은 생략). 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

다음 샘플 명령어는 environment = test를 제외한 모든 라벨을 삭제합니다.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

라벨을 사용하여 스토리지 볼륨 필터링

라벨을 사용하여 스토리지 볼륨을 검색하고 결과를 필터링할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 볼륨 페이지로 이동합니다.
스토리지 볼륨 목록 위에 있는 필터 표시줄을 클릭합니다.
속성 목록에서 라벨을 선택합니다.
라벨의 키, 값 또는 키-값 쌍을 입력합니다.

예를 들어 env:dev 라벨이 있는 스토리지 볼륨만 보려면 다음 중 하나를 입력하면 됩니다.
- env 키를 입력합니다.
- dev 값을 입력합니다.
- env:dev 키-값 쌍을 입력합니다.
라벨 필터를 적용하려면 필터 표시줄 외부의 아무 곳을 클릭합니다.

gcloud

라벨을 사용하여 스토리지 볼륨을 필터링하려면 --filter 옵션과 함께 gcloud bms volumes list 명령어를 사용합니다.

--filter 옵션의 값은 labels.KEY=VALUE 형식이어야 합니다. 예를 들어 env 키 및 dev 값으로 라벨을 필터링하려면 다음 명령어를 실행합니다.

gcloud bms volumes list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

gcloud CLI의 필터 구문에 대한 상세 설명은 gcloud topic filters 문서를 참조하세요.

API

라벨을 사용하여 스토리지 볼륨을 필터링하려면 filter=labels 및 키-값 쌍 라벨과 함께 프로젝트 ID 및 리전을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

다음 샘플 명령어는 키-값 쌍 라벨이 environment = test인 스토리지 볼륨을 찾도록 출력을 제한합니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes"?filter=labels.environment=test

베어메탈 솔루션 환경의 스토리지 볼륨 리소스 프로비저닝

베어메탈 솔루션 환경의 스토리지 리소스를 주문한 후 리소스를 사용할 수 있게 되면 리소스를 프로비저닝할 수 있습니다. 다음 셀프서비스 옵션을 프로비저닝할 수 있습니다.

새 Fibre 채널 스토리지 볼륨 만들기
볼륨에 LUN 만들기
새로 만든 LUN을 선택하여 서버에 연결

새 스토리지 볼륨 만들기

새 스토리지 볼륨을 만들려면 다음 안내를 따르세요.

콘솔

Google Cloud 콘솔에서 Compute Engine > 베어메탈 솔루션 > 볼륨 메뉴로 이동합니다.
만들기를 클릭합니다.

다음 정보를 입력합니다.

필드	설명	예시
리전	베어메탈 솔루션 환경에 가장 가까운 Google Cloud 리전입니다.	`us-central1`
이름	스토리지 볼륨의 이름을 만듭니다.	`volume-1`
유형	스토리지 유형을 선택합니다. SSD – 솔리드 스테이트 드라이브 HDD – 하드 드라이브	`SSD`
크기	드라이브 크기(GiB)를 선택합니다. 1024GiB는 1TiB입니다. 크기는 최소 100GiB부터 최대 16TiB까지입니다. 16TiB보다 더 필요하면 그에 맞게 추가 볼륨을 만듭니다.	`16384`
스냅샷 사용 설정됨	스토리지 볼륨의 백업 복사본을 하루 한 번 저장합니다. 커스텀 스냅샷에 필요하며, 기본적으로 사용 중지됩니다. 참고: 스냅샷을 사용 설정하면 Google Cloud가 요청된 스토리지 볼륨 크기의 20%를 예약합니다. 예를 들어 볼륨 크기가 1TiB(1024GiB)이면 데이터 스토리지에 819GiB를 사용하고 스냅샷에 205GiB를 사용할 수 있습니다.	스냅샷 사용 설정을 위해 체크박스 선택
구성	필요한 LUN 구성 유형을 선택합니다. 기본 구성 – 동일한 크기의 LUN을 만듭니다(권장). 커스텀 구성 – 다양한 크기의 LUN을 만듭니다.	`Default configuration`
대상 서버	서버를 선택하고 스토리지 볼륨을 연결합니다.	`server-1`

만들기를 클릭합니다.
콘솔은 요청된 스토리지 볼륨에 사용 가능한 공간이 충분한지 확인합니다. 콘솔은 사용 가능한 공간이 있는 경우 변경사항을 구현하거나 작업을 수행할 수 없는 경우 알림을 제공합니다. 스토리지 볼륨 요청이 성공하면 추가 스토리지에 대한 청구가 자동으로 시작됩니다.
스토리지 볼륨을 프로비저닝하면 추가 서버와 공유할 수 있습니다.

참고: 스토리지 볼륨의 기존 LUN을 확장할 수 없습니다. 대신 새 스토리지 볼륨에 새 LUN을 만들고 이전 LUN을 새 스토리지 볼륨으로 마이그레이션한 후 이전 LUN을 사용 중지합니다.

스토리지 볼륨의 LUN 만들기

스토리지 볼륨의 LUN을 만들려면 다음 안내를 따르세요.

콘솔

Google Cloud 콘솔에서 Compute Engine > 베어메탈 솔루션 > 볼륨 메뉴로 이동합니다.
LUN 섹션 옆에 있는 만들기를 클릭합니다.

다음 정보를 입력합니다.

필드	설명	예시
LUN 수	특정 크기로 만들려는 총 LUN 수입니다.	`4`
크기	LUN 크기(GiB)를 선택합니다. 1024GiB는 1TiB입니다.	`1024`

LUN을 두 세트 이상 만들어야 하는 경우 항목 추가를 클릭합니다.
만들기를 클릭하여 새 LUN을 배포합니다.

참고: 기존 스토리지 볼륨에 새 LUN을 추가할 때는 새 LUN을 서비스할 수 있도록 LUN을 다시 검색해야 합니다. 자세한 내용은 스토리지 선택사항을 참조하세요.

서버에 스토리지 볼륨 연결

기존 스토리지 볼륨을 기존 서버에 연결하려면 다음 안내를 따르세요.

콘솔

Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
스토리지 볼륨이 필요한 서버의 이름을 클릭합니다.
LUN 섹션 옆에 있는 볼륨 연결을 클릭합니다.
메뉴에서 스토리지 볼륨을 선택하고 연결을 클릭합니다.
동일한 스토리지 볼륨을 다른 서버에 연결하려면 서버 세부정보 페이지로 돌아가서 이 절차를 반복합니다.

베어메탈 솔루션 환경에서 스토리지 볼륨 리소스 삭제

특정 스토리지 볼륨 리소스가 더 이상 필요하지 않으면 삭제할 수 있습니다. 다음 순서로 스토리지 리소스를 삭제해야 합니다.

서버에서 스토리지 볼륨 분리
스토리지 볼륨에서 LUN 삭제
스토리지 볼륨 삭제

서버에서 스토리지 볼륨 분리

서버에서 스토리지 볼륨을 분리하려면 다음 안내를 따르세요.

콘솔

Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동한 후 스토리지 볼륨이 연결된 서버를 클릭합니다.
LUN 섹션으로 아래로 스크롤하고 볼륨 분리를 클릭합니다.
대상 볼륨 목록에서 분리할 스토리지 볼륨을 선택합니다.
(선택사항) 기본적으로 스토리지 볼륨을 분리하면 서버가 재부팅합니다. 서버를 재부팅하지 않으려면 서버 재부팅 건너뛰기 체크박스를 선택합니다.

주의: 스토리지 볼륨을 분리하기 전에 모든 서버에서 마운트 해제하지 않으면 데이터가 손상되고 다음 재부팅 시 서버에 문제가 발생할 수 있습니다. 이를 방지하려면 변경사항과 일치하도록 호스트 구성을 업데이트하세요.
볼륨 분리를 클릭합니다.

4단계에서 서버 재부팅 건너뛰기 옵션을 선택하지 않은 경우 서버가 재부팅되고 서버에서 스토리지 볼륨과 LUN이 삭제됩니다.

스토리지 볼륨에서 LUN 삭제

스토리지 볼륨에서 LUN을 삭제하려면 다음 안내를 따르세요.

콘솔

Compute Engine > 베어메탈 솔루션 > 볼륨 페이지로 이동합니다.
삭제할 LUN이 포함된 스토리지 볼륨의 이름을 클릭합니다.
LUN 섹션에서 삭제할 LUN의 체크박스를 선택하고 삭제를 클릭합니다.
참고:
- LUN이 여전히 서버에 연결되어 있으면 삭제할 수 없습니다. 먼저 LUN을 서버에서 분리한 다음 LUN을 삭제합니다.
- LUN을 실수로 삭제하지 않도록 Google Cloud는 LUN을 삭제한 후 기본적으로 7일의 대기 기간을 제공합니다. 이 기간 동안에는 삭제된 LUN의 저장공간을 다시 사용할 수 없습니다. 드물지만 LUN 대기 기간을 단축해야 하는 경우 Cloud Customer Care에 문의하세요.

스토리지 볼륨 삭제

스토리지 볼륨을 삭제하려면 다음 안내를 따르세요.

콘솔

Compute Engine > 베어메탈 솔루션 > 볼륨 페이지로 이동합니다.
삭제할 스토리지 볼륨의 체크박스를 선택하고 삭제를 클릭합니다.

참고: 연결된 LUN이 여전히 포함되어 있으면 스토리지 볼륨을 삭제할 수 없습니다. LUN을 먼저 삭제한 뒤 스토리지 볼륨을 삭제합니다.

부팅 볼륨 스냅샷 관리

부팅 볼륨 스냅샷은 다음 방법으로 관리할 수 있습니다.

부팅 볼륨 스냅샷 및 세부정보 보기

부팅 볼륨의 스냅샷 목록 및 다음을 포함한 세부정보를 볼 수 있습니다.

ID
이름
설명
생성 시간
연결된 볼륨
유형

콘솔

Compute Engine > 베어메탈 솔루션 > 볼륨 페이지로 이동합니다.
볼륨 이름을 클릭합니다.
볼륨 세부정보 페이지의 스냅샷 섹션에서 스냅샷 목록과 세부정보를 볼 수 있습니다.

gcloud

부팅 볼륨의 모든 스냅샷을 나열하려면 gcloud bms volumes snapshots list 명령어를 실행합니다.

gcloud bms volumes snapshots list --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME

특정 부팅 볼륨 스냅샷의 세부정보를 보려면 gcloud bms volumes snapshots describe 명령어를 실행합니다.

gcloud bms volumes snapshots describe --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME --snapshot-name=SNAPSHOT_NAME

API

모든 부팅 볼륨 스냅샷을 나열하려면 다음 curl 명령어에 프로젝트 ID, 리전, 볼륨 이름을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots"

부팅 볼륨 스냅샷의 세부정보를 보려면 다음 curl 명령어에 프로젝트 ID, 리전, 볼륨 이름, 스냅샷 이름을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME"

부팅 볼륨 스냅샷 만들기

부팅 볼륨의 스냅샷을 만들 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 볼륨 페이지로 이동합니다.
볼륨 이름을 클릭합니다.
볼륨 세부정보 페이지의 스냅샷 섹션에서 만들기를 클릭합니다.
새 볼륨 스냅샷 만들기 페이지에서 다음을 수행합니다.
1. 스냅샷의 고유한 이름을 이름 필드에 입력합니다.
2. 스냅샷의 설명 필드에 설명을 입력합니다.
만들기를 클릭합니다.

gcloud

부팅 볼륨 스냅샷을 만들려면 gcloud bms volumes snapshot 명령어를 실행합니다.

gcloud bms volumes snapshot --project=PROJECT_ID --region=REGION VOLUME_NAME --snapshot-name=SNAPSHOT_NAME --description=DESCRIPTION

API

부팅 볼륨 스냅샷을 만들려면 다음 curl 명령어에 프로젝트 ID, 리전, 볼륨 이름, 스냅샷 이름, 스냅샷 설명을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots"
 -d \
'{\''name\'':
\''projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME\'', \''description\'': \''DESCRIPTION\''}' \

부팅 볼륨 스냅샷 삭제

부팅 볼륨 스냅샷을 삭제할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 볼륨 페이지로 이동합니다.
볼륨 이름을 클릭합니다.
볼륨 세부정보 페이지의 스냅샷 섹션에서 삭제할 스냅샷을 선택합니다.
Delete(삭제)를 클릭합니다.
메시지가 나타나면 확인을 클릭합니다.

gcloud

부팅 볼륨 스냅샷을 삭제하려면 gcloud bms volumes snapshots delete 명령어를 실행합니다.

gcloud bms volumes snapshots delete --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME SNAPSHOT_NAME

메시지가 표시되면 'Y'를 입력하고 Enter 또는 Return 키를 누릅니다.

API

부팅 볼륨 스냅샷을 삭제하려면 다음 curl 명령어에 프로젝트 ID, 리전, 볼륨 이름, 스냅샷 이름을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME"

부팅 볼륨 스냅샷 복원

스냅샷에서 부팅 볼륨을 복원할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
복원할 볼륨에 연결된 서버를 중지합니다. 베어메탈 솔루션 서버 운영을 참조하세요.

종료가 완료될 때까지 기다린 후에 다음 단계로 이동합니다.
Compute Engine > 베어메탈 솔루션 > 볼륨 페이지로 이동합니다.
복원하려는 볼륨의 볼륨 이름을 클릭합니다.
볼륨 세부정보 페이지에서 다음을 수행합니다.
1. 복원할 스냅샷에서 을 클릭합니다.
2. 복원을 클릭합니다.
3. 메시지가 나타나면 확인을 클릭합니다.

gcloud

부팅 볼륨 스냅샷을 복원하려면 gcloud bms volumes restore 명령어를 실행합니다.

gcloud bms volumes restore --project=PROJECT_ID --region=REGION VOLUME_NAME --snapshot-name=SNAPSHOT_NAME

API

부팅 볼륨 스냅샷을 복원하려면 다음 curl 명령어에 프로젝트 ID, 리전, 볼륨 이름, 스냅샷 이름을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
-H "Content-Length:0" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME:restoreVolumeSnapshot"

부팅 볼륨 복원을 완료하는 데 다소 시간이 걸리므로 장기 실행 작업 상태 보기의 단계에 따라 상태를 확인할 수 있습니다.

NFS 파일 스토리지 관리

다음 방법으로 NFS 파일 스토리지를 관리할 수 있습니다.

베어메탈 솔루션 환경에서 NFS 파일 스토리지 보기

베어메탈 솔루션용 NFS를 주문하고 프로비저닝한 후 NFS 파일 스토리지의 상태를 조회하여 구성된 설정을 Google Cloud에서 예상대로 구현했는지 확인할 수 있습니다. 현재 상태를 보려면 다음 명령어 옵션 중 하나를 선택합니다.

콘솔

Google Cloud 콘솔에서 Compute Engine > 베어메탈 솔루션 > NFS 공유로 이동합니다.

제공되는 정보를 확인합니다.

필드	설명	예시
상태	NFS 볼륨의 가용성을 나타냅니다.	체크표시가 있는 녹색 원은 NFS 볼륨이 프로비저닝되었음을 나타냅니다.
ID	볼륨을 호스팅하는 NFS 스토리지 기기에 할당된 식별자입니다. 허용된 클라이언트 및 NFS 속성을 포함하여 스토리지 볼륨에 대한 추가 정보를 보려면 ID를 클릭합니다. 이 리소스의 문제를 해결할 때 Google Cloud 지원팀에 ID를 공유하세요.	`at-2222222-nfs001`
이름	볼륨을 호스팅하는 NFS 스토리지 기기의 이름입니다. 허용된 클라이언트 및 NFS 속성을 포함하여 스토리지 볼륨에 대한 추가 정보를 보려면 이름을 클릭합니다. 참고: NFS 스토리지 기기를 프로비저닝할 때 이름을 입력하지 않은 경우 이 필드에 ID가 표시됩니다.	`nfs-share-7`
위치	NFS 스토리지 볼륨의 리전	`asia-southeast1`
볼륨	NFS 스토리지 볼륨의 이름입니다. 스냅샷과 같은 NFS 스토리지 볼륨에 대한 추가 정보를 보려면 이름을 클릭합니다.	`at-2222222-nfs001-vol000`
라벨	이 NFS 파일 스토리지 리소스에 추가한 라벨이 표시됩니다. 라벨의 텍스트를 복사하여 상태 필드 바로 위에 있는 필터 상자에 붙여넣으면 라벨을 사용하여 콘솔 출력을 필터링할 수 있습니다.	`environment:test`

gcloud

베어메탈 솔루션 환경 내에 있는 NFS 파일 스토리지의 상태를 보려면 gcloud bms nfs-shares list 명령어를 실행합니다.
```
gcloud bms nfs-shares list --project=PROJECT_ID --region=REGION
```
추가 명령어 옵션은 다음과 같습니다.
- --limit: 특정 기기 수를 표시하도록 출력을 제한합니다.
- --filter: 특정 라벨 또는 기타 필터 매개변수가 있는 기기를 표시하도록 출력을 제한합니다.
출력에서 이름, ID, 볼륨, 허용된 클라이언트를 포함한 NFS 파일 스토리지에 대한 세부정보를 제공합니다.
```
NAME: nfs-share-7
ID: at-2222222-nfs001
PROJECT: PROJECT_ID
REGION: REGION
VOLUME_NAME: at-2222222-nfs001-vol000
STATE: PROVISIONED
ALLOWED_CLIENTS: [{"allowedCidr": "192.168.1.1/32", "networkName": "at-1111111-vlan001", "shareIp": "192.168.1.240"}]
```

특정 NFS 파일 스토리지 기기의 상태를 보려면 gcloud bms nfs-shares describe 명령어를 실행합니다. NFS 공유 이름 또는 ID를 NFS_SHARE 변수로 사용할 수 있습니다.

gcloud bms nfs-shares describe NFS_SHARE --project=PROJECT_ID --region=REGION

출력에는 허용된 클라이언트, NFS 설정, NFS 서버 및 상태, 스토리지 볼륨에 대한 세부정보를 제공됩니다.

allowedClients:
– allowDev: true
  allowedClientsCidr: 192.168.1.1/32
  mountPermissions: READ_WRITE
  network: projects/PROJECT_ID/locations/REGION/networks/at-1111111-vlan001
  noRootSquash: true
  shareIp: 192.168.1.240
name: projects/PROJECT_ID/locations/REGION/nfsShares/NFS_SHARE
nfsShareId: at-2222222-nfs001
state: PROVISIONED
volume: projects/PROJECT_ID/locations/REGION/volumes/at-2222222-nfs001-vol000

API

허용되는 클라이언트 및 NFS 속성을 포함하여 베어메탈 솔루션 환경 내에 있는 NFS 파일 스토리지의 상태를 보려면 다음 curl 명령어에 프로젝트 ID와 리전을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares"
```

특정 NFS 파일 스토리지 기기의 상태를 보려면 프로젝트 ID, 리전, NFS 서버 이름 또는 ID를 입력한 후 다음 명령어를 실행합니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_SHARE"

라벨을 사용하여 NFS 파일 스토리지 정리

라벨을 사용하면 NFS 파일 스토리지를 정리하는 데 도움이 됩니다. 라벨은 각 NFS 볼륨에 연결할 수 있는 키-값 쌍으로, 해당 라벨을 기준으로 NFS 볼륨을 필터링할 수 있습니다. 예를 들어 라벨을 사용하여 용도, 환경, 위치, 부서 등을 기준으로 NFS 볼륨을 그룹화할 수 있습니다. 라벨은 선택사항입니다.

NFS 볼륨 라벨 추가 또는 업데이트

기존 NFS 볼륨에 라벨을 추가하거나 업데이트할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > NFS 공유 페이지로 이동합니다.
라벨을 지정할 NFS 볼륨에 대해 을 클릭합니다.
라벨 수정을 클릭합니다.
라벨 편집기 페이지에서 다음을 수행합니다.
1. 라벨 추가를 클릭하고 키-값 쌍을 추가합니다.
2. 라벨을 업데이트하려면 기존 라벨을 선택하고 값을 수정합니다.
3. 제출을 클릭합니다.
NFS 공유 페이지로 돌아가면 페이지를 새로고침하여 변경사항을 확인합니다.

gcloud

NFS 볼륨의 라벨을 추가하거나 업데이트하려면 --update-labels 옵션과 함께 gcloud bms nfs-shares update 명령어를 사용합니다.

다음 샘플 명령어는 environment = dev 및 location = branch 라벨을 추가합니다.

gcloud bms nfs-shares update NFS_VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

API

NFS 볼륨의 라벨을 추가하거나 업데이트하려면 다음 curl 명령어에 프로젝트 ID, 리전, NFS 볼륨 이름, 라벨 목록을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

다음 샘플 명령어는 environment = test의 라벨을 할당합니다.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

NFS 볼륨에서 라벨 삭제

NFS 볼륨에서 라벨을 삭제할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > NFS 공유 페이지로 이동합니다.
라벨을 삭제할 NFS 볼륨에 대해 을 클릭합니다.
라벨 수정을 클릭합니다.
라벨 편집기 페이지에서 다음을 수행합니다.
1. 라벨을 삭제하려면 을 클릭합니다.
2. 제출을 클릭합니다.
NFS 공유 페이지로 돌아가면 페이지를 새로고침하여 변경사항을 확인합니다.

gcloud

NFS 볼륨에서 라벨을 제거하려면 다음 옵션과 함께 gcloud bms nfs-shares update 명령어를 사용합니다.

--remove-labels: 지정된 라벨을 삭제합니다.
--clear-labels: 모든 라벨을 삭제합니다.

다음 샘플 명령어는 NFS 볼륨에서 department 라벨을 삭제합니다.

gcloud bms nfs-shares update NFS_VOLUME_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

다음 샘플 명령어는 NFS 볼륨에서 모든 라벨을 삭제합니다.

gcloud bms nfs-shares update NFS_VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

NFS 볼륨에서 라벨을 삭제하려면 다음 curl 명령어에 프로젝트 ID, 리전, NFS 볼륨 이름을 입력합니다. 비어 있는 라벨 목록을 제공하여 모든 라벨을 삭제하거나 유지하려는 라벨 목록을 제공합니다(삭제하려는 라벨은 생략). 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

다음 샘플 명령어는 environment = test를 제외한 모든 라벨을 삭제합니다.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

라벨 또는 값 없이 curl 명령어를 실행하면 모든 라벨이 삭제됩니다.

'labels' : {
}

라벨에 새 값을 지정하여 curl 명령어를 실행하면 새 값이 이전 값을 덮어씁니다.

'labels' : {
     'user': 'production',
     'env': 'production',
     'purpose': 'shared_data_store'
}

라벨을 사용하여 NFS 볼륨 필터링

라벨을 사용하여 NFS 볼륨을 검색하고 결과를 필터링할 수 있습니다.

콘솔

Compute Engine > 베어메탈 솔루션 > NFS 공유 페이지로 이동합니다.
NFS 볼륨 목록 위에 있는 필터 표시줄을 클릭합니다.
속성 목록에서 라벨을 선택합니다.
라벨의 키, 값 또는 키-값 쌍을 입력합니다.

예를 들어 env:dev 라벨이 있는 NFS 볼륨만 보려면 다음 중 하나를 입력하면 됩니다.
- env 키를 입력합니다.
- dev 값을 입력합니다.
- env:dev 키-값 쌍을 입력합니다.
라벨 필터를 적용하려면 필터 표시줄 외부의 아무 곳을 클릭합니다.

gcloud

라벨을 사용하여 NFS 볼륨을 필터링하려면 --filter 옵션과 함께 gcloud bms nfs-shares list 명령어를 사용합니다.

--filter 옵션의 값은 labels.KEY=VALUE 형식이어야 합니다. 예를 들어 env 키 및 dev 값으로 라벨을 필터링하려면 다음 명령어를 실행합니다.

gcloud bms nfs-shares list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

gcloud CLI의 필터 구문에 대한 상세 설명은 gcloud topic filters 문서를 참조하세요.

API

라벨을 사용하여 NFS 볼륨을 필터링하려면 filter=labels 및 키-값 쌍 라벨과 함께 프로젝트 ID 및 리전을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

다음 샘플 명령어는 키-값 쌍 라벨이 environment = test인 NFS 볼륨을 찾도록 출력을 제한합니다.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares"?filter=labels.environment=test

NFS 볼륨 만들기

허용된 클라이언트가 하나 이상 있는 NFS 볼륨을 만들 수 있습니다.

gcloud

NFS 볼륨을 만들려면 gcloud bms nfs-shares create 명령어를 실행합니다. --allowed-client 옵션을 사용하여 허용된 클라이언트를 지정합니다. 허용된 클라이언트를 여러 개 지정하려면 --allowed-client 옵션을 반복합니다.

명령어를 실행하기 전에 다음 값을 입력합니다.

NFS_VOLUME_NAME: NFS 볼륨의 이름입니다.
REGION: NFS 볼륨의 리전입니다.
SIZE_GIB: NFS 볼륨 크기(GiB 단위)입니다.
STORAGE_TYPE: 기본 볼륨의 스토리지 유형입니다.
NETWORK_NAME: 허용할 네트워크의 이름입니다.
(선택사항) PROJECT_ID: 허용된 클라이언트 네트워크의 프로젝트 ID입니다. 프로젝트 ID를 제공하지 않으면 NFS 볼륨이 속한 프로젝트가 기본적으로 사용됩니다.
IP_ADDRESS_RANGE: NFS 볼륨에 액세스할 수 있는 IP 주소의 서브넷입니다. 이는 일반적으로 클라이언트 네트워크입니다.
MOUNT_PERMISSIONS: 허용된 클라이언트 네트워크에 대한 권한을 마운트합니다.
ALLOW_DEV: 기기 생성을 허용합니다(예/아니요).
ALLOW_SUID: SUID를 허용합니다(예/아니요).
ENABLE_ROOT_SQUASH: 루트 스쿼시를 사용 설정합니다(예/아니요).

gcloud bms nfs-shares create --project=PROJECT_ID --region=REGION NFS_VOLUME_NAME \
--size-gib=SIZE_GIB --storage-type=STORAGE_TYPE \
--allowed-client=network=NETWORK_NAME,\
network-project-id=PROJECT_ID,cidr=IP_ADDRESS_RANGE,\
mount-permissions=MOUNT_PERMISSIONS,allow-dev=ALLOW_DEV,allow-suid=ALLOW_SUID,\
enable-root-squash=ENABLE_ROOT_SQUASH \

API

NFS 볼륨을 만들려면 다음 curl 명령어에 변수 값을 입력합니다. allowedClients 목록을 사용하여 허용된 클라이언트를 지정할 수 있습니다.

명령어를 실행하기 전에 다음 값을 입력합니다.

NFS_VOLUME_NAME: NFS 볼륨의 이름입니다.
REGION: NFS 볼륨의 리전입니다.
SIZE_GIB: NFS 볼륨 크기(GiB 단위)입니다.
STORAGE_TYPE: 기본 볼륨의 스토리지 유형입니다.
NETWORK_NAME: 허용할 네트워크의 이름입니다.
(선택사항) PROJECT_ID: 허용된 클라이언트 네트워크의 프로젝트 ID입니다. 프로젝트 ID를 제공하지 않으면 NFS 볼륨이 속한 프로젝트가 기본적으로 사용됩니다.
IP_ADDRESS_RANGE: NFS 볼륨에 액세스할 수 있는 IP 주소의 서브넷입니다. 이는 일반적으로 클라이언트 네트워크입니다.
MOUNT_PERMISSIONS: 허용된 클라이언트 네트워크에 대한 권한을 마운트합니다.
ALLOW_DEV: 기기 생성을 허용합니다(예/아니요).
ALLOW_SUID: SUID를 허용합니다(예/아니요).
ENABLE_ROOT_SQUASH: 루트 스쿼시를 사용 설정합니다(예/아니요).

명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares"
 -d \
'{
  "name": "projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME",
  "labels": {
    "nfsKey1": "some_value",
    "key2": "another_value",
  },
  "requestedSizeGib": "SIZE_GIB",
  "storageType": "STORAGE_TYPE",
  "allowedClients": [
    {
      "network": "projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME",
      "allowedClientsCidr": "IP_ADDRESS_RANGE",
      "mountPermissions": "MOUNT_PERMISSIONS",
      "allowDev": ALLOW_DEV,
      "allowSuid": ALLOW_SUID,
      "noRootSquash": ENABLE_ROOT_SQUASH,
    }
  ],
}'

NFS 볼륨을 만드는 데 다소 시간이 걸리므로 장기 실행 작업 상태 보기의 단계에 따라 상태를 확인할 수 있습니다.

NFS 볼륨 업데이트

NFS 볼륨에 허용되는 클라이언트 목록 및 해당 속성을 업데이트할 수 있습니다.

gcloud

NFS 볼륨에 허용된 클라이언트 목록을 업데이트하려면 gcloud bms nfs-shares update 옵션과 함께 다음 옵션을 사용하면 됩니다.

--add-allowed-client: 허용된 클라이언트를 추가합니다. 여러 클라이언트를 허용하려면 이 옵션을 반복합니다.
--remove-allowed-client: 허용된 클라이언트를 삭제합니다. 이 옵션으로 NETWORK_NAME 및 IP_ADDRESS_RANGE의 값을 제공해야 합니다. 허용된 클라이언트를 여러 개 삭제하려면 이 옵션을 반복합니다.
--clear-allowed-client: 허용된 모든 클라이언트를 삭제합니다.

NFS 볼륨을 업데이트하려면 적절한 옵션과 함께 gcloud bms nfs-shares update 명령어를 실행합니다. 예를 들면 다음과 같습니다.

gcloud bms nfs-shares update --project=PROJECT_ID --region=REGION NFS_VOLUME_NAME --remove-allowed-client=network=NETWORK_NAME,network-project-id=PROJECT_ID,cidr=IP_ADDRESS_RANGE

허용된 클라이언트의 속성을 업데이트하려면 --remove-allowed-client 옵션을 사용하여 삭제한 후 --add-allowed-client 옵션을 사용하여 업데이트된 속성을 다시 추가합니다.

API

NFS 볼륨을 업데이트하려면 다음 curl 명령어에 변수 값을 입력합니다. 전체 변수 목록은 NFS 볼륨 만들기를 참조하세요. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME?updateMask=allowed_clients%2Clabels"
 -d \
'{
  "name": "projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME",
  "labels": {
    "newKey": "newVal",
  },
  "allowedClients": [
    {
      "network": "projects/PROJECT_ID/locations/REGION/networks/NFS_VOLUME_NAME",
      "allowedClientsCidr": "IP_ADDRESS_RANGE",
      "mountPermissions": "MOUNT_PERMISSIONS",
      "allowDev": ALLOW_DEV,
      "allowSuid": ALLOW_SUID,
      "noRootSquash": ENABLE_ROOT_SQUASH,
    }
  ],
}'

NFS 볼륨 업데이트를 완료하는 데 다소 시간이 걸리므로 장기 실행 작업 상태 보기의 단계에 따라 상태를 확인할 수 있습니다.

NFS 볼륨 삭제

NFS 볼륨을 삭제할 수 있습니다.

gcloud

NFS 볼륨을 삭제하려면 gcloud bms nfs-shares delete 명령어를 실행합니다.

gcloud bms nfs-shares delete --project=PROJECT_ID --region=REGION NFS_VOLUME_NAME

API

NFS 볼륨을 삭제하려면 다음 curl 명령어에 프로젝트 ID, 리전, NFS 볼륨 이름을 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME"

NFS 볼륨 삭제는 완료하는 데 다소 시간이 걸리므로 장기 실행 작업 상태 보기의 단계에 따라 상태를 확인할 수 있습니다.

장기 실행 작업 상태 보기

서버 재설정과 같은 일부 gcloud 또는 API 명령어는 완료하는 데 시간이 오래 걸릴 수 있습니다. 또한 장기 실행 작업을 생성하는 명령어는 작업 ID가 포함된 출력을 생성합니다. 작업 ID를 사용하여 장기 실행 작업의 상태를 확인할 수 있습니다.

출력의 name 필드에서 operations 디렉터리 뒤에 오는 작업 ID를 찾을 수 있습니다. 예를 들어 reset API 명령어의 다음 출력은 작업 ID를 eb0056e2-b6f6-4792-8255-59cd79d5c686으로 표시합니다.

{
"name": "projects/PROJECT_ID/locations/REGION/operations/eb0056e2-b6f6-4792-8255-59cd79d5c686",
"done": true
}

장기 실행 작업의 상태를 확인하려면 다음 옵션을 사용합니다.

gcloud

장기 실행 작업의 상태를 보려면 gcloud bms operations describe 명령어를 사용합니다.

gcloud bms operations describe --project=PROJECT_ID --region=REGION OPERATION_ID

API

Google Cloud 콘솔에서 Cloud Shell 터미널 창을 엽니다.
베어메탈 솔루션 환경에서 장기 실행 작업 상태를 보려면 다음 curl 명령어에 프로젝트 ID, 리전, 작업 ID를 입력합니다. 명령어를 복사하여 Cloud Shell 프롬프트에 붙여넣고 Enter 또는 Return 키를 누릅니다.
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID"
```
작업이 완료되면 출력에서 done 필드가 true로 표시됩니다.
```
{
  "name": "operations/OPERATION_ID",
  "done": true
}
```