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

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

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

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

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

베어메탈 솔루션 관리자 또는 베어메탈 솔루션 편집자 사전 정의된 IAM 역할을 주 구성원에 할당합니다. IAM 역할을 매핑하는 방법을 알아보려면 IAM 역할 부여를 참조하세요.
Google 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가 Google Cloud 프로젝트에서 작동하도록 허용합니다.
1. Cloud Shell 창에서 gcloud auth login 명령어를 입력합니다.
```
gcloud auth login
```
2. 생성된 URL을 복사하여 별도의 브라우저 탭 또는 창에 붙여넣습니다.
3. Google 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 창을 엽니다.
  - Google Cloud 프로젝트 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"

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

서버 상태 확인

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

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

PROVISIONING: 서버에 리소스가 할당됩니다. 서버가 아직 실행 중이 아닙니다.
STARTING: 리소스가 확보되었습니다. 서버를 부팅하는 중입니다.

부팅 작업은 일반적으로 30분이 소요되며 그 이후에는 서버 상태가 RUNNING로 설정됩니다.
RUNNING: 서버가 작동되어 실행 중입니다.

서버 상태가 RUNNING이지만 서버를 사용할 수 없는 경우 계속 부팅 중일 수 있습니다. 이는 서버가 크거나 스토리지 볼륨 및 LUN이 많은 경우에 발생할 수 있습니다. 자세한 내용은 서버를 부팅하는 데 시간이 오래 걸림을 참조하세요.
STOPPING: 서버를 중지하는 중입니다.
SHUTDOWN: 서버가 중지되고 전원이 꺼집니다.
DELETED: 서버가 삭제되었습니다.

콘솔

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 프로젝트 설정을 참조하세요.

조직 및 폴더의 베어메탈 솔루션 리소스 나열

경우에 따라 조직 수준 또는 폴더 수준에서 베어메탈 솔루션 리소스를 확인해야 할 수 있습니다. 조직 또는 폴더 수준에서 리소스를 나열하려면 해당 수준에서 리소스를 나열할 수 있는 IAM 권한이 필요합니다.

사용자에게 IAM 권한을 부여하는 방법은 IAM으로 조직 리소스에 대한 액세스 제어를 참조하세요.

다음은 조직 또는 폴더의 스토리지 볼륨을 나열하는 샘플 Python 스크립트입니다. 요구사항에 따라 이 샘플 스크립트를 수정하여 사용할 수 있습니다. 예를 들어 attached=false와 같은 필터를 사용하여 연결되지 않은 모든 스토리지 볼륨을 나열할 수 있습니다.

이 스크립트를 사용하여 조직 수준의 스토리지 볼륨을 나열하려면 조직 수준에서 다음 IAM 권한이 필요합니다.

resourcemanager.folders.get
resourcemanager.folders.list
resourcemanager.organizations.get
resourcemanager.projects.get
resourcemanager.projects.list
baremetalsolution.volumes.list
baremetalsolution.luns.list


#!/usr/bin/env python

# Copyright 2022 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# This file is automatically generated. Please do not modify it directly.
# Find the relevant recipe file in the samples/recipes or samples/ingredients
# directory and apply your changes there.

from typing import Sequence
from typing import Tuple
from absl import app
from absl import flags
from google.api_core.exceptions import PermissionDenied
from google.cloud import resourcemanager_v3
from google.cloud.bare_metal_solution_v2.services.bare_metal_solution import BareMetalSolutionClient
from google.cloud.bare_metal_solution_v2.types import ListVolumesRequest

_ORGANIZATION_ID = flags.DEFINE_string(
    "organization-id",
    None,
    "Your organization id retrieved from its name:"
    " organizations/<organization-id>.",
)
_FOLDER_ID = flags.DEFINE_string(
    "folder-id",
    None,
    "Your folder id retrieved from its name: folders/<folder-id>.",
)
_FILTER = flags.DEFINE_string(
    "filter",
    "",
    "Filter for the resource list request. Syntax should be per"
    " https://google.aip.dev/160",
)

def get_projects(
    parent: str,
    folders_client: resourcemanager_v3.FoldersClient,
    projects_client: resourcemanager_v3.ProjectsClient,
) -> str:
  """Retrieves a list of all project IDs available in given organization or folder parent.

  Args:
      parent: Organization ID or Folder ID of the Cloud org or folder you want
        to recursively list project IDs from.
      folders_client: Resource manager folder API client.
      projects_client: Resource manager project API client.

  Yields:
      The list of project ids as a string.
  """
  projects_request = resourcemanager_v3.ListProjectsRequest(parent=parent)
  for project in projects_client.list_projects(request=projects_request):
    yield project.project_id

  folders_request = resourcemanager_v3.ListFoldersRequest(parent=parent)
  for folder in folders_client.list_folders(request=folders_request):
    get_projects(folder.name, folders_client, projects_client)

def get_volumes_list(parent: str, filter: str) -> Tuple[str, str]:
  """Retrieves a list of all volume names available in given project.

  Args:
      parent: Organization ID or Folder ID of the Cloud org or folder you want
        to recursively list volumes from.
      filter: Filter string for the resource list call. Syntax is per
        https://google.aip.dev/160.

  Returns:
      The list of volumes as a string and the list of PermissionDenied errors in
      individual folder or projects, if any.
  """
  folders_client = resourcemanager_v3.FoldersClient()
  projects_client = resourcemanager_v3.ProjectsClient()
  bms_client = BareMetalSolutionClient()
  output = []
  errors = []

  try:
    for project in get_projects(parent, folders_client, projects_client):
      volumes_list_request = ListVolumesRequest(
          parent="projects/" + project + "/locations/global",
          filter=filter,
      )
      try:
        for volume in bms_client.list_volumes(request=volumes_list_request):
          output.append(f" -  {volume.name}")
      # This could happen because BMS API is not enabled in a certain project.
      except PermissionDenied as e:
        errors.append(
            f"Unable to list bms resources for project {project}: {e}"
        )
  except PermissionDenied as e:
    errors.append(f"Unable to access folder or project: {e}")
  return "\n".join(output), "\n".join(errors)

def main(_: Sequence[str]):
  if _ORGANIZATION_ID.value is not None and _FOLDER_ID.value is not None:
    raise Exception("Only one of organization ID or folder ID must be provided")
  elif _ORGANIZATION_ID.value is None and _FOLDER_ID.value is None:
    raise Exception(
        "Either one of organization ID or folder ID must be provided"
    )
  elif _ORGANIZATION_ID.value is not None:
    parent = f"organizations/{_ORGANIZATION_ID.value}"
  else:
    parent = f"folders/{_FOLDER_ID.value}"
  volumes, errors = get_volumes_list(parent, filter=_FILTER.value)
  print(
      "=================== Flat list of volumes in the folder or organization"
      " ==================="
  )
  print(volumes)

  print(
      "=================== List of folders or projects with errors"
      " ==================="
  )
  print(errors)

if __name__ == "__main__":
  app.run(main)

서버 관리

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

서버 보기

베어메탈 솔루션 서버의 세부정보를 보려면 다음 단계를 따르세요.

콘솔

서버 페이지로 이동합니다.

서버로 이동

서버 페이지에는 모든 서버가 다음 세부정보와 함께 나열됩니다.

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

서버에 대한 추가 세부정보를 보려면 서버의 이름을 클릭하세요.

서버 세부정보 페이지에는 다음과 같은 추가 세부정보가 표시됩니다.

필드	설명
하이퍼스레딩	하이퍼스레딩이 서버에서 사용 설정되었는지 여부를 나타냅니다.
OS 이미지	서버에서 실행되는 OS입니다.
펌웨어 버전	서버의 현재 펌웨어 버전입니다.
네트워크 템플릿	서버에서 사용하고 있는 네트워크 템플릿입니다.
SSH 키	서버의 SSH 키입니다(구성한 경우).
비밀번호 암호화 키	서버의 암호화 키입니다(구성한 경우).
로그인 정보	로그인 비밀번호를 가져오는 절차입니다.
사용자 계정	사용자 이름과 해당 암호화된 비밀번호입니다.
네트워크	서버에 연결된 네트워크의 세부정보입니다.
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

서버 이름 변경

서버 이름을 바꾸려면 다음 단계를 따르세요.

콘솔

Google Cloud 콘솔에서 Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
서버 이름을 클릭합니다.
서버 세부정보 페이지의 이름 필드에서 이름 수정을 클릭합니다.
이름 수정 페이지에서 새 이름을 입력합니다.
저장을 클릭합니다.
변경사항을 보려면 페이지를 새로고침합니다.

gcloud

서버 이름을 바꾸려면 gcloud bms instances rename 명령어를 사용합니다.

gcloud bms instances rename SERVER_NAME --new-name=NEW_NAME --project=PROJECT_ID --region=REGION

다음을 바꿉니다.

SERVER_NAME: 서버의 현재 이름입니다.
NEW_NAME: 서버의 새 이름입니다.
PROJECT_ID: 프로젝트 ID입니다.
REGION: 서버의 위치입니다.

서버의 초기 비밀번호 검색

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

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

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)의 세부정보를 보려면 gcloud bms os-images describe 명령어를 실행하여 OS 세부정보를 확인합니다.

gcloud bms os-images describe OS_IMAGE --project=PROJECT_ID

다음을 바꿉니다.

OS_IMAGE: OS 이미지 코드. OS의 OS 이미지 코드를 가져오려면 운영체제를 참조하세요.
PROJECT_ID: 프로젝트 ID

예:

gcloud bms os-images describe OEL8x --project=test-project

다음은 샘플 출력입니다.

applicableInstanceTypes:
- o2-highmem-224-metal
- o2-standard-112-metal
- o2-standard-16-metal
- o2-standard-32-metal
- o2-standard-48-metal
code: OEL8x
description: Oracle Linux 8.8 [5.4.17-2136.324.5.3.el8uek.x86_64]
name: projects/bmaas-testing/locations/global/osImages/OEL8x
supportedNetworkTemplates:
- s200-bondaa-bondaa
- s400-bondaa-bondaa

서버 OS 변경

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

콘솔

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

Compute Engine > 베어메탈 솔루션 > 서버로 이동합니다.
이미지를 재설치하려는 서버에서 메뉴를 클릭합니다.
수정을 클릭합니다.
서버 수정 페이지에서 다음을 수행합니다.
- 서버 재이미지 체크박스를 선택합니다.
- OS 이미지 목록에서 설치하려는 OS 이미지를 선택합니다.
- (선택사항) 서버 비밀번호의 암호화 키를 설정합니다.
  
  미리보기
  
  이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.
  - 비밀번호 암호화 키 목록에서 키를 선택합니다.
  - 버전 목록에서 암호화 키 버전을 선택합니다.
  베어메탈 솔루션에서 암호화 키를 사용하는 방법에 대한 자세한 내용은 서버 암호화 키 설정을 참조하세요.
- (선택사항) 서버 SSH 키를 설정하거나 변경합니다.
  
  미리보기
  
  이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.
  - SSH 키 목록에서 키를 선택합니다. 이 목록에는 서버와 동일한 프로젝트에 있는 SSH 키만 표시됩니다.
  서버의 기존 SSH 키를 변경하려면 변경하려는 키를 선택 해제하고 새 키를 선택합니다.
  
  베어메탈 솔루션에서 SSH 키를 사용하는 방법에 대한 자세한 내용은 서버 SSH 키 설정을 참조하세요.
