Impostazione di un URL intuitivo per le applicazioni OpenSearch dell'interfaccia utente (self-service)

Per impostare un URL descrittivo per le tue applicazioni UI OpenSearch

1. Crea un file JSON che associa i tuoi nomi descrittivi agli URL delle applicazioni. Ogni chiave diventa un sottodominio (ad esempio, la chiave prod diventa). https://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"}
     ]
   }

   Salva questo file come opensearch-ui-friendly-url-app-mappings-v1.json. Il v1 suffisso la identifica come la prima versione delle tue mappature. Questa versione viene incrementata quando si aggiornano le mappature.

2. Carica il file di mappatura in un bucket Amazon S3 nel tuo account:

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

3. Concedi CloudFront il permesso di leggere il file di mappatura aggiungendo una bucket policy. Sostituisci your-bucket-name e your-account-id con i tuoi valori:

   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

   Questa policy del bucket consente di CloudFront leggere il file di mappatura durante la creazione. KeyValueStore Senza di essa, la distribuzione dello stack fallisce con un errore «SourceARN is inaccessible».

4. Distribuisci lo CloudFormation stack utilizzando una delle seguenti opzioni:

   Opzione 1: Avvia Stack (consigliata)

   Copia il seguente URL e incollalo nel browser per aprire la pagina di AWS CloudFormation creazione rapida con il modello precaricato. Inserisci i parametri e scegli Crea stack.

   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

   Opzione 2: AWS CLI

   Sostituisci i valori segnaposto con i tuoi:

   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. Se hai utilizzato la AWS CLI (opzione 2), distribuisci lo stack nella regione. us-east-1 CloudFront richiede l'installazione dei certificati ACM. us-east-1 Le applicazioni OpenSearch dell'interfaccia utente possono trovarsi in qualsiasi regione supportata e con qualsiasi quota per OpenSearch l'interfaccia utente.

6. Attendi il completamento dello stack (circa 15 minuti). Puoi monitorare i progressi:

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

7. Prova il reindirizzamento. Apri il browser e vai a. https://prod.your-domain.com Dovresti essere reindirizzato alla tua applicazione OpenSearch UI.

   Puoi anche verificare concurl:

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

1. Modifica il file di mappatura per aggiungere o rimuovere voci. Salvalo con un suffisso di versione incrementato (ad esempio,). opensearch-ui-friendly-url-app-mappings-v2.json

2. Carica la nuova versione su 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. Aggiorna lo stack con il nuovo MappingsKey eMappingsVersion:

   Uso della console: apri la CloudFormation console, seleziona lo stack, scegli Aggiorna, seleziona Usa modello corrente, quindi aggiorna i MappingsVersion parametri MappingsKey e con i nuovi valori.

   Utilizzando 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

Per impostare un reindirizzamento URL intuitivo senza Route 53

1. Richiedi un certificato in ACM

   1. Apri la console ACM all'indirizzo https://console.aws.amazon.com/acm/ in the us-east-1 Region.

   2. Scegli Richiedi certificato.

   3. Per Nome di dominio, inserisci *.your-domain.com (certificato wildcard).

   4. Per il metodo di convalida, scegli la convalida DNS.

   5. Scegli Richiedi.

   6. Nella pagina dei dettagli del certificato, annota il nome e il valore del record CNAME in Convalida del dominio. Crea questo record CNAME presso il tuo provider DNS per convalidare la proprietà del dominio.

   7. Attendi che lo stato del certificato passi a Emesso (in genere da 5 a 30 minuti dopo la creazione del record DNS).

2. Crea un CloudFront KeyValueStore

   1. Apri la CloudFront console all'indirizzo https://console.aws.amazon.com/cloudfront/.

   2. Nel riquadro di navigazione, seleziona Funzioni. Quindi scegli la KeyValueStores scheda.

   3. Scegli Create KeyValueStore (Crea).

   4. Inserisci un nome (ad esempio,opensearch-ui-friendly-url-app-mappings-store).

   5. Scegli Create (Crea).

   6. Dopo la creazione, scegli Modifica per aggiungere coppie chiave-valore. Per ogni applicazione, aggiungi una chiave (il nome del sottodominio, ad esempioprod) e un valore (l'URL completo dell'applicazione OpenSearch UI).

3. Crea una funzione CloudFront

   1. Apri la CloudFront console all'indirizzo https://console.aws.amazon.com/cloudfront/.

   2. Nel riquadro di navigazione, seleziona Funzioni.

   3. Nella scheda Funzioni, scegli Crea funzione.

   4. Inserisci un nome per la funzione (ad esempio,opensearch-ui-friendly-url-redirect-function).

   5. Per Runtime, scegli cloudfront-js-2.0.

   6. Sostituisci il codice della funzione con quanto segue:

      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>'
            }
          };
        }
      }

      Sostituisci YOUR_KVS_ID con l'ID KeyValueStore che hai creato (visibile nella pagina dei KeyValueStore dettagli).

   7. Nelle KeyValueStore associazioni, associa quelle KeyValueStore che hai creato.

   8. Scegli Salva modifiche e poi la funzione Pubblica.

4. Crea una CloudFront distribuzione

   1. Nella CloudFront console, scegli Crea distribuzione.

   2. Per il dominio Origin, inserisci un dominio valido (ad esempio,example.com). L'origine non viene mai contattata perché la funzione restituisce una risposta prima di raggiungerla.

   3. In Comportamento predefinito della cache, per i criteri del protocollo Viewer, scegli Reindirizza HTTP a HTTPS.

   4. Per la politica della cache, scegli CachingDisabled.

   5. In Associazioni di funzioni, per la richiesta di Viewer, seleziona la tua CloudFront funzione.

   6. In Impostazioni, per Nomi di dominio alternativi (CNAME), inserisci. *.your-domain.com

   7. Per il certificato SSL personalizzato, seleziona il certificato che hai creato in ACM.

   8. Scegli Create Distribution (Crea distribuzione).

   9. Annota il nome del dominio di distribuzione (ad esempio,d1234abcdef8.cloudfront.net).

5. Configura il DNS presso il tuo provider

   Nel tuo provider DNS, crea un record CNAME che punti *.your-domain.com al tuo nome di dominio di CloudFront distribuzione (ad esempio,). d1234abcdef8.cloudfront.net

   Nota

   Alcuni provider DNS non supportano i record CNAME wildcard. In tal caso, crea singoli record CNAME per ogni sottodominio che desideri utilizzare (ad esempio,,). prod.your-domain.com staging.your-domain.com

1. Apri la CloudFront console all'indirizzo. https://console.aws.amazon.com/cloudfront/

2. Nel riquadro di navigazione, seleziona Funzioni. Quindi scegli la KeyValueStores scheda.

3. Scegli il tuo KeyValueStore nome (ad esempio,opensearch-ui-friendly-url-app-mappings-store).

4. Scegli Modifica.

5. Scegli Aggiungi coppia. Inserisci il nome del sottodominio come chiave e l'URL completo dell'applicazione OpenSearch UI come valore.

6. Scegli Save changes (Salva modifiche).