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

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

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

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

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

  2. Cloud 프로젝트에서 베어메탈 솔루션 API를 사용 설정합니다.

    Console

    1. Google Cloud Console 대시보드에서 베어메탈 솔루션 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
       

  3. 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 시작하기를 참조하세요.

베어메탈 솔루션 서버 운영

다시 시작 및 전원 켜기와 같이 서버에서 수행할 수 있는 여러 작업이 있습니다. 서버에서 다음 명령어를 사용합니다.

gcloud

  1. 베어메탈 솔루션 서버 전원을 끄고 다시 시작하려면 다음 단계를 따르세요.

    1. 반드시 API 설정 단계를 따라야 합니다.

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

    2. 베어메탈 솔루션 서버의 전원을 끄고 다시 시작하려면 gcloud bms instances reset 명령어를 실행합니다.

      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를 사용하여 재시작 상태를 확인하려면 장기 실행 작업 상태 보기를 참조하세요.

  2. 서버의 전원을 켜려면 gcloud bms instances start 명령어를 사용합니다.

    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.

    대부분의 경우 서버 전원이 켜진 상태로 유지됩니다. 전원을 꺼야 하는 경우 다음 옵션을 사용하세요.

    • 서버 운영체제의 종료 명령어를 사용합니다.
    • 일부 애플리케이션은 이미지 재처리 후 서버 전원을 자동으로 끕니다.

API

  1. 베어메탈 솔루션 서버 전원을 끄고 다시 시작하려면 다음 단계를 따르세요.

    1. 반드시 API 설정 단계를 따라야 합니다.

      서버를 다시 시작하려면 베어메탈 솔루션 API와 gcloud CLI를 사용 설정해야 합니다. 또한 베어메탈 솔루션 관리자 또는 베어메탈 솔루션 편집자 IAM 역할을 부여해야 합니다. 설정 단계를 완료하려면 베어메탈 솔루션 API를 사용하도록 Google Cloud 프로젝트 설정을 참조하세요.

    2. 베어메탈 솔루션 서버에 로그인하여 서버 재시작을 확인합니다.

      • Cloud Console 창을 엽니다.
      • 점프 호스트 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"
        
      • Cloud Shell 창에 명령어를 복사하여 붙여넣고 Enter 또는 Return 키를 누릅니다.

        베어메탈 솔루션 서버가 다시 시작합니다. 서버 구성에 따라 다시 시작하는 데 15~60분 정도 걸립니다.

        이 명령어의 출력은 재시작 상태를 확인하는 데 사용할 수 있는 작업 ID를 제공합니다. 작업 ID를 사용하여 상태를 확인하려면 장기 실행 작업 상태 보기를 참조하세요.

        {
         "name": "operations/5c0c8b3f-5edc-4117-be9f-812af9740aaf"
        }
        

        서버가 재부팅되는 동안 점프 호스트 VM 인스턴스에서 핑 또는 SSH를 사용하여 베어메탈 솔루션 서버에 연결할 수 없습니다. 몇 분 후면 베어메탈 솔루션 서버가 다시 온라인 상태가 됩니다.

        서버가 온라인 상태가 되면 호스트 VM 인스턴스에서 핑을 실행하거나 SSH를 사용하여 베어메탈 솔루션 서버에 연결할 수 있습니다.

    베어메탈 솔루션 서버 다시 시작에 대한 자세한 내용은 베어메탈 솔루션 API를 참조하세요.

  2. 서버의 전원을 켜려면 프로젝트 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"
    

    대부분의 경우 서버 전원이 켜진 상태로 유지됩니다. 전원을 꺼야 하는 경우 다음 옵션을 사용하세요.

    • 서버 운영체제의 종료 명령어를 사용합니다.
    • 일부 애플리케이션은 이미지 재처리 후 서버 전원을 자동으로 끕니다.

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

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

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

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

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

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

Console

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

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

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

    필드 설명 예시
    상태 서버의 가용성을 나타냅니다. 체크표시가 있는 녹색 원은 서버가 프로비저닝되었으며 사용 가능한 상태임을 나타냅니다.
    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
  3. 서버와 서버의 네트워킹 및 스토리지 기능에 대한 추가 정보를 보려면 서버의 이름을 클릭합니다.

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

