Menyiapkan URL ramah untuk aplikasi OpenSearch UI (layanan mandiri)

Untuk mengatur URL ramah untuk aplikasi OpenSearch UI Anda

1. Buat file JSON yang memetakan nama ramah Anda ke URL aplikasi. Setiap kunci menjadi subdomain (misalnya, kunci prod menjadihttps://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"}
     ]
   }

   Simpan file ini sebagaiopensearch-ui-friendly-url-app-mappings-v1.json. Su v1 fiks mengidentifikasi ini sebagai versi pertama pemetaan Anda. Anda menambah versi ini saat memperbarui pemetaan Anda.

2. Unggah file pemetaan ke bucket Amazon S3 di akun Anda:

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

3. Ber CloudFront ikan izin untuk membaca file pemetaan dengan menambahkan kebijakan bucket. Ganti your-bucket-name dan your-account-id dengan nilai-nilai Anda:

   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"}}
       }]
     }'

   catatan

   Kebijakan bucket ini memungkinkan CloudFront untuk membaca file pemetaan selama KeyValueStore pembuatan. Tanpanya, penerapan tumpukan gagal dengan kesalahan “SourcEarn tidak dapat diakses”.

4. Terapkan CloudFormation tumpukan menggunakan salah satu opsi berikut:

   Opsi 1: Luncurkan Stack (disarankan)

   Salin URL berikut dan tempelkan ke browser Anda untuk membuka halaman pembuatan AWS CloudFormation cepat dengan template yang sudah dimuat sebelumnya. Isi parameter dan pilih Buat tumpukan.

   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

   Opsi 2: AWS CLI

   Ganti nilai placeholder dengan milik Anda sendiri:

   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. Jika Anda menggunakan AWS CLI (Opsi 2), gunakan tumpukan di Wil us-east-1 ayah. CloudFront membutuhkan sertifikat ACM untuk masukus-east-1. Aplikasi OpenSearch UI Anda dapat berada di Wilayah yang Didukung dan kuota OpenSearch UI mana pun.

6. Tunggu hingga tumpukan selesai (sekitar 15 menit). Anda dapat memantau kemajuan:

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

7. Uji pengalihan. Buka browser Anda dan arahkan kehttps://prod.your-domain.com. Anda harus diarahkan ke aplikasi OpenSearch UI Anda.

   Anda juga dapat memverifikasi dengancurl:

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

1. Edit file pemetaan Anda untuk menambah atau menghapus entri. Simpan dengan akhiran versi bertambah (misalnya,opensearch-ui-friendly-url-app-mappings-v2.json).

2. Unggah versi baru ke 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. Perbarui tumpukan dengan yang baru MappingsKey danMappingsVersion:

   Menggunakan konsol: Buka CloudFormation konsol, pilih tumpukan Anda, pilih Per barui, pilih Gunakan template saat ini, lalu perbarui MappingsVersion parameter MappingsKey dan dengan nilai-nilai baru.

   Menggunakan 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

Untuk mengatur pengalihan URL yang ramah tanpa Route 53

1. Minta sertifikat di ACM

   1. Buka konsol ACM di https://console.aws.amazon.com/acm/ di Wil us-east-1 ayah.

   2. Pilih Minta sertifikat.

   3. Untuk Nama domain, masukkan *.your-domain.com (sertifikat wildcard).

   4. Untuk Metode Validasi, pilih Validasi DNS.

   5. Pilih Minta.

   6. Pada halaman detail sertifikat, catat nama dan nilai rekaman CNAME di bawah Validasi Domain. Buat catatan CNAME ini di penyedia DNS Anda untuk memvalidasi kepemilikan domain.

   7. Tunggu status sertifikat berubah menjadi Diter bitkan (biasanya 5 hingga 30 menit setelah pembuatan catatan DNS).

2. Buat CloudFront KeyValueStore

   1. Buka CloudFront konsol di https://console.aws.amazon.com/cloudfront/.

   2. Di panel navigasi, pilih Fungsi. Kemudian pilih KeyValueStores tab.

   3. Pilih Buat KeyValueStore.

   4. Masukkan nama (misalnya,opensearch-ui-friendly-url-app-mappings-store).

   5. Pilih Buat.

   6. Setelah pembuatan, pilih Edit untuk menambahkan pasangan kunci-nilai. Untuk setiap aplikasi, tambahkan kunci (nama subdomain, sepertiprod) dan nilai (URL aplikasi OpenSearch UI lengkap).

3. Buat CloudFront fungsi

   1. Buka CloudFront konsol di https://console.aws.amazon.com/cloudfront/.

   2. Di panel navigasi, pilih Fungsi.

   3. Pada tab Functions, pilih Create function.

   4. Masukkan nama untuk fungsi (misalnya,opensearch-ui-friendly-url-redirect-function).

   5. Untuk Runtime, pilih cloudfront- js-2.0.

   6. Ganti kode fungsi dengan yang berikut:

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

      Ganti YOUR_KVS_ID dengan ID yang KeyValueStore Anda buat (terlihat di halaman KeyValueStore detail).

   7. Dalam KeyValueStore asosiasi, kaitkan yang KeyValueStore Anda buat.

   8. Pilih Simpan perubahan dan kemudian Publikasikan fungsi.

4. Buat CloudFront distribusi

   1. Di CloudFront konsol, pilih Buat distribusi.

   2. Untuk domain Origin, masukkan domain yang valid (misalnya,example.com). Asal tidak pernah dihubungi karena fungsi mengembalikan respons sebelum mencapainya.

   3. Di bawah Perilaku cache default, untuk kebijakan protokol Viewer, pilih Arahkan HTTP ke HTTPS.

   4. Untuk kebijakan Cache, pilih CachingDisabled.

   5. Di bawah Asosiasi fungsi, untuk Permintaan Pen ampil, pilih CloudFront fungsi Anda.

   6. Di bawah Peng aturan, untuk Nama domain alternatif (CNames), masukkan*.your-domain.com.

   7. Untuk sertifikat SSL khusus, pilih sertifikat yang Anda buat di ACM.

   8. Pilih Buat Distribusi.

   9. Perhatikan nama domain distribusi (misalnya,d1234abcdef8.cloudfront.net).

5. Konfigurasikan DNS di penyedia Anda

   Di penyedia DNS Anda, buat catatan CNAME yang menunjuk *.your-domain.com ke nama domain CloudFront distribusi Anda (misalnya,d1234abcdef8.cloudfront.net).

   catatan

   Beberapa penyedia DNS tidak mendukung catatan CNAME wildcard. Dalam hal ini, buat catatan CNAME individual untuk setiap subdomain yang ingin Anda gunakan (misalnya,prod.your-domain.com,staging.your-domain.com).

1. Buka CloudFront konsol di https://console.aws.amazon.com/cloudfront/.

2. Di panel navigasi, pilih Fungsi. Kemudian pilih KeyValueStores tab.

3. Pilih KeyValueStore nama Anda (misalnya,opensearch-ui-friendly-url-app-mappings-store).

4. Pilih Edit.

5. Pilih Tambah pasangan. Masukkan nama subdomain sebagai kunci dan URL aplikasi OpenSearch UI lengkap sebagai nilainya.

6. Pilih Simpan perubahan.