바인딩, 바인딩 해제 및 이동하는 공개 주소 범위

콘솔, CLI, API 및 Terraform을 사용하여 공개 주소 범위를 가용 영역의 VPC에 바인딩, 바인딩 해제 및 이동할 수 있습니다.

시작하기 전에

공용 주소 범위를 바인딩, 바인딩 해제 또는 이동하기 전에 다음 요구 사항 및 고려 사항을 검토하십시오:

  • 공개 주소 범위에 대한 계획 고려 사항을 검토하세요.
  • 공개 주소 범위의 바인딩에는 VPC와 가용성 영역이 모두 포함되어야 합니다.
  • 공용 주소 범위를 사용할 때는 해당 주소 범위를 바인딩한 후, 트래픽을 적절한 리소스로 전달하도록 인그레스 라우팅을 구성해야 합니다. 주소 범위를 VPC에 바인딩한다고 해서 트래픽이 해당 리소스로 자동으로 라우팅되는 것은 아닙니다.

콘솔에서 공개 주소 범위 바인딩, 바인딩 해제 및 이동하기

콘솔에서 공개 주소 범위를 바인딩, 바인딩 해제 및 가용성 영역의 VPC로 이동할 수 있습니다.

콘솔에서 공개 주소 범위 바인딩하기

IBM Cloud® 콘솔에서 공개 주소 범위를 바인딩하려면 다음 단계를 따르세요:

  1. IBM Cloud 콘솔에서 탐색 메뉴 메뉴 아이콘을 선택한 다음 인프라 VPC 아이콘 > 네트워크 > 공인 주소 범위를 클릭합니다. VPC의 공용 주소 범위 페이지가 나타납니다.
  2. 표에서 주소 범위의 행을 강조 표시한 다음 작업 메뉴 작업 아이콘 바인딩을 클릭합니다.
  3. '주소 범위 바인딩' 페이지에서, 주소 범위를 바인딩하려는 VPC와 해당 가용 영역을 선택합니다.
  4. 바인딩을 클릭하여 공개 주소 범위를 VPC에 바인딩합니다.

콘솔에서 공개 주소 범위 바인딩 해제하기

IBM Cloud 콘솔에서 공개 주소 범위의 바인딩을 해제하려면 다음 단계를 따르세요:

공개 주소는 바인딩이 해제된 후에도 예약된 상태로 유지되며 다시 바인딩할 수 있습니다.

  1. IBM Cloud 콘솔에서 탐색 메뉴 메뉴 아이콘을 선택한 다음 인프라 VPC 아이콘 > 네트워크 > 공인 주소 범위를 클릭합니다. VPC의 공용 주소 범위 페이지가 나타납니다.
  2. 표에서 주소 범위의 행을 강조 표시한 다음 작업 메뉴 작업 아이콘 바인딩 해제를 클릭합니다.
  3. 바인딩 해제를 클릭하여 VPC에서 이 주소 범위를 바인딩 해제할지 확인합니다.

콘솔에서 공개 주소 범위 이동하기

공개 주소 범위가 가용성 영역의 VPC에 바인딩되어 있는 경우 이를 업데이트하여 다른 VPC 및 가용성 영역으로 바인딩(이동)할 수 있습니다. 공개 주소 범위는 해당 VPC 및 가용성 영역에서 자동으로 바인딩 해제된 다음 새로 지정된 VPC 및 가용성 영역에 바인딩됩니다.

주소 범위를 원래 대상에서 먼저 바인딩 해제할 필요는 없습니다.

콘솔에서 공개 주소 범위를 이동하려면 다음 단계를 따르세요:

  1. IBM Cloud 콘솔에서 탐색 메뉴 메뉴 아이콘을 선택한 다음 인프라 VPC 아이콘 > 네트워크 > 공인 주소 범위를 클릭합니다. VPC의 공용 주소 범위 페이지가 나타납니다.
  2. 표에서 주소 범위의 행을 강조 표시한 다음 작업 메뉴 작업 아이콘 편집을 클릭합니다.
  3. '공용 주소 범위 편집' 페이지에서 주소 범위를 이동할 VPC와 해당 가용 영역을 선택합니다.
  4. 저장을 클릭하여 공개 주소 범위를 새 VPC에 바인딩합니다.

CLI에서 공개 주소 범위 바인딩, 바인딩 해제 및 이동하기