gcloud

  1. 베어메탈 솔루션 환경의 서버를 나열하고 상태를 확인하려면 프로젝트 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: 특정 기기 수를 표시하도록 출력을 제한합니다.
  2. 베어메탈 솔루션 환경에서 특정 서버에 대한 네트워크 및 스토리지 정보를 가져오려면 서버 이름, 프로젝트 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
    
  3. 서버 라벨을 추가, 업데이트, 삭제하려면 gcloud bms instances update 명령어를 실행합니다. 다음 옵션을 사용할 수 있습니다.

    • --update-labels: 리소스에 라벨을 추가하여 상태 명령어 출력을 필터링할 수 있습니다. environment = test와 같이 키-값 쌍으로 각 라벨을 추가해야 합니다.
    • --remove-labels: 특정 라벨 삭제
    • --clear-labels: 모든 라벨을 삭제합니다.

    다음은 environment = devlocation = branch 라벨을 추가하고 서버에서 department 라벨을 삭제하는 샘플 명령어입니다.

    gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch --remove-labels=department
    
    다음 명령어는 서버에서 모든 라벨을 삭제합니다.
    gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --clear-labels
    
    서버 라벨의 변경사항을 보려면 다음 명령어를 실행합니다.
    gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION
    
  4. 라벨을 사용하여 gcloud bms instances list 명령어의 출력을 필터링하려면 명령어 끝에 --filter labels.KEY=VALUE를 추가합니다. 다음 예시에서는 키-값 쌍 environment = dev로 라벨이 지정된 서버의 출력을 제한합니다.

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

API

  1. Google Cloud Console에서 Cloud Shell 터미널 창을 엽니다.

  2. 베어메탈 솔루션 환경에 서버를 나열하고 상태를 보려면 다음 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"
    
  3. 베어메탈 솔루션 환경에서 서버에 대한 네트워크 및 스토리지 정보를 가져오려면 다음 명령어를 실행합니다.

    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"
    
  4. 서버에 라벨을 추가하려면 다음 curl 명령어에 프로젝트 ID, 리전, 서버 이름을 입력합니다. 이 예시의 키-값 쌍은 environment = test라는 라벨을 할당합니다. 명령어를 복사하여 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/instances/SERVER_NAME?updateMask=labels"
     -d "{
      'labels' : {'environment': 'test'}
    }"
    
  5. 라벨을 사용하여 베어메탈 솔루션 서버의 GET curl 명령어 출력을 필터링하려면 프로젝트 ID와 리전을 입력한 후 명령어 끝에 ?filter=labels.KEY=VALUE를 추가합니다. 다음 예시에서는 키-값 쌍 라벨 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
    

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

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

Console

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

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

    필드 설명 예시
    상태 네트워크의 가용성을 나타냅니다. 체크표시가 있는 녹색 원은 네트워크가 프로비저닝되었으며 사용 가능한 상태임을 나타냅니다.
    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

  1. 베어메탈 솔루션 환경의 모든 네트워크를 보고 해당 상태를 확인하려면 프로젝트 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
    
  2. 단일 네트워크의 세부정보를 보려면 프로젝트 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
    
  3. 네트워크의 라벨을 추가, 업데이트, 삭제하려면 gcloud bms networks update 명령어를 실행합니다. 다음 옵션을 사용할 수 있습니다.

    • --update-labels: 리소스에 라벨을 추가하여 상태 명령어 출력을 필터링할 수 있습니다. environment = test와 같이 키-값 쌍으로 각 라벨을 추가해야 합니다.
    • --remove-labels: 특정 라벨 삭제
    • --clear-labels: 모든 라벨을 삭제합니다.

    다음은 environment = devlocation = downtown 라벨을 추가하고 네트워크에서 cost-center 라벨을 삭제하는 샘플 명령어입니다.

    gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=downtown --remove-labels=cost-center
    
    다음 명령어는 네트워크에서 모든 라벨을 삭제합니다.
    gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --clear-labels
    
    네트워크 라벨의 변경사항을 보려면 다음 명령어를 실행합니다.
    gcloud bms networks describe NETWORK_NAME --project=PROJECT_ID --region=REGION
    
  4. 라벨을 사용하여 gcloud bms networks list 명령어의 출력을 필터링하려면 명령어 끝에 --filter labels.KEY=VALUE를 추가합니다. 다음 예시에서는 키-값 쌍 environment = dev로 라벨이 지정된 네트워크의 출력을 제한합니다.

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

