Configuración de una URL amigable para las aplicaciones de OpenSearch interfaz de usuario (autoservicio)

Para configurar una URL amigable para sus aplicaciones de OpenSearch interfaz de usuario

1. Crea un archivo JSON que asigne tus nombres descriptivos a las URL de las aplicaciones. Cada clave se convierte en un subdominio (por ejemplo, la clave prod se convierte enhttps://prod.example.com).

   {
     "data": [
       {"key": "prod", "value": "https://application-prod-abc123.us-west-2.opensearch.amazonaws.com"},
       {"key": "staging", "value": "https://application-staging-def456.us-east-1.opensearch.amazonaws.com"},
       {"key": "analytics", "value": "https://application-analytics-ghi789.eu-west-1.opensearch.amazonaws.com"}
     ]
   }

   Guarde este archivo como opensearch-ui-friendly-url-app-mappings-v1.json. El v1 sufijo lo identifica como la primera versión de sus mapeos. Esta versión se incrementa cuando se actualizan las asignaciones.

2. Suba el archivo de mapeos a un bucket de Amazon S3 de su cuenta:

   aws s3 cp opensearch-ui-friendly-url-app-mappings-v1.json \
     s3://your-bucket-name/opensearch-ui-friendly-url-app-mappings-v1.json

3. Conceda CloudFront permiso para leer el archivo de mapeos añadiendo una política de bucket. Sustituya your-bucket-name y por your-account-id sus valores:

   aws s3api put-bucket-policy \
     --bucket your-bucket-name \
     --policy '{
       "Version": "2012-10-17",
       "Statement": [{
         "Sid": "AllowCloudFrontKVSImport",
         "Effect": "Allow",
         "Principal": {"Service": "cloudfront.amazonaws.com"},
         "Action": "s3:GetObject",
         "Resource": "arn:aws:s3:::your-bucket-name/*",
         "Condition": {"StringEquals": {"aws:SourceAccount": "your-account-id"}}
       }]
     }'

   nota

   Esta política de bucket permite CloudFront leer el archivo de mapeos durante KeyValueStore la creación. Sin él, la implementación de la pila falla y aparece el error «SourceARN es inaccesible».

4. Implemente la CloudFormation pila mediante una de las siguientes opciones:

   Opción 1: Launch Stack (recomendado)

   Copia la siguiente URL y pégala en tu navegador para abrir la página de AWS CloudFormation creación rápida con la plantilla precargada. Rellene los parámetros y seleccione Crear pila.

   https://us-east-1.console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/quickcreate?templateURL=https://opensearch-ui-quickstart-sample-cfn-templates.s3.us-west-2.amazonaws.com/opensearch-ui-friendly-url/main.yaml&stackName=opensearch-ui-friendly-url&param_MappingsVersion=v1

   Opción 2: AWS CLI

   Sustituya los valores del marcador de posición por los suyos propios:

   aws cloudformation create-stack \
     --stack-name opensearch-ui-friendly-url \
     --template-url https://opensearch-ui-quickstart-sample-cfn-templates.s3.us-west-2.amazonaws.com/opensearch-ui-friendly-url/main.yaml \
     --parameters \
       ParameterKey=DomainName,ParameterValue=your-domain.com \
       ParameterKey=HostedZoneId,ParameterValue=Z0123456789ABCDEFG \
       ParameterKey=MappingsBucket,ParameterValue=your-bucket-name \
       ParameterKey=MappingsKey,ParameterValue=opensearch-ui-friendly-url-app-mappings-v1.json \
       ParameterKey=MappingsVersion,ParameterValue=v1 \
     --region us-east-1

5. Si usó la AWS CLI (opción 2), implemente la pila en la us-east-1 región. CloudFront requiere que estén incluidos los certificados de ACM. us-east-1 Sus aplicaciones de OpenSearch interfaz de usuario pueden estar en cualquier región admitida y con cuotas de OpenSearch interfaz de usuario.

6. Espera a que se complete la pila (aproximadamente 15 minutos). Puedes supervisar el progreso:

   aws cloudformation wait stack-create-complete \
     --stack-name opensearch-ui-friendly-url \
     --region us-east-1

7. Prueba la redirección. Abre tu navegador y navega hastahttps://prod.your-domain.com. Debería ser redirigido a su aplicación de OpenSearch interfaz de usuario.

   También puedes verificarlo concurl:

   curl -I https://prod.your-domain.com
   # Expected: HTTP/2 302
   # location: https://application-prod-abc123.us-west-2.opensearch.amazonaws.com

1. Edite el archivo de mapeos para agregar o eliminar entradas. Guárdelo con un sufijo de versión incrementada (por ejemplo,). opensearch-ui-friendly-url-app-mappings-v2.json

2. Suba la nueva versión a S3:

   aws s3 cp opensearch-ui-friendly-url-app-mappings-v2.json \
     s3://your-bucket-name/opensearch-ui-friendly-url-app-mappings-v2.json

3. Actualice la pila con la nueva MappingsKey yMappingsVersion:

   Uso de la consola: abre la CloudFormation consola, selecciona tu pila, elige Actualizar, selecciona Usar la plantilla actual y, a continuación, actualiza los MappingsVersion parámetros MappingsKey y con los nuevos valores.

   Uso de la AWS CLI:

   aws cloudformation update-stack \
     --stack-name opensearch-ui-friendly-url \
     --use-previous-template \
     --parameters \
       ParameterKey=DomainName,UsePreviousValue=true \
       ParameterKey=HostedZoneId,UsePreviousValue=true \
       ParameterKey=MappingsBucket,UsePreviousValue=true \
       ParameterKey=MappingsKey,ParameterValue=opensearch-ui-friendly-url-app-mappings-v2.json \
       ParameterKey=MappingsVersion,ParameterValue=v2 \
     --region us-east-1

