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

VPC에 HealthOmics 워크플로 연결

Amazon Virtual Private Cloud(Amazon VPC)를 사용하면 정의한 프라이빗 가상 네트워크에서 AWS 리소스를 시작할 수 있습니다. VPC 네트워킹 모드를 사용하도록 실행을 구성하여 HealthOmics 워크플로에 VPC의 리소스에 대한 액세스 권한을 부여할 수 있습니다. VPC 네트워킹이 활성화되면 VPC에 인터넷 액세스가 구성된 경우 실행이 VPC 내의 리소스에 액세스하고 퍼블릭 인터넷을 통해 외부 리소스에 연결할 수 있습니다.

VPC 네트워킹을 사용해야 하는 경우

실행에 다음이 필요한 경우 VPC 네트워킹을 사용합니다.

네트워킹 모드

HealthOmics 워크플로는 두 가지 네트워킹 모드를 지원합니다. 기본적으로 워크플로 실행은 제한 모드에서 작동합니다. 워크플로 실행을 시작할 때 실행별로 VPC 네트워킹을 활성화할 수 있습니다.

StartRun API의 networkingMode 파라미터를 사용하여 워크플로 실행을 시작할 때 네트워킹 모드를 지정합니다.

시작하기

이 섹션에서는 HealthOmics 워크플로에 대한 VPC 네트워킹을 처음으로 설정하는 방법을 안내합니다.

사전 조건

HealthOmics 워크플로에 대한 VPC 네트워킹을 구성하기 전에 다음이 있는지 확인합니다.

1단계: VPC 생성 또는 구성

프라이빗 서브넷, 보안 그룹 및 NAT 게이트웨이가 있는 VPC를 생성합니다(인터넷 액세스가 필요한 경우). step-by-step 지침은 단원을 참조하십시오VPC 연결 워크플로에 대한 인터넷 액세스.

2단계: 보안 그룹 구성

실행이 액세스해야 하는 대상으로의 아웃바운드 트래픽을 허용하는 보안 그룹을 생성합니다. 최소 권한 원칙에 따라 필요한 최소 아웃바운드 트래픽만 허용하도록 보안 그룹을 구성합니다.

예제 구성 및 자세한 지침은의 보안 그룹 섹션을 참조하세요VPC 연결 워크플로에 대한 인터넷 액세스.

3단계: 라우팅 테이블 확인

프라이빗 서브넷에 인터넷 액세스를 위한 NAT 게이트웨이에 대한 경로가 있는지 확인합니다. 라우팅 테이블 구성의 예는의 라우팅 테이블 섹션을 참조하세요VPC 연결 워크플로에 대한 인터넷 액세스.

4단계: 구성 리소스 생성

VPC 네트워킹 설정을 정의하는 HealthOmics 구성 리소스를 생성합니다.

aws omics create-configuration \
  --name my-vpc-config \
  --description "VPC configuration for genomics workflows" \
  --run-configurations '{
    "vpcConfig": {
      "securityGroupIds": ["sg-0123456789abcdef0"],
      "subnetIds": [
        "subnet-0a1b2c3d4e5f6g7h8",
        "subnet-1a2b3c4d5e6f7g8h9"
      ]
    }
  }' \
  --region us-west-2

네트워크 리소스가 프로비저닝되면 구성이에서 CREATING ACTIVE 상태로 전환됩니다. 이 작업은 최대 15분이 소요됩니다.

5단계: VPC 네트워킹으로 워크플로 실행 시작

구성이가 되면 VPC 네트워킹이 활성화된 상태에서 워크플로 실행을 ACTIVE시작합니다.

aws omics start-run \
  --workflow-id 1234567 \
  --role-arn arn:aws:iam::123456789012:role/OmicsWorkflowRole \
  --output-uri s3://my-bucket/outputs/ \
  --networking-mode VPC \
  --configuration-name my-vpc-config \
  --region us-west-2

6단계: 연결 확인

워크플로 실행을 모니터링하여 필요한 외부 리소스에 액세스할 수 있는지 확인합니다. CloudWatch Logs의 워크플로 로그에서 연결 성공 또는 실패 메시지를 확인합니다. 연결 테스트에 대한 자세한 지침은 섹션을 참조하세요VPC 연결 테스트.

VPC 요구 사항

VPC는 다음 요구 사항을 충족해야 합니다.

서브넷 요구 사항

보안 그룹 요구 사항

보안 그룹은 실행에 대한 인바운드 및 아웃바운드 트래픽을 제어합니다.

네트워크 인터페이스 요구 사항

HealthOmics는 VPC에 탄력적 네트워크 인터페이스(ENIs)를 프로비저닝하여 네트워크에 실행을 연결합니다. AWS 계정에 충분한 ENI 용량이 있는지 확인합니다(기본 한도: 리전당 5,000ENIs).

HealthOmics에서 생성한 ENIs에는 다음 태그가 지정됩니다.

"TagSet": [
  {
    "Key": "Service",
    "Value": "HealthOmics"
  },
  {
    "Key": "eniType",
    "Value": "CUSTOMER"
  }
]