API

  1. Cloud Console에서 Cloud Shell 터미널 창을 엽니다.

  2. 베어메탈 솔루션 환경의 모든 네트워크를 보고 상태를 보려면 다음 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"
    
  3. 단일 네트워크의 세부정보를 보려면 프로젝트 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"
    
  4. 네트워크에 라벨을 추가하려면 프로젝트 ID, 리전, 네트워크 이름을 입력한 후 다음 curl 명령어를 실행합니다. 이 예시의 키-값 쌍은 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'}
    }"
    
  5. 라벨을 사용하여 베어메탈 솔루션 네트워크의 GET curl 명령어 출력을 필터링하려면 프로젝트 ID와 리전을 입력한 후 명령어 끝에 ?filter=labels.KEY=VALUE를 추가합니다. 다음 예시에서는 키-값 쌍 라벨 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
    

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

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

Console

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

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

    필드 설명 예시
    상태 스토리지 볼륨의 가용성을 나타냅니다. 체크표시가 있는 녹색 원은 스토리지 볼륨이 준비되었음을 나타냅니다.
    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

  1. 베어메탈 솔루션 환경의 모든 스토리지 볼륨을 보고 해당 상태를 확인하려면 프로젝트 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
    
  2. 단일 스토리지 볼륨을 보려면 스토리지 볼륨 이름, 프로젝트 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
    
  3. 스토리지 볼륨의 라벨을 추가, 업데이트, 삭제하려면 gcloud bms volumes update 명령어를 실행합니다. 다음 옵션을 사용할 수 있습니다.

    • --update-labels: 리소스에 라벨을 추가하여 상태 명령어 출력을 필터링할 수 있습니다. environment = production과 같이 키-값 쌍으로 각 라벨을 추가해야 합니다.
    • --remove-labels: 특정 라벨 삭제
    • --clear-labels: 모든 라벨을 삭제합니다.

    다음은 environment = productionlocation = hq 라벨을 추가하고 스토리지 볼륨에서 rack 라벨을 삭제하는 샘플 명령어입니다.

    gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=production,location=hq --remove-labels=rack
    
    다음 명령어는 스토리지 볼륨에서 모든 라벨을 삭제합니다.
    gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels
    
    스토리지 볼륨 라벨의 변경사항을 보려면 다음 명령어를 실행합니다.
    gcloud bms volumes describe VOLUME_NAME --project=PROJECT_ID --region=REGION
    
  4. 라벨을 사용하여 gcloud bms volumes list 명령어의 출력을 필터링하려면 명령어 끝에 --filter labels.KEY=VALUE를 추가합니다. 다음 예시에서는 키-값 쌍 environment = production으로 라벨이 지정된 스토리지 볼륨의 출력을 제한합니다.

    gcloud bms volumes list --project=PROJECT_ID --region=REGION --filter labels.environment=production
    
  5. 스토리지 볼륨의 모든 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
    
  6. 단일 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

  1. Cloud Console에서 Cloud Shell 터미널 창을 엽니다.

  2. 베어메탈 솔루션 환경의 모든 스토리지 볼륨과 그 상태를 확인하려면 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"
    
  3. 단일 스토리지 볼륨을 보려면 프로젝트 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"
    
  4. 스토리지 볼륨의 모든 논리 단위 번호(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
    
  5. 단일 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"
    
  6. 스토리지 볼륨에 라벨을 추가하려면 프로젝트 ID, 리전, 스토리지 볼륨 이름을 입력한 후 다음 curl 명령어를 실행합니다. 이 예시의 키-값 쌍은 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'}
    }"
    
  7. 라벨을 사용하여 베어메탈 솔루션 네트워크의 GET curl 명령어 출력을 필터링하려면 프로젝트 ID와 리전을 입력한 후 명령어 끝에 ?filter=labels.KEY=VALUE를 추가합니다. 다음 예시에서는 키-값 쌍 라벨 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
    

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

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