- 저장을 클릭합니다.

gcloud

gcloud bms instances update 명령어를 실행하여 서버의 OS 이미지를 변경합니다. OS 이미지 코드는 운영체제를 참조하세요.

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

SSH 키, 암호화 키 또는 둘 다를 설정하려면 gcloud alpha bms instances update 명령어를 사용합니다. 키를 이름이나 전체 리소스로 지정할 수 있습니다.

gcloud alpha bms instances update SERVER_NAME --region REGION --os-image=OS_IMAGE --kms-crypto-key-version=KMS_CRYPTO_KEY_VERSION --ssh-keys=KEY_1,KEY_2

예:

gcloud alpha bms instances update server1 --region europe-west3 --os-image=OS_IMAGE --kms-crypto-key-version=projects/bmaas-testing/locations/global/keyRings/e2e-test/cryptoKeys/e2e-test-key/cryptoKeyVersions/1 --ssh-keys=e2e-test-key-1,e2e-test-key-2

API

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

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'
}"

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

VRF 관리

베어메탈 솔루션 환경의 각 클라이언트 네트워크는 VRF에 연결되어 Google Cloud의 VPC 네트워크와의 상호 연결을 사용 설정합니다. 그러면 각 VRF는 VLAN 연결 쌍을 갖습니다.

다음 방법으로 베어메탈 솔루션 환경에서 VRF 및 VLAN 연결을 관리할 수 있습니다.

VRF 보기
VRF 만들기
VRF 삭제
VLAN 연결 쌍 추가
VLAN 연결 쌍 업데이트
VLAN 연결 쌍 삭제

VRF 보기

VRF의 세부정보를 보려면 다음 단계를 따르세요.

VRF 페이지로 이동합니다.

VRF로 이동

VRF 페이지에는 모든 VRF가 다음 세부정보와 함께 나열됩니다.

필드	설명
상태	VRF의 가용성을 나타냅니다.
이름	VRF의 이름입니다. VRF에 대한 추가 정보를 확인하려면 이름을 클릭합니다. 참고: VRF를 프로비저닝할 때 이름을 입력하지 않은 경우 이 필드에 ID가 표시됩니다.
ID	VRF에 할당된 식별자입니다. VRF에 대한 추가 정보를 확인하려면 ID를 클릭합니다. 이 리소스의 문제를 해결할 때 Google Cloud 지원팀에 ID를 공유하세요.
리전	VRF가 위치한 리전입니다.
포드	VRF가 포함된 포드입니다. 포드는 베어메탈 솔루션 리소스가 포함된 격리 단위입니다. 다른 포드의 리소스는 연결할 수 없습니다. 한 리전에 여러 포드가 있을 수 있습니다. 포드 열은 기본적으로 사용 중지되어 있습니다. 이를 사용 설정하려면 다음 단계를 따르세요. 열 표시 옵션을 클릭합니다. 포드 체크박스를 선택합니다. OK(확인)를 클릭합니다. 포드 열을 사용 설정하지 않으려면 VRF 이름 또는 ID를 클릭하여 VRF의 포드를 볼 수 있습니다.

VRF에 대한 추가 세부정보를 보려면 VRF의 이름 또는 ID를 클릭합니다.

VRF 세부정보 페이지에는 다음 추가 세부정보가 표시됩니다.

필드	설명
VLAN 연결 쌍	피어 IP, 라우터 IP, 대역폭 등의 VRF와 연결된 VLAN 연결 쌍의 세부정보입니다.
구성원 네트워크	VRF와 연결된 네트워크의 목록입니다. 네트워크를 클릭하면 네트워크의 세부정보를 볼 수 있습니다.

VRF 만들기

Google Cloud 콘솔 접수 양식을 통해 새 네트워크를 프로비저닝하면 VRF가 암시적으로 생성됩니다. VRF를 만들 수도 있습니다.

새 VRF를 만들려면 다음 단계를 따르세요.

VRF 페이지로 이동합니다.

VRF로 이동
만들기를 클릭합니다.
VRF의 이름을 입력합니다.
리전 목록에서 VRF의 리전을 선택합니다.
포드 목록에서 VRF의 포드를 선택합니다.

포드 드롭다운 목록에는 선택한 위치의 각 포드에 있는 기존 베어메탈 솔루션 리소스 수도 표시됩니다.

어떤 포드를 선택할지 확실하지 않으면 Google Cloud 영업팀에 문의하세요.
VLAN 연결 쌍을 추가합니다.

VRF를 만드는 동안에는 VLAN 연결 쌍을 하나만 추가할 수 있습니다. VLAN 연결 쌍 추가의 단계에 따라 VRF를 만든 후에 VLAN 연결 쌍을 더 추가할 수 있습니다.
1. VLAN 연결 쌍 추가를 클릭합니다.
2. 대역폭 목록에서 VLAN 연결에 할당할 대역폭 양을 선택합니다.
3. 현재 프로젝트에서 VLAN 연결을 추가하려면 다음 안내를 따르세요.
  1. 현재 프로젝트에서 VLAN 연결 선택 체크박스를 선택합니다.
  2. 첫 번째 VLAN 연결 목록에서 첫 번째 VLAN 연결을 선택합니다.
  3. 두 번째 VLAN 연결 목록에서 두 번째 VLAN 연결을 선택합니다.
4. 다른 프로젝트에서 VLAN 연결을 추가하려면 다음 안내를 따르세요.
  1. 현재 프로젝트에서 VLAN 연결 선택 체크박스를 선택 해제합니다.
  2. 첫 번째 VLAN 연결 ID 필드에 첫 번째 VLAN 연결의 ID를 입력합니다.
  3. 두 번째 VLAN 연결 ID 필드에 두 번째 VLAN 연결의 ID를 입력합니다.
5. 완료를 클릭합니다.
만들기를 클릭합니다.

VRF 삭제

VRF를 삭제하기 전에 모든 VLAN 연결 쌍과 연결된 네트워크를 삭제해야 합니다. VLAN 연결 쌍 삭제 및 네트워크 삭제를 참조하세요.

VRF를 삭제하려면 다음 단계를 따르세요.

VRF 페이지로 이동합니다.

VRF로 이동
삭제할 VRF를 선택합니다.
삭제를 클릭합니다.
확인을 클릭합니다.

VLAN 연결 관리

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

VLAN 연결 쌍 추가
VLAN 연결 쌍 업데이트
VLAN 연결 쌍 삭제

VLAN 연결 쌍 추가

VRF에는 여러 VLAN 연결 쌍이 있을 수 있습니다. 그러나 VLAN 연결은 하나의 VRF와만 페어링될 수 있습니다.

VRF 페이지로 이동합니다.

VRF로 이동
VRF 이름을 클릭합니다.
VRF 세부정보 페이지의 VLAN 연결 쌍 섹션에서 만들기를 클릭합니다.
새 VLAN 연결 쌍 페이지에서 다음을 수행합니다.
대역폭 목록에서 VLAN 연결에 할당할 대역폭 양을 선택합니다.
현재 프로젝트에서 VLAN 연결을 선택하려면 다음 안내를 따르세요.
1. 현재 프로젝트에서 VLAN 연결 선택 체크박스를 선택합니다.
2. 첫 번째 VLAN 연결 목록에서 첫 번째 VLAN 연결을 선택합니다.
3. 두 번째 VLAN 연결 목록에서 두 번째 VLAN 연결을 선택합니다.
다른 프로젝트의 VLAN 연결을 추가하려면 다음 안내를 따르세요.
1. 현재 프로젝트에서 VLAN 연결 선택 체크박스를 선택 해제합니다.
2. 첫 번째 VLAN 연결 ID 필드에서 첫 번째 VLAN 연결의 ID를 추가합니다.
3. 두 번째 VLAN 연결 ID 필드에서 두 번째 VLAN 연결의 ID를 추가합니다.
만들기를 클릭합니다.

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

VLAN 연결 쌍 업데이트

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

VRF 페이지로 이동합니다.

VRF로 이동
VRF 이름을 클릭합니다.
VRF 세부정보 페이지의 VLAN 연결 쌍 섹션에서 업데이트할 VLAN 연결 쌍을 선택합니다.
수정을 클릭합니다.
VLAN 연결 쌍 수정 페이지에서 다음을 수행합니다.
1. 대역폭 목록에서 VLAN 연결에 할당할 대역폭 양을 선택합니다.
2. 저장을 클릭합니다.

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

VLAN 연결 쌍 삭제

이 절차의 단계에 따라 VLAN 연결 쌍을 삭제하면 VLAN 연결 쌍은 VRF에서 연결 해제될 뿐 실제로 삭제되지는 않습니다.

VRF 페이지로 이동합니다.

VRF로 이동
VRF 이름을 클릭합니다.
VRF 세부정보 페이지의 VLAN 연결 쌍 섹션에서 삭제할 VLAN 연결 쌍을 선택합니다.
삭제를 클릭합니다.

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

네트워크 관리하기

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

네트워크 보기

베어메탈 솔루션 환경에서 네트워크 리소스를 모니터링하면 서버가 다른 리소스에 연결하는 방법을 알 수 있습니다.

네트워크 세부정보를 보려면 다음 단계를 따르세요.

콘솔

네트워크 페이지로 이동합니다.

네트워크로 이동

네트워크 페이지에는 다음 세부정보가 포함된 모든 네트워크가 나열됩니다.

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

네트워크의 추가 세부정보를 보려면 네트워크의 이름 또는 ID를 클릭합니다.

네트워크 세부정보 페이지에는 다음 추가 세부정보가 표시됩니다.

필드	설명
게이트웨이 IP	네트워크에 있는 게이트웨이의 IP 주소입니다.
서비스 IP 주소 범위	서버에서 실행 중인 OS입니다.
MTU	네트워크의 MTU입니다.
VRF	네트워크와 연결된 VRF입니다.
사용된 주소	네트워크로 연결된 서버의 IP 주소입니다.

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

네트워크 이름 바꾸기

네트워크 이름을 바꾸려면 다음 단계를 수행합니다.

콘솔

Google Cloud 콘솔에서 Compute Engine > 베어메탈 솔루션 > 네트워크 페이지로 이동합니다.
네트워크 이름을 클릭합니다.
네트워크 세부정보 페이지의 이름 필드에서 이름 수정을 클릭합니다.
이름 수정 페이지에서 새 이름을 입력합니다.
저장을 클릭합니다.
변경사항을 보려면 페이지를 새로고침합니다.

gcloud

네트워크 이름을 바꾸려면 gcloud bms networks rename 명령어를 사용합니다.

gcloud bms networks rename NETWORK_NAME --new-name=NEW_NAME --project=PROJECT_ID --region=REGION

다음을 바꿉니다.

NETWORK_NAME: 네트워크의 현재 이름입니다.
NEW_NAME: 네트워크의 새 이름입니다.
PROJECT_ID: 프로젝트 ID입니다.
REGION: 네트워크의 위치입니다.

네트워크 만들기

네트워크를 만들기 전에 VRF를 만들어야 합니다. VRF 만들기를 참조하세요.

네트워크를 만들려면 여기에 다음 단계를 따르세요.

네트워크 페이지로 이동합니다.