명령줄에서 예약된 IP 주소를 바인딩, 바인딩 해제 또는 이동하려면 다음 단계를 따르세요:

  1. CLI 환경을 설정하십시오.

  2. CLI 환경에 로그인합니다. 비밀번호를 입력하면 시스템이 사용할 계정 및 지역에 대한 프롬프트를 표시합니다.

    ibmcloud login --sso
    
  3. 다음 기능 플래그를 활성화합니다:

    export IBMCLOUD_IS_FEATURE_PUBLIC_ADDRESS_RANGE=true
    

    IBM Cloud (CLI) 및 관련 플러그인의 업데이트가 제공될 때 명령줄에서 알림을 받게 됩니다. 최신 명령어에 액세스하려면 CLI를 최신 상태로 유지하는 것이 중요합니다. 설치된 모든 플러그인의 현재 버전을 확인하려면 ibmcloud plugin list.

  4. 다음 명령을 실행하십시오.

    ibmcloud is public-address-range-update PUBLIC_ADDRESS_RANGE [--name NAME] ([--vpc VPC --zone ZONE] | [--reset-target]) [--output JSON] [-q, --quiet]
    

    여기서:

    PUBLIC_ADDRESS_RANGE
    업데이트할 공개 주소 범위의 ID 또는 이름입니다.
    --name
    공개 주소 범위의 이름을 변경하려는 경우 새 식별자입니다.
    --vpc
    공용 주소 범위를 연결하려는 VPC입니다. --vpc 옵션을 지정할 때는 --zone 을 입력해야 합니다.
    --zone
    이 공용 주소 범위를 할당할 영역입니다. --zone 옵션을 지정할 때는 --vpc 을 입력해야 합니다.
    --reset-target
    공용 주소 범위의 할당을 해제합니다.
    -f, --force
    확인 없이 조작을 강제로 실행합니다.
    --output
    출력 형식은 JSON만 지원됩니다. 다음 중 하나: JSON
    -q, --quiet
    상세 출력이 표시되지 않도록 합니다.

명령 예제

공개 주소가 VPC에 바인딩되어 있지 않은 경우에는 모든 가용 영역의 VPC에 바인딩할 수 있습니다:

ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --name public-address-range-1 --vpc cli-test-vpc --zone us-south-1

VPC에서 공개 주소 범위를 바인딩 해제하고 바인딩되지 않은 상태로 둡니다:

ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --name public-address-range-1 --reset-target

한 VPC에서 다른 VPC로 공개 주소 범위를 이동합니다:

ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --vpc cli-test-vpc --zone us-south-2

API로 공개 주소 범위 바인딩, 바인딩 해제 및 이동하기

API를 사용하여 공개 주소 범위를 바인딩, 바인딩 해제 또는 이동하려면 다음 단계를 따르세요:

  1. API 환경을 설정하십시오.
  2. API 명령에 사용할 변수에 다음 값을 저장하십시오.

version (문자열): API 버전, 형식은 YYYY-MM-DD 입니다.

  1. 모든 변수의 초기화가 완료되면 다음 작업 중 하나를 선택하십시오:

    • 공개 주소 범위를 특정 VPC에 바인딩합니다:
         curl -X PATCH \
                "$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \
                -H "Authorization: Bearer $iam_token" \
                -H "Content-Type: application/json" \
                -d '{
                      "target": {
                         "vpc": {
                            "id": "r006-4727d842-f94f-4a2d-824a-9bc9b02c523b"
                         },
                         "zone": {
                            "name": "us-south-2"
                         }
                      }
                   }'
    
  • 특정 VPC에서 공개 주소 범위의 바인딩을 해제합니다:

      curl -X PATCH \
            "$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \
            -H "Authorization: Bearer $iam_token" \
            -H "Content-Type: application/json" \
            -d '{
                  "target": null
               }'
   ```
   공개 주소는 바인딩이 해제된 후에도 여전히 예약된 상태로 유지되며 다시 바인딩할 수 있습니다.
   {: note}

* 한 VPC에서 다른 VPC로 공개 주소 범위를 이동합니다:

```sh {: pre}
      curl -X PATCH \
            "$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \
            -H "Authorization: Bearer $iam_token" \
            -H "Content-Type: application/json" \
            -d '{
                  "target": {
                     "vpc": {
                        "id": "r006-9999aaaa-bbbb-cccc-dddd-1234567890ab"
                     },
                     "zone": {
                        "name": "us-south-3"
                     }
                  }
               }'
   ```
## Terraform으로 공개 주소 범위 바인딩, 바인딩 해제 및 이동하기 {: #par-bind-unbind-terraform terraform}

Terraform으로 공개 주소 범위를 바인딩, 바인딩 해제 또는 이동하려면 다음 예제를 사용하세요:

```terraform {: codeblock}
resource "ibm_is_public_address_range" "public_address_range_instance" {
 ipv4_address_count = "16"
name = "example-public-address-range"
resource_group{
   id = "11caaa983d9c4beb82690daab08717e9"
}
target{
 vpc {
   id = ibm_is_vpc.testacc_vpc.id
 }
 zone {
   name = "us-south-3"
 }
}
}

관련 링크