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 su VPC configurando sus ejecuciones para que usen el modo de red de la VPC. Cuando las redes de VPC están habilitadas, tus ejecuciones pueden acceder a los recursos de tu VPC y conectarse a recursos externos a través de la Internet pública si tu VPC tiene configurado el acceso a Internet.

Cuándo usar las redes de VPC

Usa redes de VPC cuando tus ejecuciones necesiten:

Modos de redes

HealthOmics Workflows admite dos modos de red. De forma predeterminada, las ejecuciones de 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 la ejecución de un flujo de trabajo mediante el networkingMode parámetro de la StartRun API.

Introducción

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

Requisitos previos

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

Paso 1: Cree o configure su 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 los grupos de seguridad

Cree un grupo de seguridad que permita que el tráfico saliente llegue a los destinos a los que necesitan acceder sus 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 acceder 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: Crear un recurso de configuración

Crea un recurso HealthOmics de configuración que defina la configuración 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 ACTIVE estado CREATING a estado una vez que se aprovisionen los recursos de red. Esto tarda hasta 15 minutos.

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

Una vez 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 de su flujo de trabajo para comprobar que puede acceder a los recursos externos necesarios. Consulta los registros del flujo de trabajo en CloudWatch los registros para ver si hay mensajes de éxito o error en la conexión. Para obtener una guía detallada sobre cómo probar la conectividad, consulteProbar la conectividad de la VPC.

Requisitos de la VPC

Su VPC debe cumplir los siguientes requisitos:

Requisitos de la subred

Requisitos del grupo de seguridad

Los grupos de seguridad controlan el tráfico entrante y saliente de sus ejecuciones.

Requisitos de la interfaz de red

HealthOmics aprovisiona interfaces de red elásticas (ENI) en su VPC para conectar las redes a su 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 la configuración de red de la VPC. Para obtener un ejemplo paso a paso, consulte Paso 4: Crear 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 de estado de 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 puede eliminar una configuración que esté siendo utilizada actualmente por las ejecuciones de flujo 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

Iniciar 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 y ejecución de la configuración de red

GetRunUtilícela para ver la configuración de red para 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 recursos de configuración son inmutables: después de crear una configuración, no puede cambiar sus valores. Para usar diferentes ajustes de red, cree una nueva configuración. No puede eliminar una configuración mientras la estén usando las ejecuciones de flujo de trabajo activas; la DeleteConfiguration solicitud se rechaza hasta que esas ejecuciones lleguen a un estado terminal.

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 correctamente. Para obtener instrucciones detalladas sobre el almacenamiento en caché de llamadas 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, abre la consola de cuotas de servicio , elige AWS los servicios AWS HealthOmics, busca, selecciona la cuota que quieres aumentar y elige 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.