네트워크로 이동
만들기를 클릭합니다.
네트워크의 이름을 입력합니다.
위치 목록에서 네트워크의 리전을 선택합니다.
포드 목록에서 네트워크의 포드를 선택합니다.

포드 드롭다운 목록에는 선택한 위치의 각 포드에 있는 기존 베어메탈 솔루션 리소스 수도 표시됩니다.

어떤 포드를 선택할지 확실하지 않으면 Google Cloud 영업팀에 문의하세요.
네트워크 유형을 선택합니다.
1. 클라이언트 네트워크를 만들려면 클라이언트를 선택합니다.
2. 비공개 네트워크를 만들려면 비공개를 선택합니다.
(클라이언트 네트워크 유형을 선택한 경우에만 적용 가능) VRF 목록에서 VRF를 선택합니다.
네트워크 IP 주소 범위 필드에 네트워크의 IP 주소 범위를 입력합니다.
(선택사항) 서비스 IP 주소 범위 필드에 네트워크의 서비스 IP 주소 범위를 입력합니다.

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

서버에 네트워크 연결

네트워크의 IP 주소 범위가 서버에 연결된 다른 네트워크와 겹치는 경우 서버에 네트워크를 연결할 수 없습니다.

네트워크를 연결하려면 다음 단계를 따르세요.

네트워크 페이지로 이동합니다.

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

서버 상태가 '프로비저닝'으로 변경됩니다. 네트워크 연결은 장기 실행 작업입니다. 상태를 확인하려면 Google Cloud 콘솔에서 알림을 클릭합니다. 장기 실행 작업 상태 보기의 단계를 따를 수도 있습니다. 작업이 완료되면 서버 상태가 '실행 중'으로 변경됩니다.
베어메탈 솔루션 서버의 OS 구성을 업데이트합니다.

Google Cloud 콘솔을 통해 네트워크를 연결하기 위한 이전 단계를 완료하고 서버 상태가 '실행 중'으로 변경되면 베어메탈 솔루션 서버의 OS 구성을 업데이트해야 합니다. OS 구성을 업데이트하지 않으면 Google Cloud 콘솔에서 변경한 사항이 완전히 구현되지 않습니다. 이 절차의 다음 단계에서는 OS 구성을 업데이트하는 방법을 보여줍니다.

주의: OS 구성을 잘못 업데이트하면 네트워크 연결이 끊어질 수 있습니다. 확실하지 않은 경우 네트워크 관리자에게 문의하세요. OS 구성을 업데이트하기 전에 베어메탈 솔루션 서버에 대한 대화형 직렬 콘솔 액세스를 구성 및 테스트하는 것이 좋습니다. 이렇게 하면 연결이 끊겨도 업데이트를 계속할 수 있습니다. 이전 OS 구성을 복원하려는 경우 부팅 볼륨 스냅샷을 만드는 것이 좋습니다.

다음 단계는 예시일 뿐이며 OS에 따라 다를 수 있습니다. 문제가 발생하면 OS 설정 가이드를 참조하세요.
RHEL, Oracle Linux
1. 루트 사용자로 로그인합니다.
2. 새 연결을 만듭니다. 다음 명령어를 실행합니다.
  
  참고: 다음 명령어는 새 네트워크를 기본 게이트웨이로 지정하지 않습니다.
```
nmcli connection add type vlan con-name INTERFACE_NAME.VLAN_ID  ifname INTERFACE_NAME.VLAN_ID dev INTERFACE_NAME mtu MTU id VLAN_ID ip4 IP_ADDRESS/NETMASK ipv6.method "ignore"
```
  다음을 바꿉니다.
  - INTERFACE_NAME: 네트워크를 연결할 인터페이스의 이름입니다. 이 인터페이스는 이 절차의 6단계(인터페이스 구성 설정)에서 선택한 인터페이스와 동일합니다. 서버 세부정보 페이지의 네트워크 섹션에서 인터페이스 이름을 가져올 수 있습니다. 서버 보기를 참조하세요.
  - VLAN_ID: 연결하려는 네트워크의 VLAN ID입니다. 네트워크 세부정보 페이지에서 VLAN ID를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  - IP_ADDRESS: 네트워크에 있는 베어메탈 솔루션 서버의 IP 주소입니다. 이 절차의 6단계(인터페이스 구성 설정)에서 입력한 것과 동일한 IP 주소입니다. 서버 세부정보 페이지의 네트워크 섹션에서 IP 주소를 가져올 수 있습니다. 서버 보기를 참조하세요.
  - NETMASK: 연결하려는 네트워크의 네트워크 마스크입니다. 네트워크 세부정보 페이지의 CIDR 필드에서 네트워크 마스크를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  - MTU: 연결하려는 네트워크의 MTU입니다. 네트워크 세부정보 페이지에서 MTU를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  예:
```
nmcli connection add type vlan con-name bond0.114 ifname bond0.114 dev bond0 mtu 1500 id 114 ip4 172.16.80.1/24 ipv6.method "ignore"
```
3. (선택사항) 클라이언트 네트워크를 만들었고 이 네트워크를 사용하여 VPC에서 VLAN 연결 또는 다른 환경(예: 온프렘 환경)에 연결하려는 경우 특정 서브넷으로 연결되는 경로를 구성합니다. 루트 사용자로 다음 명령어를 실행합니다.
```
nmcli connection modify INTERFACE_NAME.VLAN_ID +ipv4.routes "SUBNET GATEWAY_IP"
```
```
nmcli connection up INTERFACE_NAME.VLAN_ID
```
  다음을 바꿉니다.
  - INTERFACE_NAME: 네트워크를 연결할 인터페이스의 이름입니다. 이 인터페이스는 이 절차의 6단계(인터페이스 구성 설정)에서 선택한 인터페이스와 동일합니다. 서버 세부정보 페이지의 네트워크 섹션에서 인터페이스 이름을 가져올 수 있습니다. 서버 보기를 참조하세요.
  - VLAN_ID: 연결하려는 네트워크의 VLAN ID입니다. 네트워크 세부정보 페이지에서 VLAN ID를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  - SUBNET: 클라이언트 네트워크를 통해 베어메탈 솔루션 서버에 연결하는 데 사용되는 CIDR 표기법으로 표시된 네트워크의 IP 주소 및 마스크입니다. VPC 네트워크인 경우 VPC 네트워크 페이지의 서브넷 섹션에서 서브넷을 가져올 수 있습니다. 서브넷 나열을 참조하세요. 다른 환경인 경우 네트워크 관리자에게 문의하세요.
  - GATEWAY_IP: 연결하려는 네트워크에 있는 게이트웨이의 IP 주소입니다. 네트워크 세부정보 페이지에서 게이트웨이 IP를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  예:
```
nmcli connection modify bond0.114 +ipv4.routes "192.168.122.0/24 172.16.80.254"

nmcli connection up bond0.114
```
4. (선택사항) 클라이언트 네트워크를 만들고 이 절차의 7단계(기본 게이트웨이)에서 기본 게이트웨이로 설정한 경우 다음 단계를 수행하여 OS 구성을 업데이트합니다.
  1. 이전 단계인 9.c 단계를 완료합니다.
  2. 새 클라이언트 네트워크를 통해 베어메탈 솔루션 서버에 연결되어 있는지 확인합니다. 예를 들어 이 네트워크가 VLAN 연결로 연결된 VPC의 VM에서 서버에 연결합니다.
  3. 이 네트워크를 기본 게이트웨이로 설정하려면 이전 네트워크에서 기본 게이트웨이 설정을 사용 중지한 다음 이 네트워크에서 기본 게이트웨이 설정을 사용 설정합니다. 루트 사용자로 다음 명령어를 실행합니다.
    
    nmcli connection modify OLD_INTERFACE_NAME.OLD_VLAN_ID ipv4.gateway ""
    
    nmcli connection modify INTERFACE_NAME.VLAN_ID ipv4.gateway GATEWAY_IP
    
    nmcli connection up INTERFACE_NAME.VLAN_ID
    
    nmcli connection up OLD_INTERFACE_NAME.OLD_VLAN_ID
    
    다음을 바꿉니다.
    
    OLD_INTERFACE_NAME: 이전 기본 게이트웨이 네트워크가 연결된 인터페이스의 이름입니다. 서버 세부정보 페이지의 네트워크 섹션에서 또는 베어메탈 솔루션 서버 OS 구성을 검사하여 인터페이스 이름을 가져올 수 있습니다. 즉, ip a 또는 nmcli connection show 명령어를 사용하는 것입니다.
    
    OLD_VLAN_ID: 이전 기본 게이트웨이 네트워크의 VLAN ID입니다. 네트워크 세부정보 페이지에서 VLAN ID를 가져올 수 있습니다. 네트워크 보기 또는 베어메탈 솔루션 서버 OS 구성을 검사하여, 즉 ip a 또는 nmcli connection show commands를 사용하여 확인합니다.
    
    INTERFACE_NAME: 새 네트워크가 연결된 인터페이스의 이름입니다. 이 인터페이스는 이 절차의 11단계(인터페이스 구성 설정)에서 선택한 인터페이스와 동일합니다. 서버 세부정보 페이지의 네트워크 섹션에서 인터페이스 이름을 가져올 수 있습니다. 서버 보기를 참조하세요.
    
    VLAN_ID: 새 네트워크의 VLAN ID입니다. 네트워크 세부정보 페이지에서 VLAN ID를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
    
    GATEWAY_IP: 새 네트워크에 있는 게이트웨이의 IP 주소입니다. 네트워크 세부정보 페이지에서 게이트웨이 IP를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
    
    예:
    
    nmcli connection modify bond0.143 ipv4.gateway "" nmcli connection modify bond0.114 ipv4.gateway 172.16.80.254 nmcli connection up bond0.114 nmcli connection up bond0.143
SLES
1. 루트 사용자로 로그인합니다.
2. 다음 이름 지정 규칙에 따라 /etc/sysconfig/network 위치에 인터페이스 구성(ifcfg) 파일을 만듭니다.
```
ifcfg-INTERFACE_NAME.VLAN_ID
```
  다음을 바꿉니다.
  - INTERFACE_NAME: 네트워크를 연결할 인터페이스의 이름입니다. 이 인터페이스는 이 절차의 6단계(인터페이스 구성 설정)에서 선택한 인터페이스와 동일합니다. 서버 세부정보 페이지의 네트워크 섹션에서 인터페이스 이름을 가져올 수 있습니다. 서버 보기를 참조하세요.
  - VLAN_ID: 연결하려는 네트워크의 VLAN ID입니다. 네트워크 세부정보 페이지에서 VLAN ID를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  완료되면 파일 경로는 다음과 같습니다.