Console

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

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

    필드 설명 예시
    상태 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

  1. 베어메탈 솔루션 환경 내에 있는 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"}]
    

  2. 특정 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
    
  3. NFS 파일 스토리지의 라벨을 추가, 업데이트, 삭제하려면 gcloud bms nfs-shares update 명령어를 실행합니다. 다음 옵션을 사용할 수 있습니다.

    • --update-labels: 리소스에 라벨을 추가하여 상태 명령어 출력을 필터링할 수 있습니다. environment = test와 같이 키-값 쌍으로 각 라벨을 추가해야 합니다.
    • --remove-labels: 특정 라벨 삭제
    • --clear-labels: 모든 라벨을 삭제합니다.

    다음은 environment = testlocation = downtown 라벨을 추가하고 NFS 파일 스토리지 기기에서 cost-center 라벨을 삭제하는 샘플 명령어입니다.

    gcloud bms nfs-shares update NFS_SHARE --project=PROJECT_ID --region=REGION --update-labels environment=test,location=downtown --remove-labels=cost-center
    
    다음 명령어는 NFS 파일 스토리지 기기에서 모든 라벨을 삭제합니다.
    gcloud bms nfs-shares update NFS_SHARE --project=PROJECT_ID --region=REGION --clear-labels
    

    NFS 파일 스토리지 라벨의 변경사항을 보려면 다음 명령어를 실행합니다.

    gcloud bms nfs-shares describe NFS_SHARE --project=PROJECT_ID --region=REGION
    
  4. 라벨을 사용하여 gcloud bms nfs-shares list 명령어의 출력을 필터링하려면 명령어 끝에 --filter labels.KEY=VALUE를 추가합니다. 다음 예시에서는 키-값 쌍 environment = test로 라벨이 지정된 NFS 파일 스토리지 기기의 출력을 제한합니다.

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

API

  1. 허용되는 클라이언트 및 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"
    
  2. 특정 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"
    
  3. NFS 파일 스토리지 기기에 라벨을 추가하려면 다음 curl 명령어에 프로젝트 ID, 리전, NFS 서버 이름 또는 ID를 입력합니다. 이 예시에서 키-값 쌍은 라벨 3개(user = test, env = staging, purpose = new_hardware_cert)를 할당합니다. 명령어를 복사하여 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_SHARE?updateMask=labels"
     -d "{
      'labels' : {
         'user': 'test',
         'env': 'staging',
         'purpose': 'new_hardware_cert'
       }
    }"
    
    • 라벨 또는 값 없이 curl 명령어를 실행하면 모든 라벨이 삭제됩니다.
      'labels' : {
       }
      
    • 라벨에 새 값을 지정하여 curl 명령어를 실행하면 새 값이 이전 값을 덮어씁니다.
      'labels' : {
           'user': 'production',
           'env': 'production',
           'purpose': 'shared_data_store'
       }
      
  4. 라벨을 사용하여 베어메탈 솔루션 NFS 파일 스토리지 기기에 대한 GET curl 명령어의 출력을 필터링하려면 프로젝트 ID 및 리전을 입력한 후 명령어 끝에 ?filter=labels.KEY=VALUE를 추가합니다. 다음 예시에서는 키-값 쌍 라벨 env = staging이 있는 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.env=staging
    

장기 실행 작업 상태 보기

서버 재설정과 같은 일부 'gcloud' 명령어 또는 API 호출은 완료되는 데 시간이 오래 걸릴 수 있습니다. 장기 실행 작업의 상태를 확인하려면 다음 명령어 옵션을 사용합니다.

gcloud

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

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

API

  1. Cloud Console에서 Cloud Shell 터미널 창을 엽니다.

  2. 베어메탈 솔루션 환경에서 장기 실행 작업 상태를 보려면 다음 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/v1/operations/OPERATION_ID"
    
    작업이 완료되면 출력에서 done 필드가 true로 표시됩니다.
    {
      "name": "operations/OPERATION_ID",
      "done": true
    }