Membuat AWS Cloud Map namespace - AWS Cloud Map
Nilai yang Anda tentukan saat membuat namespace

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Membuat AWS Cloud Map namespace

Untuk membuat namespace, lakukan prosedur berikut.

AWS Management Console

  1. Masuk ke AWS Management Console dan buka AWS Cloud Map konsol di https://console.aws.amazon.com/cloudmap/.

  2. Pilih Buat namespace.

  3. Pada Buat namespace halaman, memasukkan nilai yang berlaku. Untuk informasi lebih lanjut, lihat Nilai yang Anda tentukan saat membuat namespace.

  4. Pilih Buat namespace.

AWS CLI

  • Buat namespace dengan perintah untuk jenis penemuan instance yang Anda inginkan (ganti nilai merah dengan milik Anda sendiri).

    • Buat namespace HTTP menggunakan. create-http-namespace Contoh layanan yang terdaftar menggunakan namespace HTTP dapat ditemukan menggunakan DiscoverInstances permintaan, tetapi tidak dapat ditemukan menggunakan DNS.

      aws servicediscovery create-http-namespace --name name-of-namespace

    • Buat namespace pribadi berdasarkan DNS dan hanya terlihat di dalam VPC Amazon tertentu menggunakan. create-private-dns-namespace Anda dapat menemukan instance yang terdaftar dengan namespace DNS pribadi dengan menggunakan permintaan atau menggunakan DNS DiscoverInstances

      aws servicediscovery create-private-dns-namespace --name name-of-namespace --vpc vpc-xxxxxxxxx

    • Buat namespace publik berdasarkan DNS yang terlihat di internet menggunakan. create-public-dns-namespace Anda dapat menemukan instans yang didaftarkan dengan namespace DNS publik dengan menggunakan permintaan DiscoverInstances atau menggunakan DNS.

      aws servicediscovery create-public-dns-namespace --name name-of-namespace
      catatan
      Persyaratan namespace:

      • Ruang nama yang dikonfigurasi untuk kueri DNS publik harus diakhiri dengan domain tingkat atas (misalnya..com).

      • Nama namespace dapat memiliki hingga 1.024 karakter, dan harus dimulai dan diakhiri dengan huruf.

      • Karakter yang valid: a-z, A-Z, 0-9,. (titik), _ (garis bawah), dan - (tanda hubung).

AWS SDK for Python (Boto3)

  1. Jika Anda belum Boto3 menginstal, Anda dapat menemukan petunjuk untuk menginstal, mengkonfigurasi, dan menggunakan Boto3 di sini.

  2. Impor Boto3 dan gunakan servicediscovery sebagai layanan Anda.

    import boto3
client = boto3.client('servicediscovery')

  3. Buat namespace dengan perintah untuk jenis penemuan instance yang Anda inginkan (ganti nilai merah dengan milik Anda sendiri):

    • Buat namespace HTTP menggunakan. create_http_namespace() Contoh layanan yang terdaftar menggunakan namespace HTTP dapat ditemukan menggunakandiscover_instances(), tetapi tidak dapat ditemukan menggunakan DNS.

      response = client.create_http_namespace(
    Name='name-of-namespace',
)
# If you want to see the response
print(response)

    • Buat namespace pribadi berdasarkan DNS dan hanya terlihat di dalam VPC Amazon tertentu menggunakan. create_private_dns_namespace() Anda dapat menemukan instance yang terdaftar dengan namespace DNS pribadi dengan menggunakan salah satu atau menggunakan DNS discover_instances()

      response = client.create_private_dns_namespace(
    Name='name-of-namespace',
    Vpc='vpc-1c56417b',
)
# If you want to see the response
print(response)

    • Buat namespace publik berdasarkan DNS yang terlihat di internet menggunakan. create_public_dns_namespace() Anda dapat menemukan instance yang terdaftar dengan namespace DNS publik dengan menggunakan salah satu atau discover_instances() menggunakan DNS.

      response = client.create_public_dns_namespace(
    Name='name-of-namespace',
)
# If you want to see the response
print(response)

    • Contoh keluaran respons

      {
    'OperationId': 'gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd',
    'ResponseMetadata': {
        '...': '...',
    },
}
      catatan
      Persyaratan namespace:

      • Ruang nama yang dikonfigurasi untuk kueri DNS publik harus diakhiri dengan domain tingkat atas (misalnya..com).

      • Nama namespace dapat memiliki hingga 1.024 karakter, dan harus dimulai dan diakhiri dengan huruf.

      • Karakter yang valid: a-z, A-Z, 0-9,. (titik), _ (garis bawah), dan - (tanda hubung).