```
/etc/sysconfig/network/ifcfg-INTERFACE_NAME.VLAN_ID
```
3. ifcfg 파일에 네트워크 인터페이스에 대한 다음 정보를 추가합니다.
```
NAME='INTERFACE_NAME.VLAN_ID'
ETHERDEVICE='INTERFACE_NAME'
STARTMODE='auto'
USERCONTROL='no'
BOOTPROTO='static'
IPADDR='IP_ADDRESS/NETMASK'
MTU=MTU
VLAN='yes'
```
  다음을 바꿉니다.
  - INTERFACE_NAME: 네트워크를 연결할 인터페이스의 이름입니다. 이 인터페이스는 이 절차의 6단계(인터페이스 구성 설정)에서 선택한 인터페이스와 동일합니다. 서버 세부정보 페이지의 네트워크 섹션에서 인터페이스 이름을 가져올 수 있습니다. 서버 보기를 참조하세요.
  - VLAN_ID: 연결하려는 네트워크의 VLAN ID입니다. 네트워크 세부정보 페이지에서 VLAN ID를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  - IP_ADDRESS: 네트워크에 있는 베어메탈 솔루션 서버의 IP 주소입니다. 이 절차의 6단계(인터페이스 구성 설정)에서 입력한 것과 동일한 IP 주소입니다. IP 주소는 네트워크 섹션의 서버 세부정보 페이지에서 확인할 수 있습니다.
  - NETMASK: 연결하려는 네트워크의 네트워크 마스크입니다. 네트워크 세부정보 페이지의 CIDR 필드에서 네트워크 마스크를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  - MTU: 연결하려는 네트워크의 MTU입니다. 네트워크 세부정보 페이지에서 MTU를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  예를 들어 샘플 파일 /etc/sysconfig/network/ifcfg-bond1.121은 다음과 같습니다.
```
 NAME='bond1.121'
 ETHERDEVICE='bond1'
 STARTMODE='auto'
 USERCONTROL='no'
 BOOTPROTO='static'
 IPADDR='192.168.200.10/24'
 MTU=1500
 VLAN='yes'
```
  1. 변경사항을 적용하기 위한 인터페이스를 표시합니다.
    
    ifup INTERFACE_NAME.VLAN_ID
    
    다음을 바꿉니다.
    
    INTERFACE_NAME: 네트워크를 연결할 인터페이스의 이름입니다. 이 인터페이스는 이 절차의 6단계(인터페이스 구성 설정)에서 선택한 인터페이스와 동일합니다. 서버 세부정보 페이지의 네트워크 섹션에서 인터페이스 이름을 가져올 수 있습니다. 서버 보기를 참조하세요.
    
    VLAN_ID: 연결하려는 네트워크의 VLAN ID입니다. 네트워크 세부정보 페이지에서 VLAN ID를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
4. (선택사항) 클라이언트 네트워크를 만들었고 이 네트워크를 사용하여 VPC에서 VLAN 연결 또는 다른 환경(예: 온프렘 환경)에 연결하려는 경우 특정 서브넷으로 연결되는 경로를 구성합니다.
  1. 다음 이름 지정 규칙에 따라 /etc/sysconfig/network 위치에 인터페이스 경로 구성(ifroute) 파일을 만듭니다.
    
    ifroute-INTERFACE_NAME.VLAN_ID
    
    완료되면 파일 경로가 다음과 같이 표시됩니다.
    
    /etc/sysconfig/network/ifroute-INTERFACE_NAME.VLAN_ID
  2. ifroute 파일에 네트워크 인터페이스에 대한 다음 정보를 추가합니다.
    
    SUBNET GATEWAY_IP - -
    
    다음을 바꿉니다.
    
    SUBNET: 클라이언트 네트워크를 통해 베어메탈 솔루션 서버에 연결하는 데 사용되는 CIDR 표기법으로 표시된 네트워크의 IP 주소 및 마스크입니다. VPC 네트워크인 경우 VPC 네트워크 페이지의 서브넷 섹션에서 서브넷을 가져올 수 있습니다. 서브넷 나열을 참조하세요. 다른 환경인 경우 네트워크 관리자에게 문의하세요.
    
    GATEWAY_IP: 연결하려는 네트워크에 있는 게이트웨이의 IP 주소입니다. 네트워크 세부정보 페이지에서 게이트웨이 IP를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  3. 변경사항을 적용하기 위한 인터페이스를 표시합니다.
    
    ifup INTERFACE_NAME.VLAN_ID
    
    다음을 바꿉니다.
    
    INTERFACE_NAME: 네트워크를 연결할 인터페이스의 이름입니다. 이 인터페이스는 이 절차의 6단계(인터페이스 구성 설정)에서 선택한 인터페이스와 동일합니다. 서버 세부정보 페이지의 네트워크 섹션에서 인터페이스 이름을 가져올 수 있습니다. 서버 보기를 참조하세요.
    
    VLAN_ID: 연결하려는 네트워크의 VLAN ID입니다. 네트워크 세부정보 페이지에서 VLAN ID를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
5. (선택사항) 클라이언트 네트워크를 만들고 이 절차의 7단계(기본 게이트웨이)에서 기본 게이트웨이로 설정한 경우 다음 단계를 수행하여 OS 구성을 업데이트합니다.
  1. 이전 단계인 9.c 단계를 완료합니다.
  2. 이 네트워크를 통해 베어메탈 솔루션 서버에 연결되어 있는지 확인합니다. 예를 들어 이 네트워크가 VLAN 연결을 통해 연결된 VPC의 VM에서 서버에 연결합니다.
  3. 이 네트워크를 기본 게이트웨이로 설정하려면 시스템 기본 경로 구성을 변경합니다.
    
    /etc/sysconfig/network/routes 파일을 수정하여 현재 기본 게이트웨이의 IP 주소를 새 기본 게이트웨이의 IP 주소로 바꿉니다.
    
    파일 콘텐츠를 다음과 같이 업데이트합니다.
    
    default GATEWAY_IP - -
    
    다음을 바꿉니다.
    
    GATEWAY_IP: 새 네트워크에 있는 게이트웨이의 IP 주소입니다. 네트워크 세부정보 페이지에서 게이트웨이 IP를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  4. 네트워크 구성을 새로고침하여 변경사항을 적용합니다.
    
    systemctl reload network

서버에서 네트워크 분리

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

네트워크를 분리하려면 다음 단계를 수행합니다.

베어메탈 솔루션 서버의 OS 구성을 업데이트합니다.

Google Cloud 콘솔을 통해 네트워크를 분리하기 전에 먼저 베어메탈 솔루션 서버의 OS 구성을 업데이트해야 합니다. OS 구성을 업데이트하지 않으면 Google Cloud 콘솔에서 변경한 사항이 완전히 구현되지 않습니다.

주의: OS 구성을 잘못 업데이트하면 네트워크 연결이 끊어질 수 있습니다. 확실하지 않은 경우 네트워크 관리자에게 문의하세요. OS 구성을 업데이트하기 전에 베어메탈 솔루션 서버에 대한 대화형 직렬 콘솔 액세스를 구성 및 테스트하는 것이 좋습니다. 변경 중에 연결이 끊어지는 경우에 유용합니다. 대화형 직렬 콘솔을 사용하여 계속 업데이트할 수 있습니다. 이전 OS 구성을 복원하려는 경우 부팅 볼륨 스냅샷을 만드는 것이 좋습니다.

이 단계의 작업은 예시일 뿐이며 OS에 따라 다를 수 있습니다. 문제가 발생하면 OS 설정 가이드를 참조하세요.
RHEL, Oracle Linux
1. 분리할 네트워크의 결합 인터페이스를 삭제합니다. 루트 사용자 권한으로 다음 명령어를 실행합니다.
```
nmcli connection delete INTERFACE_NAME.VLAN_ID
```
  다음을 바꿉니다.
  - INTERFACE_NAME: 분리할 네트워크의 인터페이스 이름입니다. 서버 세부정보 페이지의 네트워크 섹션에서 인터페이스 이름을 가져올 수 있습니다. 서버 보기를 참조하세요.
  - VLAN_ID: 분리할 네트워크의 VLAN ID입니다. 네트워크 세부정보 페이지에서 VLAN ID를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  예:
```
nmcli connection delete bond0.148
```
SLES
1. 인터페이스를 종료합니다. 루트 사용자 권한으로 다음 명령어를 실행합니다.
```
ifdown INTERFACE_NAME.VLAN_ID
```
  다음을 바꿉니다.
  - INTERFACE_NAME: 분리할 네트워크의 인터페이스 이름입니다. 서버 세부정보 페이지의 네트워크 섹션에서 인터페이스 이름을 가져올 수 있습니다. 서버 보기를 참조하세요.
  - VLAN_ID: 분리할 네트워크의 VLAN ID입니다. 네트워크 세부정보 페이지에서 VLAN ID를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  예:
```
ifdown bond1.121
```
2. 다음 부팅 시 처리되지 않도록 인터페이스 구성 파일의 정보를 다른 파일로 백업합니다. 다음 명령어를 실행합니다.
```
mv /etc/sysconfig/network/ifcfg-INTERFACE_NAME.VLAN_ID /etc/sysconfig/network/ifcfg-INTERFACE_NAME.VLAN_ID.backup
```
  다음을 바꿉니다.
  - INTERFACE_NAME: 분리할 네트워크의 인터페이스 이름입니다. 서버 세부정보 페이지의 네트워크 섹션에서 인터페이스 이름을 가져올 수 있습니다. 서버 보기를 참조하세요.
  - VLAN_ID: 분리할 네트워크의 VLAN ID입니다. 네트워크 세부정보 페이지에서 VLAN ID를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  예:
```
mv /etc/sysconfig/network/ifcfg-bond1.121 /etc/sysconfig/network/ifcfg-bond1.121.backup
```
3. (선택사항) 클라이언트 네트워크를 분리하고 이 네트워크에 맞게 경로를 구성한 경우. 다음 부팅 시 처리되지 않도록 인터페이스 경로 구성 파일의 정보를 다른 파일에 백업합니다. 다음 명령어를 실행합니다.
```
mv /etc/sysconfig/network/ifroute-INTERFACE_NAME.VLAN_ID /etc/sysconfig/network/ifroute-INTERFACE_NAME.VLAN_ID.backup
```
  다음을 바꿉니다.
  - INTERFACE_NAME: 분리할 네트워크의 인터페이스 이름입니다. 서버 세부정보 페이지의 네트워크 섹션에서 인터페이스 이름을 가져올 수 있습니다. 서버 보기를 참조하세요.
  - VLAN_ID: 분리할 네트워크의 VLAN ID입니다. 네트워크 세부정보 페이지에서 VLAN ID를 가져올 수 있습니다. 네트워크 보기를 참조하세요.
  예:
```
mv /etc/sysconfig/network/ifroute-bond1.121 /etc/sysconfig/network/ifroute-bond1.121.backup
```
Google Cloud 콘솔을 통해 네트워크를 분리합니다.
1. Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
2. 서버 이름을 클릭합니다.
3. 서버 세부정보 페이지에서 분리할 네트워크를 선택합니다.
4. 네트워크 분리를 클릭합니다.
5. 메시지가 나타나면 확인을 클릭합니다.

서버 상태가 '프로비저닝'으로 변경됩니다. 네트워크 분리는 장기 실행 작업입니다. 상태를 확인하려면 Google Cloud 콘솔에서 알림을 클릭합니다. 장기 실행 작업 상태 보기의 단계를 따를 수도 있습니다. 작업이 완료되면 서버 상태가 '실행 중'으로 변경됩니다.

네트워크 삭제

동일한 VRF에 연결된 여러 클라이언트 네트워크는 삭제할 수 없습니다. 이러한 경우 고객 지원에 문의하세요.

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

콘솔

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

네트워크 삭제는 장기 실행 작업입니다. 상태를 확인하려면 Google Cloud 콘솔에서 알림을 클릭합니다. 장기 실행 작업 상태 보기의 단계를 따를 수도 있습니다.

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

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