Para configurar un redireccionamiento de URL amigable sin Route 53

1. Solicite un certificado en ACM

   1. Abra la consola de ACM https://console.aws.amazon.com/acm/ en la us-east-1 región.

   2. Elija Solicitar certificado.

   3. En Nombre de dominio, introduzca *.your-domain.com (certificado comodín).

   4. En Método de validación, elija la validación de DNS.

   5. Seleccione Solicitar.

   6. En la página de detalles del certificado, anote el nombre y el valor del registro CNAME en Validación del dominio. Crea este registro CNAME en tu proveedor de DNS para validar la propiedad del dominio.

   7. Espera a que el estado del certificado cambie a Emitido (normalmente entre 5 y 30 minutos después de la creación del registro DNS).

2. Crea un CloudFront KeyValueStore

   1. Abra la CloudFront consola en https://console.aws.amazon.com/cloudfront/.

   2. Seleccione Funciones en el panel de navegación. Luego elige la KeyValueStores pestaña.

   3. Seleccione Crear KeyValueStore.

   4. Introduzca un nombre (por ejemplo,opensearch-ui-friendly-url-app-mappings-store).

   5. Seleccione Crear.

   6. Tras la creación, elija Editar para añadir pares clave-valor. Para cada aplicación, añada una clave (el nombre del subdominio, por ejemploprod) y un valor (la URL completa de la aplicación de OpenSearch interfaz de usuario).

3. Crea una función CloudFront

   1. Abra la CloudFront consola en https://console.aws.amazon.com/cloudfront/.

   2. Seleccione Funciones en el panel de navegación.

   3. En la pestaña Funciones, seleccione Crear función.

   4. Introduzca un nombre para la función (por ejemplo,opensearch-ui-friendly-url-redirect-function).

   5. Para Runtime, elija cloudfront-js-2.0.

   6. Sustituya el código de función por el siguiente:

      import cf from 'cloudfront';
      
      const kvsHandle = cf.kvs("YOUR_KVS_ID");
      
      async function handler(event) {
        var request = event.request;
        var host = request.headers.host.value;
        var subdomain = host.split('.')[0];
      
        try {
          var targetUrl = await kvsHandle.get(subdomain);
          return {
            statusCode: 302,
            statusDescription: 'Found',
            headers: {
              'location': { value: targetUrl },
              'cache-control': { value: 'no-cache, no-store, must-revalidate' }
            }
          };
        } catch (e) {
          return {
            statusCode: 404,
            statusDescription: 'Not Found',
            headers: { 'content-type': { value: 'text/html' } },
            body: {
              encoding: 'text',
              data: '<html><body><h1>Application Not Found</h1><p>No OpenSearch application is mapped to the requested subdomain.</p></body></html>'
            }
          };
        }
      }

      YOUR_KVS_IDSustitúyalo por el ID del KeyValueStore que creó (visible en la página de KeyValueStore detalles).

   7. En KeyValueStore las asociaciones, asocia las KeyValueStore que creaste.

   8. Seleccione Guardar cambios y, a continuación, la función Publicar.

4. Crea una CloudFront distribución

   1. En la CloudFront consola, elija Crear distribución.

   2. Para el dominio Origin, introduce cualquier dominio válido (por ejemplo,example.com). Nunca se contacta con el origen porque la función devuelve una respuesta antes de llegar a él.

   3. En Comportamiento predeterminado de la caché, para la política de protocolo de Viewer, elija Redirigir HTTP a HTTPS.

   4. Para la política de caché, elija CachingDisabled.

   5. En Asociaciones de funciones, para la solicitud del visor, seleccione su CloudFront función.

   6. En Configuración, para Nombres de dominio alternativos (CNAME), introduzca*.your-domain.com.

   7. Para el certificado SSL personalizado, selecciona el certificado que creaste en ACM.

   8. Elija Crear distribución.

   9. Anote el nombre del dominio de distribución (por ejemplo,d1234abcdef8.cloudfront.net).

5. Configure el DNS en su proveedor

   En tu proveedor de DNS, crea un registro CNAME que apunte *.your-domain.com a tu nombre de dominio de CloudFront distribución (por ejemplo,d1234abcdef8.cloudfront.net).

   nota

   Algunos proveedores de DNS no admiten registros CNAME con caracteres comodín. En ese caso, crea registros CNAME individuales para cada subdominio que quieras usar (por ejemplo,). prod.your-domain.com staging.your-domain.com

1. Abra la CloudFront consola en. https://console.aws.amazon.com/cloudfront/

2. Seleccione Funciones en el panel de navegación. Luego elige la KeyValueStores pestaña.

3. Elige tu KeyValueStore nombre (por ejemplo,opensearch-ui-friendly-url-app-mappings-store).

4. Elija Edit (Edición de).

5. Selecciona Añadir par. Introduzca el nombre del subdominio como clave y la URL completa de la aplicación de OpenSearch interfaz de usuario como valor.

6. Seleccione Save changes (Guardar cambios).