Nilai yang Anda tentukan saat membuat namespace

Saat Anda membuat AWS Cloud Map namespace, Anda menentukan nilai berikut.

catatan

Setelah Anda membuat namespace, Anda dapat mengubah tag. Namun, Anda tidak dapat mengubah nilai-nilai lain.

Nilai-nilai

Nama namespace

Nama yang Anda tentukan untuk namespace tergantung pada bagaimana Anda ingin aplikasi Anda untuk menemukan instans. Metode bagaimana contoh ditemukan ditentukan oleh opsi yang Anda pilih untuk Penemuan instans. Opsi muncul nanti pada halaman saat ini di konsol. Mereka adalah sebagai berikut:

Panggilan API

Jika Anda memilih opsi ini, aplikasi Anda akan menemukan instance layanan dengan menentukan nama namespace dan nama layanan dalam permintaan. DiscoverInstances Untuk informasi selengkapnya, lihat DiscoverInstances di dalam Referensi API AWS Cloud Map .

Anda dapat menentukan nama dengan panjang hingga 1.024 karakter. Nama dapat berisi huruf besar dan huruf kecil, angka, garis bawah (_), dan tanda hubung (-).

API panggilan dan permintaan DNS dalam VPC

Masukkan nama domain yang Anda inginkan aplikasi Anda dalam VPC untuk digunakan ketika mereka menemukan instance dengan mengirimkan kueri DNS. AWS Cloud Map secara otomatis membuat zona host pribadi Amazon Route 53 yang memiliki nama ini. Ketika Anda mendaftar instans layanan, AWS Cloud Map menciptakan data DNS di zona yang di-hosting yang memiliki nama dalam format berikut:

nama layanan.Namespace

Jika Anda memilih opsi ini, aplikasi Anda juga dapat menemukan instance dengan menentukan nama namespace dan nama layanan dalam permintaan. DiscoverInstances Untuk informasi selengkapnya, lihat DiscoverInstances di dalam Referensi API AWS Cloud Map .

Anda dapat menentukan nama domain yang diinternasionalisasi (IDN) jika Anda mengubah namanya menjadi Punycode terlebih dahulu. Untuk informasi tentang pengubah online, lakukan pencarian internet di "punycode converter".

Anda juga dapat mengubah nama domain yang diinternasionalisasi menjadi Punycode saat Anda membuat namespace secara terprogram. Misalnya, jika Anda menggunakan Java, Anda dapat mengkonversi nilai Unicode ke Punycode dengan menggunakan toASCII metode perpustakaan java.net.IDN.

Panggilan API dan kueri DNS publik

Masukkan nama domain yang ingin digunakan aplikasi Anda saat menemukan instans dengan mengirimkan kueri DNS publik. Ini harus berupa nama domain yang telah Anda daftarkan. Saat Anda membuat namespace, AWS Cloud Map secara otomatis membuat zona host publik Amazon Route 53 yang memiliki nama yang sama. Ketika Anda mendaftar instans layanan, AWS Cloud Map menciptakan data DNS di zona yang di-hosting yang memiliki nama dalam format berikut:

nama layanan.Namespace

Jika Anda memilih opsi ini, aplikasi Anda juga dapat menemukan instance dengan menentukan nama namespace dan nama layanan dalam permintaan. DiscoverInstances Untuk informasi selengkapnya, lihat DiscoverInstances di dalam Referensi API AWS Cloud Map .