콘솔

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' : []
}"
```

스토리지 관리

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

스토리지 볼륨 보기

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

스토리지 볼륨의 세부정보를 보려면 다음 단계를 따르세요.

콘솔

볼륨 페이지로 이동합니다.

볼륨으로 이동

볼륨 페이지에는 다음 세부정보가 포함된 모든 스토리지 볼륨이 나열됩니다.

필드	설명	예시
상태	스토리지 볼륨의 가용성을 나타냅니다.	체크표시가 있는 녹색 원은 스토리지 볼륨이 준비되었음을 나타냅니다.
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`
포드	스토리지 볼륨이 포함된 포드. 포드는 베어메탈 솔루션 리소스가 포함된 격리 단위입니다. 다른 포드의 리소스는 연결할 수 없습니다. 한 리전에 여러 포드가 있을 수 있습니다. 포드 열은 기본적으로 사용 중지되어 있습니다. 이를 사용 설정하려면 다음 단계를 따르세요. 열 표시 옵션을 클릭합니다. 포드 체크박스를 선택합니다. 확인을 클릭합니다. 포드 열을 사용 설정하지 않으려면 스토리지 볼륨 이름을 클릭하여 스토리지 볼륨의 포드를 볼 수 있습니다.	`asia-southeast1-pod1`
유형	하드 드라이브 또는 솔리드 스테이트 드라이브	`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

스토리지 볼륨 이름 바꾸기

스토리지 볼륨 이름을 바꾸려면 다음 단계를 따르세요.

콘솔

Google Cloud 콘솔에서 Compute Engine > 베어메탈 솔루션 > 볼륨 페이지로 이동합니다.
스토리지 볼륨 이름을 클릭합니다.
볼륨 세부정보 페이지의 이름 필드에서 이름 수정을 클릭합니다.
이름 수정 페이지에서 새 이름을 입력합니다.
저장을 클릭합니다.
변경사항을 보려면 페이지를 새로고침합니다.

gcloud

스토리지 볼륨의 이름을 바꾸려면 gcloud bms volumes rename 명령어를 사용합니다.

gcloud bms volumes rename VOLUME_NAME --new-name=NEW_NAME --project=PROJECT_ID --region=REGION

다음을 바꿉니다.

VOLUME_NAME: 스토리지 볼륨의 현재 이름입니다.
NEW_NAME: 스토리지 볼륨의 새 이름입니다.
PROJECT_ID: 프로젝트 ID입니다.
REGION: 스토리지 볼륨의 위치입니다.

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

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

새로운 Fibre Channel 스토리지 볼륨 만들기
볼륨에 LUN 만들기
서버에 스토리지 볼륨 연결

새 스토리지 볼륨 만들기

이 기능을 사용하면 이전에 주문한 스토리지를 프로비저닝할 수 있습니다. 스토리지 볼륨을 주문하려면 Google Cloud 영업팀에 문의하세요.

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

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 수	특정 크기로 만들려는 총 LUN 수입니다.	`4`
크기	LUN 크기(GiB)를 선택합니다. 1024GiB는 1TiB입니다.	`1024`

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

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

서버에 스토리지 볼륨 연결

한 번에 여러 스토리지 볼륨을 서버에 연결할 수 있습니다.

서버에 스토리지 볼륨을 연결하려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
스토리지 볼륨을 연결할 서버의 이름을 클릭합니다.
LUN 섹션에서 볼륨 연결을 클릭합니다.
대상 볼륨 목록에서 연결할 스토리지 볼륨을 선택합니다. 또한 여러 스토리지 볼륨을 선택할 수 있습니다.
볼륨 연결을 클릭합니다.

동일한 스토리지 볼륨을 다른 서버에 동시에 연결할 수도 있습니다. 서버 페이지로 이동하고 다른 모든 서버에 대해 이 절차를 반복합니다.

스토리지 볼륨 리소스 삭제

특정 스토리지 볼륨 리소스가 더 이상 필요하지 않으면 삭제할 수 있습니다. 전체 스토리지 볼륨을 삭제할 수도 있고 해당 LUN을 삭제할 수도 있습니다. 하지만 그렇게 하기 전에 스토리지 볼륨을 연결된 서버에서 분리해야 합니다.

이 섹션에서는 다음 작업에 대해 설명합니다.

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

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

스토리지 볼륨을 서버에서 분리할 수 있습니다. 개별 LUN은 서버에서 분리할 수 없습니다. 한 번에 여러 스토리지 볼륨을 분리할 수 있습니다.

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

베어메탈 솔루션 서버의 OS 구성을 업데이트합니다.

Google Cloud 콘솔을 통해 스토리지 볼륨을 분리하기 전에 베어메탈 솔루션 서버의 OS 구성을 업데이트해야 합니다. OS 구성을 업데이트하지 않으면 Google Cloud 콘솔에서 수행된 변경사항이 완전히 구현되지 않고, 데이터가 손상될 수 있으며, 다음 재부팅 시 서버에 문제가 발생할 수 있습니다.

주의: OS 구성을 잘못 업데이트하면 시스템이 불안정해질 수 있습니다. 확실하지 않으면 시스템 관리자에게 문의하세요. OS 구성을 업데이트하기 전 베어메탈 솔루션 서버에 대해 대화형 직렬 콘솔 액세스를 구성하고 테스트하는 것이 좋습니다. 이렇게 하면 연결이 끊어져도 계속 업데이트할 수 있습니다. 또한 이전 OS 구성을 복원하려는 경우에는 부팅 볼륨 스냅샷을 만드는 것이 좋습니다.

이 단계에서는 OS 구성을 업데이트하는 방법의 예시를 보여줍니다. 안내 내용은 OS에 따라 달라질 수 있습니다. 문제가 발생하면 OS 구성 가이드를 참조하세요.

중요: 이러한 예시는 스토리지 볼륨당 LUN이 하나씩 있는 시나리오를 기반으로 합니다. 스토리지 볼륨에 LUN이 여러 개 있으면 스토리지 볼륨을 삭제하기 전에 모든 연관된 LUN이 더 이상 사용 중이 아닌지 확인합니다.
논리적 볼륨 관리자(LVM)

RHEL7.x, RHEL 8.x, Oracle Linux 7.x, Oracle Linux 8.x, SLES 12 SP4, SLES 12 SP5, SLES 15, SLES 15 SP1에 대해 LVM을 통해 스토리지 볼륨을 분리합니다.

다음 예시 절차에서는 LVM을 통해 파일 시스템(/testvol02)과 연관된 논리적 볼륨, 기본 LUN을 분리하는 방법을 보여줍니다.

주의: 다음 단계를 수행하기 전에 파일 시스템의 중요 데이터가 더 이상 사용 중이 아닌지 확인합니다.

다음 단계를 따르세요.
1. 파일 시스템 /testvol02와 연결된 LVM 볼륨 및 기본 LUN을 식별합니다.
  
  df -h|grep testvol02
  
  샘플 출력:
  
  /dev/mapper/testvg01-lv02 99G 33M 99G 1% /testvol02
  
  출력에 파일 시스템 /testvol02가 /dev/mapper/testvg01-lv02 기기와 연결된 것으로 표시됩니다.
2. testvg01-lv02 기기의 WWID를 확인합니다.
  
  sudo dmsetup ls --tree
  
  샘플 출력:
  
  testvg01-lv02 (253:10) └─3600a0980383146354a2b522d53374236 (253:6) ├─ (8:176) ├─ (8:112) ├─ (8:240) └─ (8:48) testvg01-lv01 (253:9) └─3600a0980383146354a2b522d53374235 (253:5) ├─ (8:160) ├─ (8:96) ├─ (8:224) └─ (8:32)
  
  출력에 testvg01-lv02 기기의 WWID가 3600a0980383146354a2b522d53374236인 것으로 표시됩니다.
3. 파일 시스템 /testvol02에 대해 기본 LUN의 논리적 볼륨, 물리적 볼륨, WWID를 확인합니다.
  
  sudo vgdisplay -v
  
  샘플 출력:
  
  --- Volume group --- VG Name testvg01 System ID Format lvm2 Metadata Areas 2 Metadata Sequence No 4 VG Access read/write VG Status resizable MAX LV 0 Cur LV 2 Open LV 2 Max PV 0 Cur PV 2 Act PV 2 VG Size 199.99 GiB PE Size 4.00 MiB Total PE 51198 Alloc PE / Size 50688 / 198.00 GiB Free PE / Size 510 / 1.99 GiB VG UUID W42Rle-9sER-jpS1-dwBC-xbtn-1D2b-FNRDMA --- Logical volume --- LV Path /dev/testvg01/lv01 LV Name lv01 VG Name testvg01 LV UUID W8bzQQ-Qtyf-CDJA-AXPt-P1b1-X4xL-2WDq92 LV Write Access read/write LV Creation host, time at-5176205-svr001, 2022-12-06 22:14:56 +0000 LV Status available # open 1 LV Size 99.00 GiB Current LE 25344 Segments 1 Allocation inherit Read ahead sectors auto - currently set to 8192 Block device 253:9 --- Logical volume --- LV Path /dev/testvg01/lv02 LV Name lv02 VG Name testvg01 LV UUID B1vtMm-RAKx-3S92-mHfx-98xc-gKwR-XWOavH LV Write Access read/write LV Creation host, time at-5176205-svr001, 2022-12-07 17:02:53 +0000 LV Status available # open 1 LV Size 99.00 GiB Current LE 25344 Segments 1 Allocation inherit Read ahead sectors auto - currently set to 8192 Block device 253:10 --- Physical volumes --- PV Name /dev/mapper/3600a0980383146354a2b522d53374235 PV UUID ieY2Cr-HNrg-dj2G-wHgP-lsuh-PTAH-hNemRq PV Status allocatable Total PE / Free PE 25599 / 255 PV Name /dev/mapper/3600a0980383146354a2b522d53374236 PV UUID AMrtZa-TZHO-w0h6-Uf1G-NCwa-UtFY-83rZen PV Status allocatable Total PE / Free PE 25599 / 255
  
  출력이 보여주는 것은 다음과 같습니다.
  
  파일 시스템 /testvol02가 볼륨 그룹 testvg01에서 논리적 볼륨(LV) lv02를 사용 중입니다.
  
  사용 중인 물리적 볼륨(PV)은 /dev/mapper/3600a0980383146354a2b522d53374236입니다.
  
  기본 LUN의 WWID는 3600a0980383146354a2b522d53374236입니다.
4. 파일 시스템 /testvol02를 마운트 해제합니다.
  
  sudo umount /testvol02
5. 필요한 경우 관련 줄을 주석 처리하거나 삭제하여 /etc/fstab 파일에서 파일 시스템 /testvol02에 대한 해당 항목을 찾아서 삭제합니다.
  
  grep testvol02 /etc/fstab
  
  샘플 출력:
  
  /dev/mapper/testvg01-lv02 /testvol02 xfs defaults 0 0
6. 논리적 볼륨 lv02를 비활성화합니다.
  
  sudo lvchange -an /dev/testvg01/lv02
7. 볼륨 그룹 testvg01에서 논리적 볼륨 lv02를 삭제합니다.
  
  sudo lvremove /dev/testvg01/lv02
  
  샘플 출력:
  
  Logical volume "lv02" successfully removed
8. 볼륨 그룹 testvg01에서 물리적 볼륨 /dev/mapper/3600a0980383146354a2b522d53374236을 삭제합니다.
9. 선택사항: 논리적 볼륨과 물리적 볼륨을 삭제한 후 vgdisplay -v 및 dmsetup ls -tree 명령어를 사용해서 기기가 LVM에서 더 이상 사용 중이 아닌지 확인합니다. 기기가 더 이상 사용 중이 아니면 vgdisplay 명령어 결과의 "물리적 볼륨" 섹션에 표시되지 않으며, dmsetup 명령어 결과에서 볼륨과 연결된 것으로 표시되지 않습니다.
로컬 파일 시스템

RHEL7.x, RHEL 8.x, Oracle Linux 7.x, Oracle Linux 8.x에 대해 로컬 파일 시스템을 통해 스토리지 볼륨을 분리합니다.

다음 예시 절차에서는 파일 시스템(/localfs01) 및 기본 LUN을 삭제하는 방법을 보여줍니다.

주의: 다음 단계를 수행하기 전에 파일 시스템의 중요 데이터가 더 이상 사용 중이 아닌지 확인합니다.

다음 단계를 따르세요.
1. 파일 시스템 /localfs01과 연결된 기본 LUN을 식별합니다.
  
  df -h|grep localfs01
  
  샘플 출력:
  
  /dev/mapper/3600a0980383146354a2b522d53374236 100G 33M 100G 1% /localfs01
  
  df 명령어 출력에 파일 시스템 /localfs01이 /dev/mapper/3600a0980383146354a2b522d53374236 기기와 연결된 것으로 표시됩니다.
2. 파일 시스템 /localfs01을 마운트 해제합니다.
  
  sudo umount /localfs01
3. 필요한 경우 관련 줄을 주석 처리하거나 삭제하여 /etc/fstab 파일에서 파일 시스템 /localfs01에 대한 해당 항목을 찾아서 삭제합니다.
  
  grep localfs01 /etc/fstab
  
  샘플 출력:
  
  grep localfs01 /etc/fstab /dev/mapper/3600a0980383146354a2b522d53374236 /localfs01 xfs defaults 0 0
Oracle ASM

RHEL7.x, RHEL 8.x, Oracle Linux 7.x, Oracle Linux 8.x에 대해 Oracle ASM을 통해 스토리지 볼륨을 분리합니다.

다음 예시 절차에서는 Oracle ASM에서 디스크(DEMO_0001) 및 연결된 LUN을 삭제하는 방법을 보여줍니다.

다음 단계를 따르세요.
1. Oracle ASM에서 삭제하려는 디스크를 식별합니다.
  
  sqlplus / as sysasm set lines 999; col diskgroup for a15 col diskname for a15 col path for a35 select a.name DiskGroup,b.name DiskName, b.total_mb, (b.total_mb-b.free_mb) Used_MB, b.free_mb,b.path,b.header_status from v$asm_disk b, v$asm_diskgroup a where a.group_number (+) =b.group_number order by b.group_number,b.name; DISKGROUP DISKNAME TOTAL_MB USED_MB FREE_MB PATH HEADER_STATU --------------- --------------- ---------- ---------- ---------- ----------------------------------- ------------ DATA DATA_0000 25600 5676 19924 /dev/asmdisks/DATA1 MEMBER DEMO DEMO_0000 25600 16 25584 /dev/asmdisks/DEMO1 MEMBER DEMO DEMO_0001 102400 51 102349 /dev/asmdisks/DEMO2 MEMBER RECO RECO_0000 25600 3896 21704 /dev/asmdisks/RECO1 MEMBER
  
  샘플 출력:
  
  DISKGROUP DISKNAME TOTAL_MB USED_MB FREE_MB PATH HEADER_STATU --------------- --------------- ---------- ---------- ---------- ----------------------------------- ------------ DATA DATA_0000 25600 5676 19924 /dev/asmdisks/DATA1 MEMBER DEMO DEMO_0000 25600 16 25584 /dev/asmdisks/DEMO1 MEMBER DEMO DEMO_0001 102400 51 102349 /dev/asmdisks/DEMO2 MEMBER RECO RECO_0000 25600 3896 21704 /dev/asmdisks/RECO1 MEMBER
  
  쿼리 출력에 DEMO_0001 디스크와 연결된 기기가 /dev/asmdisks/DEMO2로 표시됩니다.
2. 디스크 및 WWID와 연결된 다중 경로 기기를 확인합니다.
  
  ls -l /dev/asmdisks/DEMO2 lrwxrwxrwx 1 root root 8 Dec 29 17:52 /dev/asmdisks/DEMO2 -> ../dm-18
  
  sudo multipath -ll|grep dm-18 3600a0980383146354a2b522d53374247 dm-18 NETAPP ,LUN C-Mode
3. 디스크 그룹에서 디스크를 삭제합니다.
  
  SQL> alter diskgroup DEMO drop disk DEMO_0001 rebalance power 5; Diskgroup altered. col diskgroup for a15 col diskname for a15 col path for a35 select a.name DiskGroup,b.name DiskName, b.total_mb, (b.total_mb-b.free_mb) Used_MB, b.free_mb,b.path,b.header_status from v$asm_disk b, v$asm_diskgroup a where a.group_number (+) =b.group_number order by b.group_number,b.name; DISKGROUP DISKNAME TOTAL_MB USED_MB FREE_MB PATH HEADER_STATU --------------- --------------- ---------- ---------- ---------- ----------------------------------- ------------ 0 0 0 /dev/asmdisks/DEMO2 FORMER DATA DATA_0000 25600 5676 19924 /dev/asmdisks/DATA1 MEMBER DEMO DEMO_0000 25600 64 25536 /dev/asmdisks/DEMO1 MEMBER RECO RECO_0000 25600 3896 21704 /dev/asmdisks/RECO1 MEMBER SQL> exit
4. (클러스터의 모든 노드에서 이 단계를 수행하세요.) /etc/udev/rules.d/99-oracle-asmdevices.rules 파일에서 디스크에 대한 모든 참조를 삭제합니다.
  
  이 예시에서는 9번 줄과 10번 줄이 이 절차의 Step 1.b에서 식별된 DEMO_0001 디스크 및 3600a0980383146354a2b522d53374247의 WWID와 연결되었기 때문에 이를 삭제합니다.
  
  cat -n /etc/udev/rules.d/99-oracle-asmdevices.rules 1 # BEGIN ASM disk udev rules for /dev/mapper/3600a0980383146354a2b522d53374244 2 ACTION=="add|change", ENV{DM_UUID}=="mpath-3600a0980383146354a2b522d53374244", SYMLINK+="asmdisks/DATA1", GROUP="asmadmin", OWNER="grid", MODE="0660" 3 # END ASM disk udev rules for /dev/mapper/3600a0980383146354a2b522d53374244 4 # BEGIN ASM disk udev rules for /dev/mapper/3600a0980383146354a2b522d53374243 5 ACTION=="add|change", ENV{DM_UUID}=="mpath-3600a0980383146354a2b522d53374243", SYMLINK+="asmdisks/RECO1", GROUP="asmadmin", OWNER="grid", MODE="0660" 6 # END ASM disk udev rules for /dev/mapper/3600a0980383146354a2b522d53374243 7 # BEGIN ASM disk udev rules for /dev/mapper/3600a0980383146354a2b522d53374242 8 ACTION=="add|change", ENV{DM_UUID}=="mpath-3600a0980383146354a2b522d53374242", SYMLINK+="asmdisks/DEMO1", GROUP="asmadmin", OWNER="grid", MODE="0660" 9 # BEGIN ASM disk udev rules for /dev/mapper/3600a0980383146354a2b522d53374247 10 ACTION=="add|change", ENV{DM_UUID}=="mpath-3600a0980383146354a2b522d53374247", SYMLINK+="asmdisks/DEMO2", GROUP="asmadmin", OWNER="grid", MODE="0660" 11 # END ASM disk udev rules for /dev/mapper/3600a0980383146354a2b522d53374247
5. (클러스터의 모든 노드에서 이 단계를 수행하세요.) udev 규칙 집합 변경사항을 적용합니다.
  
  sudo udevadm control -R
Oracle Linux Virtualization Manager

Oracle Linux Virtualization Manager 4.4.10.7을 통해 스토리지 볼륨을 분리합니다.

Oracle Linux Virtualization Manager 스토리지 도메인에서 개별 Fibre 채널 기기 삭제는 지원되지 않습니다. 기본 LUN을 삭제할 수 있으려면 먼저 스토리지 도메인을 삭제해야 합니다.

주의: 다음 단계를 수행하기 전에 스토리지 도메인에서 사용 중인 Oracle Linux Virtualization Manager 디스크가 없는지 확인해야 합니다.

다음 예시 절차에서는 WWID가 3600a0980383146354a2b522d53374244 및 3600a0980383146354a2b522d53374245이고 Oracle Linux Virtualization Manager 스토리지 도메인 olvm-domain-02의 일부인 LUN을 삭제하는 방법을 보여줍니다.
1. Oracle Linux Virtualization Manager에서 스토리지 > 도메인으로 이동합니다.
2. 스토리지 도메인 olvm-domain-02를 선택합니다.
3. 도메인 관리를 클릭합니다.
4. 삭제하려는 Fibre 채널 LUN의 WWID를 기록해 둡니다. 여기에서 WWID는 3600a0980383146354a2b522d53374244 및 3600a0980383146354a2b522d53374245입니다.
5. 도메인 관리 창을 닫습니다.
6. 다음과 같이 스토리지 도메인을 유지보수 모드로 설정합니다.
  
  스토리지 도메인을 클릭합니다.
  
  데이터 센터 탭을 선택합니다.
  
  유지보수를 클릭한 후 확인을 클릭합니다.
  
  이 단계에 대한 자세한 내용은 Oracle 문서: 환경에서 스토리지 도메인을 안전하게 삭제하는 방법을 참조하세요.
7. 분리를 클릭한 후 확인을 클릭합니다.
8. 스토리지 도메인을 삭제합니다.
  
  스토리지 > 도메인으로 돌아갑니다.
  
  스토리지 도메인을 선택합니다.
  
  삭제를 클릭한 후 확인을 클릭합니다.
Oracle VM Server

Oracle VM Server 출시 버전 3.4.6을 통해 스토리지 볼륨을 분리합니다.

다음 예시 절차에서는 WWID가 3600a0980383146354a2b522d53374236인 LUN을 삭제하는 방법을 보여줍니다.

주의: 서버 풀 내에서 서버가 사용 중인 디스크가 없는지 확인합니다.

다음 단계를 따르세요.
1. Oracle VM Manager에서 연결된 물리적 디스크를 삭제합니다. Oracle 문서: 물리적 디스크 삭제를 참조하세요.
  이 예시에서 WWID가 3600a0980383146354a2b522d53374236인 물리적 디스크의 OVM 콘솔 이름은 NETAPP (10)입니다.
Google Cloud 콘솔에서 Compute Engine > 베어메탈 솔루션 > 서버 페이지로 이동합니다.
분리하려는 스토리지 볼륨이 있는 서버의 이름을 클릭합니다.
LUN 섹션에서 볼륨 분리를 클릭합니다.
대상 볼륨 목록에서 분리하려는 스토리지 볼륨을 선택합니다. 또한 여러 스토리지 볼륨을 선택할 수 있습니다.
선택사항: 기본적으로 스토리지 볼륨을 분리하면 서버가 재부팅됩니다. 서버를 재부팅하지 않으려면 서버 재부팅 건너뛰기 체크박스를 선택합니다.
주의사항:
- 시스템이 불안정해질 수 있으므로 재부팅하지 않고는 스토리지 볼륨을 삭제하지 않는 것이 좋습니다.
- 자동화된 프로세스로 인해 삭제된 스토리지 볼륨을 가리키는 기기 파일에 액세스하려고 시도하면 해결을 위해 재부팅이 필요한 성능 문제로 이어질 수 있습니다.
- sosreport 명령어 또는 주기적인 Oracle 데이터 수집 스크립트(lvs 명령어 실행)를 실행하면 스토리지 볼륨을 분리한 후 OS에서 즉시 SCSI 재스캔 및 기기 삭제를 수행하지 않을 경우 서버 중단이 발생할 수 있습니다. 이를 위한 안내는 이 절차의 8단계에서 설명합니다.
볼륨 분리를 클릭합니다.

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

(6단계에서 재부팅을 건너뛴 경우 이 단계를 수행합니다.) Google Cloud 콘솔을 통해 스토리지 볼륨을 분리한 후 해당 OS에서 SCSI 재스캔 및 기기 삭제를 수행합니다.

안내 내용은 OS에 따라 달라질 수 있습니다. 문제가 발생하면 OS 구성 가이드를 참조하세요.

논리적 볼륨 관리자(LVM)

이 예시는 RHEL7.x, RHEL 8.x, Oracle Linux 7.x, Oracle Linux 8.x, SLES 12 SP4, SLES 12 SP5, SLES 15, SLES 15 SP1에 적용할 수 있습니다.

LUN과 연결된 경로를 삭제합니다.

다음은 베어메탈 솔루션 환경의 예시입니다.

    sudo /bin/rescan-scsi-bus.sh -r
    Syncing file systems
    Scanning SCSI subsystem for new devices and remove devices that have disappeared
    Scanning host 0 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
    Scanning host 1 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
    Scanning host 2 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
    ...
    Scanning host 17 for all SCSI target IDs, all LUNs
    0 new or changed device(s) found.
    0 remapped or resized device(s) found.
    4 device(s) removed.
      [14:0:2:1]
      [14:0:3:1]
      [16:0:0:1]
      [16:0:1:1]

참고: SUSE의 경우 rescan-scsi-bus.sh 스크립트를 실행하는 명령어는 다음과 같습니다.
sudo /usr/bin/rescan-scsi-bus.sh -r

다중 경로 맵을 새로고침합니다.
```
  sudo /sbin/multipath -r
  
