

AWS App Runner 는 2026년 4월 30일부터 신규 고객에게 더 이상 공개되지 않습니다. App Runner를 사용하려면 해당 날짜 이전에 가입하세요. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [AWS App Runner 가용성 변경](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)을 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 수신 트래픽에 대해 IPv6 활성화
<a name="network-dual-stack"></a>

서비스가 IPv6 주소 또는 IPv4 및 IPv6 주소 모두에서 수신 네트워크 트래픽을 수신하도록 하려면 엔드포인트의 **듀얼 스택** 주소 유형을 IPv6 선택합니다. 새 애플리케이션을 생성할 때 **서비스 구성** > **네트워킹** 섹션에서이 설정을 찾을 수 있습니다. 다음 절차에서는 App Runner 콘솔 또는 App Runner API를 사용하여 IPv4 또는 듀얼 스택(IPv6 및 IPv4)을 활성화하는 방법을 설명합니다.

## 수신 트래픽에 대한 듀얼 스택 관리
<a name="network-dual-stack-manage"></a>

다음 방법 중 하나를 사용하여 수신 트래픽의 듀얼 스택 주소 유형을 관리합니다.
+ [App Runner 콘솔](#network-dual-stack-manage.console)
+ [App Runner API 또는 AWS CLI](#network-dual-stack-manage.api)

**참고**  
다음 절차에서는 **퍼블릭** 수신 트래픽의 네트워크 주소 유형을 관리하는 방법을 설명합니다. **프라이빗** 엔드포인트의 듀얼 스택 또는 IPv4 주소 유형 관리에 대한 자세한 내용은 섹션을 참조하세요[프라이빗 엔드포인트 관리](network-pl-manage.md).

### App Runner 콘솔
<a name="network-dual-stack-manage.console"></a>

App Runner 콘솔을 사용하여 서비스를 생성하거나 나중에 구성을 업데이트할 때 수신 인터넷 트래픽에 대해 듀얼 스택 주소 유형을 선택할 수 있습니다.

**듀얼 스택 주소 유형을 활성화하려면**

1.  서비스를 [생성](manage-create.md)하거나 [업데이트할](manage-configure.md) 때 **서비스 구성** 아래의 **네트워킹** 섹션을 확장합니다.

1. **수신 네트워크 트래픽**에 대해 **퍼블릭 엔드포인트**를 선택합니다. **퍼블릭 엔드포인트**를 선택하면 **엔드포인트 IP 주소 유형** 옵션이 열립니다.

   프라이빗 엔드포인트의 듀얼 스택 또는 IPv4 주소 유형을 관리하는 [프라이빗 엔드포인트 관리](network-pl-manage.md) 절차는 섹션을 참조하세요.

1. **엔드포인트 IP 주소 유형을** 확장하여 다음 IP 주소 유형을 확인합니다.
   + **IPv4**
   + **듀얼 스택(IPv4 및 IPv6)**
**참고**  
**엔드포인트 IP 주소 유형을** 확장하여 선택하지 않으면 App Runner가 IPv4를 기본 구성으로 할당합니다.

1. **듀얼 스택(IPv4 및 IPv6)**을 선택합니다.

1. 서비스를 생성하는 경우 **다음을** 선택한 후 **생성 및 배포**를 선택합니다. 또는 서비스를 업데이트하는 경우 **변경 사항 저장**을 선택합니다.

   서비스가 배포되면 애플리케이션이 IPv4 및 IPv6 엔드포인트 모두에서 네트워크 트래픽을 수신하기 시작합니다.

**주소 유형을 변경하려면**

1.  단계에 따라 서비스를 [업데이트](manage-configure.md)하고 네트워킹으로 이동합니다.

1. **수신 네트워크 트래픽**에서 **엔드포인트 IP 주소 유형**으로 이동하여 필요한 주소 유형을 선택합니다.

1. **변경 사항 저장**을 선택합니다. 선택한 항목으로 서비스가 업데이트됩니다.

### App Runner API 또는 AWS CLI
<a name="network-dual-stack-manage.api"></a>

[CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) 또는 [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html) App Runner API 작업을 호출할 때 `NetworkConfiguration` 파라미터의 `IpAddressType` 멤버를 사용하여 주소 유형을 지정합니다. 지정할 수 있는 지원되는 값은 `IPv4` 및 입니다`DUAL_STACK`. 서비스가 IPv4 및 IPv6 엔드포인트에서 인터넷 트래픽을 수신할`DUAL_STACK`지 여부를 지정합니다. 에 값을 지정하지 않으면 `IpAddressType`기본적으로 IPv4가 적용됩니다.

**참고**  
프라이빗 엔드포인트 예제는 섹션을 참조하세요[App Runner API 또는 AWS CLI](network-pl-manage.md#network-pl-manage.api).

다음은 듀얼 스택을 IP 주소로 사용하여 서비스를 생성하는 예제입니다. 이 예제에서는 `input.json` 파일을 호출합니다.

**Example 듀얼 스택을 지원하는 서비스 생성 요청**  

```
aws apprunner create-service \
 --cli-input-json file://input.json
```

**Example `input.json`의 콘텐츠**  

```
{
  "ServiceName": "example-service",
  "SourceConfiguration": {
    "ImageRepository": {
      "ImageIdentifier": "public.ecr.aws/aws-containers/hello-app-runner:latest",
      "ImageConfiguration": {
        "Port": "8000"
      },
      "ImageRepositoryType": "ECR_PUBLIC"
    },
    "NetworkConfiguration": {
      "IpAddressType": "DUAL_STACK"
    }
  }
}
```

**Example 응답**  

```
{
  "Service": {
    "ServiceName": "example-service",
    "ServiceId": "<service-id>",
    "ServiceArn": "arn:aws:apprunner:us-east-2:123456789012:service/example-service/<service-id>",
    "ServiceUrl": "1234567890.us-east-2.awsapprunner.com",
    "CreatedAt": "2023-10-16T12:30:51.724000-04:00",
    "UpdatedAt": "2023-10-16T12:30:51.724000-04:00",
    "Status": "OPERATION_IN_PROGRESS",
    "SourceConfiguration": {
      "ImageRepository": {
        "ImageIdentifier": "public.ecr.aws/aws-containers/hello-app-runner:latest",
        "ImageConfiguration": {
          "Port": "8000"
        },
        "ImageRepositoryType": "ECR_PUBLIC"
      },
      "AutoDeploymentsEnabled": false
    },
    "InstanceConfiguration": {
      "Cpu": "1024",
      "Memory": "2048"
    },
    "HealthCheckConfiguration": {
      "Protocol": "TCP",
      "Path": "/",
      "Interval": 5,
      "Timeout": 2,
      "HealthyThreshold": 1,
      "UnhealthyThreshold": 5
    },
    "AutoScalingConfigurationSummary": {
      "AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-2:123456789012:autoscalingconfiguration/DefaultConfiguration/1/00000000000000000000000000000001",
      "AutoScalingConfigurationName": "DefaultConfiguration",
      "AutoScalingConfigurationRevision": 1
    },
    "NetworkConfiguration": {
      "IpAddressType": "DUAL_STACK",
      "EgressConfiguration": {
        "EgressType": "DEFAULT"
      },
      "IngressConfiguration": {
        "IsPubliclyAccessible": true
      }
    }
  },
  "OperationId": "24bd100b1e111ae1a1f0e1115c4f11de"
}
```

API 파라미터에 대한 자세한 내용은 [NetworkConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_NetworkConfiguration.html)을 참조하세요.