Anda dapat menentukan nama domain yang diinternasionalisasi (IDN) jika Anda mengubah namanya menjadi Punycode terlebih dahulu. Untuk informasi tentang pengubah online, lakukan pencarian internet di "punycode converter".

Anda juga dapat mengubah nama domain yang diinternasionalisasi menjadi Punycode saat Anda membuat namespace secara terprogram. Misalnya, jika Anda menggunakan Java, Anda dapat mengubah nilai Unicode ke Punycode dengan menggunakan toASCII metode java.net.IDN perpustakaan.

Deskripsi namespace

Memasukkan deskripsi untuk namespace. Nilai yang Anda masukkan di sini muncul di halaman Namespace dan pada halaman detail untuk setiap namespace.

Penemuan instans

Pilih bagaimana Anda ingin aplikasi Anda menemukan instans terdaftar:

Panggilan API

Pilih opsi ini jika Anda ingin aplikasi Anda hanya menggunakan panggilan API untuk menemukan instans terdaftar.

API panggilan dan kueri DNS dalam VPC

Pilih opsi ini jika Anda ingin aplikasi Anda untuk dapat menemukan instans menggunakan panggilan API atau menggunakan kueri DNS di VPC. Anda tidak diharuskan untuk menggunakan kedua metode.

Panggilan API dan kueri DNS publik

Pilih opsi ini jika Anda ingin aplikasi Anda untuk dapat menemukan instans menggunakan panggilan API atau menggunakan kueri DNS publik. Anda tidak diharuskan untuk menggunakan kedua metode.

SOA TTL

Untuk Panggilan API dan kueri DNS dalam VPC atau Panggilan API dan kueri DNS publik, nilai waktu untuk tayang (TTL) untuk memulai otoritas (SOA) catatan DNS zona yang dihosting Route 53 dibuat dengan namespace Anda. Nilai menentukan berapa lama DNS penyelesaikan informasi cache untuk catatan ini sebelum penyelesai meneruskan kueri DNS lain untuk Amazon Route 53 untuk mendapatkan pengaturan yang diperbarui. Nilai yang lebih kecil juga akan mengurangi waktu entri yang hilang akan di-cache (caching negatif) dengan mengorbankan kueri tambahan untuk namespace tersebut.

Tanda

Anda dapat menentukan satu atau lebih tag untuk ditambahkan ke namespace Anda. Tag adalah label opsional yang dapat Anda tetapkan ke AWS sumber daya. Setiap tanda terdiri dari kunci dan nilai. Misalnya, Anda dapat menentukan tanda dengan Kunci = Lingkungan dan Nilai = Produksi. Tag memungkinkan Anda untuk mengkategorikan AWS sumber daya Anda sehingga Anda dapat lebih mudah mengelolanya.

Anda dapat memperbarui atau menghapus tanda pada namespace Anda setelah mereka dibuat. Untuk informasi lebih lanjut, lihat Menandai sumber daya AWS Cloud Map Anda.

VPC

Saat Anda memilih panggilan API dan kueri DNS di VPC untuk nilai penemuan Instans, AWS Cloud Map buat zona host pribadi Amazon Route 53 yang memiliki nama yang sama. AWS Cloud Map mengaitkan VPC yang Anda pilih dalam daftar VPC dengan zona host pribadi tersebut.

Penyelesai Route 53 menyelesaikan kueri DNS yang berasal dari VPC menggunakan catatan di zona yang dihosting privat. Jika zona yang di-hosting privat tidak termasuk catatan yang cocok dengan nama domain dalam kueri DNS, Route 53 menanggapi kueri dengan NXDOMAIN (domain yang tidak ada).

Anda dapat mengaitkan VPC tambahan dengan zona yang di-hosting privat. Untuk informasi selengkapnya, lihat AssociateVPC WithHostedZone di Referensi API Amazon Route 53.