Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Conexión de HealthOmics flujos de trabajo a una VPC

Con Amazon Virtual Private Cloud (Amazon VPC), puede lanzar AWS recursos en una red virtual privada que haya definido. Puede dar a sus HealthOmics flujos de trabajo acceso a los recursos de la VPC configurando las ejecuciones para que usen el modo de red de la VPC. Cuando las redes de VPC están habilitadas, las carreras pueden acceder a los recursos de la VPC y conectarse a recursos externos a través de la Internet pública si la VPC tiene configurado el acceso a Internet.

Cuándo utilizar las redes de VPC

Utilice redes de VPC cuando sus carreras necesiten:

Modos de redes

HealthOmics Los flujos de trabajo admiten dos modos de red. De forma predeterminada, las ejecuciones del flujo de trabajo funcionan en modo RESTRINGIDO. Puede habilitar las redes de VPC por ejecución al iniciar la ejecución del flujo de trabajo.

El modo de red se especifica al iniciar una ejecución de flujo de trabajo mediante el networkingMode parámetro de la StartRun API.

Introducción

En esta sección, se explica cómo configurar las redes de VPC para los HealthOmics flujos de trabajo por primera vez.

Requisitos previos

Antes de configurar las redes de VPC para los HealthOmics flujos de trabajo, asegúrese de tener lo siguiente:

Paso 1: Crear o configurar la VPC

Cree una VPC con subredes privadas, grupos de seguridad y puertas de enlace NAT (si necesita acceso a Internet). Para obtener instrucciones detalladas paso a paso, consulte. Acceso a Internet para VPC-connected flujos de trabajo

Paso 2: Configurar grupos de seguridad

Crea un grupo de seguridad que permita el tráfico saliente a los destinos a los que deben acceder tus carreras. Configure los grupos de seguridad para permitir solo el tráfico saliente mínimo requerido siguiendo el principio de privilegios mínimos.

Para ver ejemplos de configuraciones y una guía detallada, consulte la sección sobre grupos de seguridad enAcceso a Internet para VPC-connected flujos de trabajo.

Paso 3: Verificar las tablas de rutas

Asegúrese de que sus subredes privadas tengan rutas a una puerta de enlace NAT para el acceso a Internet. Para ver ejemplos de configuraciones de tablas de rutas, consulte la sección de tablas de rutas enAcceso a Internet para VPC-connected flujos de trabajo.

Paso 4: Cree un recurso de configuración

Cree un recurso HealthOmics de configuración que defina los ajustes de red de la VPC:

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

La configuración pasará de un ACTIVE estado CREATING a otro una vez que se aprovisionen los recursos de red. Esto puede tardar hasta 15 minutos.

Paso 5: Iniciar una ejecución de flujo de trabajo con redes de VPC

Una vez que esté configuradaACTIVE, inicie una ejecución de flujo de trabajo con las redes de VPC habilitadas:

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

Paso 6: Verificar la conectividad

Supervise la ejecución del flujo de trabajo para comprobar que puede acceder a los recursos externos necesarios. Comprueba los registros del flujo de trabajo en CloudWatch los registros para ver si hay mensajes de conexión correcta o incorrecta. Para obtener una guía detallada sobre las pruebas de conectividad, consultePrueba de conectividad de VPC.

Requisitos de la VPC

Su VPC debe cumplir los siguientes requisitos:

Requisitos de subred

Requisitos del grupo de seguridad

Los grupos de seguridad controlan el tráfico entrante y saliente de tus carreras.

Requisitos de la interfaz de red

HealthOmics aprovisiona interfaces de red elásticas (ENI) en la VPC para conectar las carreras a la red. Asegúrese de que su AWS cuenta tenga suficiente capacidad de ENI (límite predeterminado: 5000 ENI por región).

Los ENI creados por HealthOmics se etiquetan con las siguientes etiquetas:

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

API de configuración

HealthOmics proporciona API para crear, administrar y eliminar configuraciones de VPC. Puede reutilizar las configuraciones en varias ejecuciones de flujo de trabajo.

CreateConfiguration

Crea un nuevo recurso de configuración con los ajustes de red de la VPC. Para obtener un ejemplo paso a paso, consulte Paso 4: Cree un recurso de configuración.

Sintaxis de la solicitud:

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

Parámetros:

Respuesta:

{
  "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": {}
}

Valores del estado de la configuración:

GetConfiguration

Recupera los detalles de una configuración específica.

Sintaxis de la solicitud:

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

Respuesta:

{
  "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

Muestra todas las configuraciones de su cuenta.

Sintaxis de la solicitud:

aws omics list-configurations \
  --region region

Respuesta:

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

DeleteConfiguration

Elimina una configuración. No se puede eliminar una configuración que esté siendo utilizada actualmente por las ejecuciones de flujos de trabajo activas.

Sintaxis de la solicitud:

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

Ejecución de flujos de trabajo con redes de VPC

Inicio de una ejecución con redes de VPC

Para usar redes de VPC en una ejecución de flujo de trabajo, especifique el networking-mode parámetro y: 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

Parámetros:

Visualización, ejecución, configuración de red

Se utiliza GetRun para ver la configuración de red de una ejecución:

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

La respuesta incluye el modo de red, los detalles de configuración y la configuración de la VPC. El siguiente ejemplo muestra los VPC-related campos de la respuesta:

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

Inmutabilidad de la configuración

Los flujos de trabajo utilizan una instantánea de la configuración tal como estaba cuando se inició la ejecución. Puede modificar o eliminar las configuraciones de forma segura durante la ejecución de la ejecución sin que ello afecte a las ejecuciones activas.

Consideraciones sobre el almacenamiento en caché de llamadas

Cuando utilices redes de VPC con almacenamiento en caché de llamadas, asegúrate de que tu motor de flujo de trabajo esté configurado adecuadamente. Para obtener una guía detallada sobre el almacenamiento de llamadas en caché por motor, consulte. Engine-specific funciones de almacenamiento en caché

Prácticas recomendadas

Seguridad

Desempeño

Optimización de costos

Operational (En funcionamiento)

Cuotas de redes de VPC

En la siguiente tabla se enumeran las cuotas para las configuraciones de redes de VPC:

Para solicitar un aumento de cuota, abra la consola Service Quotas, elija AWS los servicios AWS HealthOmics, busque, seleccione la cuota que desee aumentar y elija Solicitar aumento de cuota. Por lo general, las solicitudes de aumento de cuota se procesan en un plazo de 1 a 2 días laborables.