구성 APIs

HealthOmics는 VPC 구성을 생성, 관리 및 삭제하는 APIs 제공합니다. 여러 워크플로 실행에서 구성을 재사용할 수 있습니다.

CreateConfiguration

VPC 네트워킹 설정을 사용하여 새 구성 리소스를 생성합니다. 단계별 예제는 4단계: 구성 리소스 생성 단원을 참조하십시오.

요청 구문:

aws omics create-configuration \
  --name configuration-name \
  --description description \
  --run-configurations '{"vpcConfig":{"securityGroupIds":["security-group-id"],"subnetIds":["subnet-id"]}}' \
  --tags Key=key,Value=value \
  --region region

파라미터:

응답:

{
  "arn": "arn:aws:omics:region:account-id:configuration/configuration-name",
  "uuid": "configuration-uuid",
  "name": "configuration-name",
  "runConfigurations": {
    "vpcConfig": {
      "securityGroupIds": ["security-group-id"],
      "subnetIds": ["subnet-id"],
      "vpcId": "vpc-id"
    }
  },
  "status": "CREATING",
  "creationTime": "timestamp",
  "tags": {}
}

구성 상태 값:

GetConfiguration

특정 구성의 세부 정보를 검색합니다.

요청 구문:

aws omics get-configuration \
  --name configuration-name \
  --region region

응답:

{
  "arn": "arn:aws:omics:region:account-id:configuration/configuration-name",
  "uuid": "configuration-uuid",
  "name": "configuration-name",
  "runConfigurations": {
    "vpcConfig": {
      "securityGroupIds": ["security-group-id"],
      "subnetIds": ["subnet-id"],
      "vpcId": "vpc-id"
    }
  },
  "status": "ACTIVE",
  "creationTime": "timestamp",
  "tags": {}
}

ListConfigurations

계정의 모든 구성을 나열합니다.

요청 구문:

aws omics list-configurations \
  --region region

응답:

{
  "items": [
    {
      "arn": "arn:aws:omics:region:account-id:configuration/configuration-name",
      "name": "configuration-name",
      "description": "description",
      "status": "ACTIVE",
      "creationTime": "timestamp"
    }
  ]
}

DeleteConfiguration

구성을 삭제합니다. 활성 워크플로 실행에서 현재 사용 중인 구성은 삭제할 수 없습니다.

요청 구문:

aws omics delete-configuration \
  --name configuration-name \
  --region region

VPC 네트워킹을 사용하여 워크플로 실행

VPC 네트워킹으로 실행 시작

워크플로 실행에서 VPC 네트워킹을 사용하려면 networking-mode 파라미터와를 지정합니다configuration-name.

aws omics start-run \
  --workflow-id 1234567 \
  --role-arn arn:aws:iam::123456789012:role/OmicsWorkflowRole \
  --output-uri s3://my-bucket/outputs/ \
  --networking-mode VPC \
  --configuration-name my-vpc-config \
  --region us-west-2

파라미터:

실행 네트워크 구성 보기

GetRun를 사용하여 실행에 대한 네트워킹 구성을 봅니다.

aws omics get-run \
  --id run-id \
  --region region

응답에는 네트워킹 모드, 구성 세부 정보 및 VPC 구성이 포함됩니다. 다음 예제는 응답의 VPC 관련 필드를 보여줍니다.

{
  "arn": "arn:aws:omics:region:account-id:run/run-id",
  "id": "run-id",
  "status": "status",
  "workflowId": "workflow-id",
  "networkingMode": "VPC",
  "configuration": {
    "name": "configuration-name",
    "arn": "arn:aws:omics:region:account-id:configuration/configuration-name",
    "uuid": "configuration-uuid"
  },
  "vpcConfig": {
    "subnets": ["subnet-id-1", "subnet-id-2"],
    "securityGroupIds": ["security-group-id"],
    "vpcId": "vpc-id"
  }
}

구성 불변성

워크플로는 실행이 시작될 때 존재했던 구성의 스냅샷을 사용합니다. 활성 실행에 영향을 주지 않고 실행 중에 구성을 안전하게 수정하거나 삭제할 수 있습니다.

통화 캐싱 고려 사항

통화 캐싱과 함께 VPC 네트워킹을 사용하는 경우 워크플로 엔진이 적절하게 구성되어 있는지 확인합니다. 엔진당 호출 캐싱에 대한 자세한 지침은 섹션을 참조하세요엔진별 캐싱 기능.

모범 사례

보안

성능

비용 최적화

Operational(작동)

VPC 네트워킹 할당량

다음 표에는 VPC 네트워킹 구성에 대한 할당량이 나열되어 있습니다.

할당량 증가를 요청하려면 Service Quotas 콘솔을 열고, AWS 서비스를 선택하고, AWS HealthOmics를 검색하고, 늘릴 할당량을 선택하고, 할당량 증가 요청을 선택합니다. 할당량 증가 요청은 일반적으로 영업일 기준 1~2일 이내에 처리됩니다.