```

로컬 파일 시스템

이 예시는 RHEL7.x, RHEL 8.x, Oracle Linux 7.x, Oracle Linux 8.x에 적용할 수 있습니다.

LUN과 연결된 경로를 삭제합니다.

다음은 베어메탈 솔루션 환경의 예시입니다.

  sudo /bin/rescan-scsi-bus.sh -r
  Syncing file systems
  Scanning SCSI subsystem for new devices and remove devices that have disappeared
  Scanning host 0 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
  Scanning host 1 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
  Scanning host 2 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
  ...
  Scanning host 17 for all SCSI target IDs, all LUNs
  0 new or changed device(s) found.
  0 remapped or resized device(s) found.
  4 device(s) removed.
    [14:0:2:1]
    [14:0:3:1]
    [16:0:0:1]
    [16:0:1:1]

참고: SUSE의 경우 rescan-scsi-bus.sh 스크립트를 실행하는 명령어는 다음과 같습니다.
sudo /usr/bin/rescan-scsi-bus.sh -r

다중 경로 맵을 새로고침합니다.
```
 sudo /sbin/multipath -r
 
```

Oracle ASM

이 예시는 RHEL7.x, RHEL 8.x, Oracle Linux 7.x, Oracle Linux 8.x에 적용할 수 있습니다.

클러스터의 모든 노드에서 이 단계를 수행하세요.

LUN과 연결된 경로를 삭제합니다.

다음은 베어메탈 솔루션 환경의 예시입니다.

  sudo /bin/rescan-scsi-bus.sh -r
  Syncing file systems
  Scanning SCSI subsystem for new devices and remove devices that have disappeared
  Scanning host 0 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
  Scanning host 1 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
  Scanning host 2 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
  ...
  Scanning host 17 for  all SCSI target IDs, all LUNs
  0 new or changed device(s) found.
  0 remapped or resized device(s) found.
  4 device(s) removed.
    [14:0:2:8]
    [14:0:3:8]
    [16:0:0:8]
    [16:0:3:8]

참고: SUSE의 경우 rescan-scsi-bus.sh 스크립트를 실행하는 명령어는 다음과 같습니다.
sudo /usr/bin/rescan-scsi-bus.sh -r

다중 경로 맵을 새로고침합니다.
```
sudo /sbin/multipath -r
```

Oracle Linux Virtualization Manager

이 예시는 Oracle Linux Virtualization Manager 4.4.10.7에 적용할 수 있습니다.

이 예시에서는 Oracle Linux Virtualization Manager 설치 중에 제공된 remove_stale_lun.yml Ansible 플레이북이 사용됩니다. 이 플레이북은 Oracle Linux Virtualization Manager에서 KVM 호스트 인벤토리를 빌드한 후 이러한 KVM 호스트에서 지정된 WWID를 삭제하는 Ansible 역할을 사용합니다. 자세한 내용은 Ansible 플레이북을 참조하세요.

Ansible 환경에 적합한 방법으로 passwords.yml 파일을 KVM 호스트의 비밀번호로 업데이트합니다.

이 절차의 1.d단계에 식별된 WWID 값과 일치하도록 remove_stale_lun.yml 파일을 수정해서 vars 섹션을 data_center 및 lun_wwid의 값으로 바꿉니다.

  vars:
   ansible_ssh_common_args: "-o StrictHostKeyChecking=no"
   ansible_user: root
   ansible_ssh_private_key_file: /etc/pki/ovirt-engine/keys/engine_id_rsa

   engine_fqdn: manager.olvm.test
   engine_user: admin@internal

   data_center: default
   lun_wwid: 3600a0980383146354a2b522d53374244 3600a0980383146354a2b522d53374245

Oracle Linux Virtualization Manager 엔진에서 Ansible 플레이북을 실행합니다.

    ansible-playbook /usr/share/ansible/collections/ansible_collections/ovirt/ovirt/roles/remove_stale_lun/examples/remove_stale_lun.yml

    PLAY [oVirt remove stale LUN] ***********************************************************************************************************************************************************

    ... [output skipped]

    TASK [ovirt.ovirt.remove_stale_lun : Logout from oVirt] *********************************************************************************************************************************
    skipping: [localhost]

    PLAY RECAP ******************************************************************************************************************************************************************************
    localhost                  : ok=7    changed=3    unreachable=0    failed=0    skipped=1    rescued=0    ignored=0

Ansible 플레이북이 완료되었으면 LUN과 연결된 경로가 KVM 호스트에서 안전하게 삭제됩니다.

Oracle VM Server

이 예시는 Oracle VM Server 출시 버전 3.4.6에 적용할 수 있습니다.

LUN이 연결된 모든 Oracle VM Server에서 다음 단계를 수행합니다.

LUN과 연결된 경로를 삭제합니다.

sudo /usr/bin/rescan-scsi-bus.sh -r
Syncing file systems
Scanning SCSI subsystem for new devices and remove devices that have disappeared
Scanning host 0 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
Scanning host 1 for  SCSI target IDs  0 1 2 3 4 5 6 7, all LUNs
Scanning host 2 for  SCSI target IDs  0 1 2 3
[output skipped]
Scanning host 17 for  all SCSI target IDs, all LUNs
0 new or changed device(s) found.
0 remapped or resized device(s) found.
4 device(s) removed.
  [14:0:2:2]
  [14:0:3:2]
  [16:0:2:2]
  [16:0:3:2]

다중 경로 맵을 새로고침합니다.
```
sudo /sbin/multipath -r
```

스토리지 볼륨에서 LUN 삭제

스토리지 볼륨에서 LUN을 삭제하기 전에 연결된 모든 서버에서 스토리지 볼륨을 분리하세요. 서버에서 스토리지 볼륨 분리를 참조하세요.

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

Google Cloud 콘솔에서 Compute Engine > 베어메탈 솔루션 > 볼륨 페이지로 이동합니다.
삭제할 LUN이 포함된 스토리지 볼륨의 이름을 클릭합니다.
LUN 섹션에서 삭제할 LUN을 선택합니다.
삭제를 클릭합니다.

LUN을 삭제하면 쿨다운 기간 7일로 이어집니다. LUN은 쿨다운 기간이 완료된 후에만 삭제됩니다. 쿨다운 기간 동안 LUN을 복원하려면 고객 지원에 문의하세요.

쿨다운 기간을 건너뛰고 LUN을 영구적으로 삭제하려면 다음 단계를 진행합니다.

주의: 이 작업은 되돌릴 수 없습니다. 제거 옵션을 사용하면 LUN을 복원할 수 없습니다. 다른 스토리지 매체에 백업을 만들지 않으면 제거된 LUN의 모든 데이터가 손실됩니다.
쿨다운 기간을 건너뛸 LUN을 선택합니다.
제거를 클릭합니다.
확인을 클릭합니다.

삭제 및 제거는 장기 실행 작업입니다. 상태를 확인하려면 Google Cloud 콘솔에서 알림을 클릭합니다. 삭제 작업이 완료되면 LUN 상태가 '쿨다운'으로 변경되고 제거 작업이 완료되면 LUN 목록에서 LUN이 삭제됩니다.

LUN이 삭제되면 저장공간을 사용할 수 있도록 스토리지 볼륨으로 반환합니다. 하지만 할당량은 스토리지 볼륨을 삭제하거나 제거할 때만 반환됩니다. LUN을 삭제하면 쿨다운 기간 7일 후에 할당량이 반환됩니다. 그러나 LUN을 제거하는 경우 제거 작업이 완료되면 할당량이 반환됩니다.

LUN을 삭제한 후 스토리지 볼륨을 다시 연결하려면 서버에 스토리지 볼륨 연결을 참조하세요.

스토리지 볼륨 삭제

한 번에 여러 스토리지 볼륨을 삭제할 수 있습니다.

스토리지 볼륨을 삭제하기 전에 연결된 모든 서버에서 분리하세요. 서버에서 스토리지 볼륨 분리를 참조하세요.

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

Google Cloud 콘솔에서 Compute Engine > 베어메탈 솔루션 > 볼륨 페이지로 이동합니다.
스토리지 볼륨을 선택합니다.
삭제를 클릭합니다.

스토리지 볼륨을 삭제하면 쿨다운 기간 7일로 이어집니다. 스토리지 볼륨은 쿨다운 기간이 완료된 후에만 삭제됩니다. 쿨다운 기간 동안 스토리지 볼륨을 복원하려면 고객 지원에 문의하세요.

쿨다운 기간을 건너뛰고 스토리지 볼륨을 영구 삭제하려면 다음 단계를 따르세요.

주의: 이 작업은 되돌릴 수 없습니다. 제거 옵션을 사용하면 스토리지 볼륨을 복원할 수 없습니다. 다른 스토리지 매체에 백업을 만들지 않으면 제거된 스토리지 볼륨에 있는 모든 데이터가 손실됩니다.
쿨다운 기간을 건너뛸 볼륨을 선택합니다.
제거를 클릭합니다.
확인을 클릭합니다.

삭제 및 제거는 장기 실행 작업입니다. 상태를 확인하려면 Google Cloud 콘솔에서 알림을 클릭합니다. 삭제 작업이 완료되면 스토리지 볼륨 상태가 '쿨다운'으로 변경되고 제거 작업이 완료되면 스토리지 볼륨 목록에서 스토리지 볼륨이 삭제됩니다.

스토리지 볼륨을 삭제하면 쿨다운 기간 7일 후에 할당량이 반환됩니다. 하지만 스토리지 볼륨을 제거하는 경우 제거 작업이 완료되면 할당량이 반환됩니다.

부팅 볼륨 스냅샷 관리

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

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

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

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=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=VOLUME_NAME --snapshot=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 > 베어메탈 솔루션 > 볼륨 페이지로 이동합니다.
볼륨 이름을 클릭합니다.
볼륨 세부정보 페이지의 스냅샷 섹션에서 삭제할 스냅샷을 선택합니다.
삭제를 클릭합니다.
메시지가 나타나면 확인을 클릭합니다.

gcloud

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

gcloud bms volumes snapshots delete --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME --snapshot=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=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에서 예상대로 구현했는지 확인할 수 있습니다.

NFS 볼륨의 세부정보를 보려면 다음 단계를 따르세요.

콘솔

NFS 공유 페이지로 이동합니다.

NFS 공유로 이동

NFS 공유 페이지에는 다음 세부정보와 함께 모든 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 볼륨 이름을 클릭하여 NFS 볼륨의 포드를 볼 수 있습니다.	`asia-southeast1-pod1`
볼륨	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 볼륨 이름을 바꾸려면 다음 단계를 따르세요.

콘솔

Google Cloud 콘솔에서 Compute Engine > 베어메탈 솔루션 > NFS 공유 페이지로 이동합니다.
NFS 볼륨 이름을 클릭합니다.
NFS 공유 세부정보 페이지의 이름 필드에서 이름 수정을 클릭합니다.
이름 수정 페이지에서 새 이름을 입력합니다.
저장을 클릭합니다.
변경사항을 보려면 페이지를 새로고침합니다.

gcloud

NFS 볼륨 이름을 바꾸려면 gcloud bms nfs-shares rename 명령어를 사용합니다.

gcloud bms nfs-shares rename NFS_VOLUME_NAME --new-name=NEW_NAME --project=PROJECT_ID --region=REGION

다음을 바꿉니다.

NFS_VOLUME_NAME: NFS 볼륨의 현재 이름입니다.
NEW_NAME: NFS 볼륨의 새 이름입니다.
PROJECT_ID: 프로젝트 ID입니다.
REGION: NFS 볼륨의 위치입니다.

NFS 볼륨 만들기

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

콘솔

NFS 공유 페이지로 이동합니다.

NFS 공유로 이동
만들기를 클릭합니다.
이름 필드에 NFS 볼륨의 이름을 입력합니다.
리전 드롭다운 목록에서 NFS 볼륨을 만들 Google Cloud 리전을 선택합니다.
스토리지 유형을 선택합니다.
크기 필드에 드라이브 크기를 GiB 단위로 입력합니다.

크기는 최소 100GiB부터 최대 16TiB까지입니다. 16TiB보다 더 필요하면 그에 맞게 추가 NFS 볼륨을 만듭니다.
허용된 클라이언트 섹션에서 허용되는 클라이언트 네트워크를 추가합니다.
1. 항목 추가를 클릭합니다.
2. 조직의 다른 프로젝트에서 네트워크 선택 체크박스를 선택하여 다른 프로젝트에서 네트워크 선택을 사용 설정할 수 있습니다.
3. 기존 네트워크 선택 드롭다운 목록에서 네트워크를 선택합니다.
4. NFS 볼륨에 액세스할 수 있는 IP 주소 범위를 입력합니다.
5. 마운트 권한 드롭다운 목록에서 허용된 클라이언트 네트워크에 대한 마운트 권한을 선택합니다.
6. Dev 허용 체크박스를 선택하여 기기 생성을 사용 설정합니다.
7. SUID 허용 체크박스를 선택하여 SUID를 사용 설정합니다.
8. 루트 스쿼시 없음 체크박스를 선택하여 루트 스쿼시를 사용 설정합니다.
  
  새 NFS 볼륨에는 루트 스쿼시를 사용 중지하는 것이 좋습니다. 기본적으로 NFS 볼륨에는 755 권한 및 root(0) 소유자 역할이 있습니다. 모든 새 NFS 볼륨은 root 사용자가 소유하므로 루트 스쿼시가 사용 설정되면 새 NFS 볼륨에 파일을 쓸 수 없습니다. 따라서 먼저 루트 스쿼시가 사용 중지된 NFS 볼륨을 만들고 디렉터리 구조를 빌드하고 NFS 볼륨의 권한 또는 소유권을 변경합니다. 그런 다음 허용된 클라이언트를 삭제하고 다시 추가하여 NFS 볼륨에서 루트 스쿼시를 사용 설정합니다. NFS 볼륨 업데이트를 참조하세요.
9. 완료를 클릭합니다.
만들기를 클릭합니다.

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: 루트 스쿼시를 사용 설정합니다(예/아니요). 새 NFS 볼륨에는 루트 스쿼시를 사용 중지하는 것이 좋습니다. 기본적으로 NFS 볼륨에는 755 권한 및 root(0) 소유자 역할이 있습니다. 모든 새 NFS 볼륨은 root 사용자가 소유하므로 루트 스쿼시가 사용 설정되면 새 NFS 볼륨에 파일을 쓸 수 없습니다. 따라서 먼저 루트 스쿼시가 사용 중지된 NFS 볼륨을 만들고 디렉터리 구조를 빌드하고 NFS 볼륨의 권한 또는 소유권을 변경합니다. 그런 다음 허용된 클라이언트를 삭제하고 다시 추가하여 NFS 볼륨에서 루트 스쿼시를 사용 설정합니다. NFS 볼륨 업데이트를 참조하세요.

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: 루트 스쿼시를 사용 설정합니다(예/아니요). 새 NFS 볼륨에는 루트 스쿼시를 사용 중지하는 것이 좋습니다. 기본적으로 NFS 볼륨에는 755 권한 및 root(0) 소유자 역할이 있습니다. 모든 새 NFS 볼륨은 root 사용자가 소유하므로 루트 스쿼시가 사용 설정되면 새 NFS 볼륨에 파일을 쓸 수 없습니다. 따라서 먼저 루트 스쿼시가 사용 중지된 NFS 볼륨을 만들고 디렉터리 구조를 빌드하고 NFS 볼륨의 권한 또는 소유권을 변경합니다. 그런 다음 허용된 클라이언트를 삭제하고 다시 추가하여 NFS 볼륨에서 루트 스쿼시를 사용 설정합니다. NFS 볼륨 업데이트를 참조하세요.

명령어를 복사하여 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 볼륨이 생성된 후에는 허용된 클라이언트만 업데이트할 수 있습니다.

콘솔

NFS 공유 페이지로 이동합니다.

NFS 공유로 이동
NFS 볼륨의 이름을 클릭합니다.
허용된 클라이언트를 추가하려면 다음을 수행합니다.
1. 허용된 클라이언트 섹션에서 추가를 클릭합니다.
2. 허용된 클라이언트 추가 페이지에서 항목 추가를 클릭합니다.
3. 조직의 다른 프로젝트에서 네트워크 선택 체크박스를 선택하여 다른 프로젝트에서 네트워크 선택을 사용 설정할 수 있습니다.
4. 기존 네트워크 선택 드롭다운 목록에서 네트워크를 선택합니다.
5. NFS 볼륨에 액세스할 수 있는 IP 주소 범위를 입력합니다.
6. 마운트 권한 드롭다운 목록에서 허용된 클라이언트 네트워크에 대한 마운트 권한을 선택합니다.
7. Dev 허용 체크박스를 선택하여 기기 생성을 사용 설정합니다.
8. SUID 허용 체크박스를 선택하여 SUID를 사용 설정합니다.
9. 루트 스쿼시 없음 체크박스를 선택하여 루트 스쿼시를 사용 설정합니다.
  
  새 NFS 볼륨에는 루트 스쿼시를 사용 중지하는 것이 좋습니다. 기본적으로 NFS 볼륨에는 755 권한 및 root(0) 소유자 역할이 있습니다. 모든 새 NFS 볼륨은 root 사용자가 소유하므로 루트 스쿼시가 사용 설정되면 새 NFS 볼륨에 파일을 쓸 수 없습니다. 따라서 먼저 루트 스쿼시가 사용 중지된 NFS 볼륨을 만들고 디렉터리 구조를 빌드하고 NFS 볼륨의 권한 또는 소유권을 변경합니다. 그런 다음 허용된 클라이언트를 삭제하고 다시 추가하여 NFS 볼륨에서 루트 스쿼시를 사용 설정합니다. NFS 볼륨 업데이트를 참조하세요.
10. 완료를 클릭합니다.
11. 추가를 클릭합니다.
허용되는 클라이언트를 업데이트하려면 다음을 수행합니다.
1. 허용되는 클라이언트 네트워크를 선택합니다.
2. 업데이트를 클릭합니다.
3. 허용된 클라이언트 업데이트 페이지에서 클라이언트 네트워크를 클릭하여 세부정보를 확장합니다.
4. 필수 필드를 업데이트합니다.
5. 완료를 클릭합니다.
6. 업데이트를 클릭합니다.

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 볼륨을 삭제하면 쿨다운 기간 7일이 자동으로 트리거되며 이 시간 동안 Google Cloud에서 볼륨이 사용 상태로부터 삭제됩니다.

콘솔

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
}
```

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

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

콘솔

gcloud

베어메탈 솔루션 서버 운영

콘솔

gcloud

API

서버 상태 확인

콘솔

gcloud

API

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

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

조직 및 폴더의 베어메탈 솔루션 리소스 나열

서버 관리

서버 보기

콘솔

gcloud

API

라벨을 사용하여 서버 구성

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

콘솔

gcloud

API

서버에서 라벨 삭제

콘솔

gcloud

API

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

콘솔

gcloud

API

서버 이름 변경

콘솔

gcloud

서버의 초기 비밀번호 검색

gcloud

API

OS 세부정보 보기

서버 OS 변경

콘솔

gcloud

API

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

콘솔

gcloud

API

VRF 관리

VRF 보기

VRF 만들기

VRF 삭제

VLAN 연결 관리

VLAN 연결 쌍 추가

VLAN 연결 쌍 업데이트

VLAN 연결 쌍 삭제

네트워크 관리하기

네트워크 보기

콘솔

gcloud

API

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

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

콘솔

gcloud

API

네트워크에서 라벨 삭제

콘솔

gcloud

API

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

콘솔

gcloud

API

네트워크 이름 바꾸기

콘솔

gcloud

네트워크 만들기

서버에 네트워크 연결

RHEL, Oracle Linux