Creare un AWS Cloud Map namespace

Per creare uno spazio dei nomi, eseguire la procedura seguente.

AWS Management Console

1. Accedere AWS Management Console e aprire la AWS Cloud Map console all'indirizzo https://console.aws.amazon.com/cloudmap/.

2. Selezionare Create namespace (Crea spazio dei nomi).

3. Nella pagina Create namespace (Crea spazio dei nomi), specifica i valori applicabili. Per ulteriori informazioni, consulta Valori che specificate quando create un namespace.

4. Selezionare Create namespace (Crea spazio dei nomi).

AWS CLI

• Crea uno spazio dei nomi con il comando per il tipo di rilevamento delle istanze che preferisci (sostituisci i valori rossi con i tuoi).

  • Crea uno spazio dei nomi HTTP utilizzando. create-http-namespace Le istanze di servizio registrate utilizzando uno spazio dei nomi HTTP possono essere scoperte utilizzando una DiscoverInstances richiesta, ma non possono essere scoperte utilizzando DNS.

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

  • Crea uno spazio dei nomi privato basato su DNS e visibile solo all'interno di uno specifico Amazon VPC utilizzando. create-private-dns-namespace Puoi scoprire le istanze registrate con uno spazio dei nomi DNS privato utilizzando una richiesta o utilizzando DNS DiscoverInstances

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

  • Crea uno spazio dei nomi pubblico basato su DNS visibile su Internet utilizzando. create-public-dns-namespace Puoi individuare le istanze registrate con uno spazio dei nomi DNS pubblico tramite una richiesta DiscoverInstances o utilizzando il DNS.

    aws servicediscovery create-public-dns-namespace --name name-of-namespace

    Nota

    Requisiti del namespace:

    • I namespace configurati per le query DNS pubbliche devono terminare con un dominio di primo livello (ad esempio.com).

    • Il nome del namespace può contenere fino a 1.024 caratteri e deve iniziare e finire con una lettera.

    • Caratteri validi: a-z, A-Z, 0-9,. (punto), _ (trattino basso) e - (trattino).

AWS SDK for Python (Boto3)

1. Se non l'hai ancora Boto3 installato, puoi trovare le istruzioni per l'installazione, la configurazione e l'utilizzo qui. Boto3

2. Importa Boto3 e usa servicediscovery come servizio.

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

3. Crea uno spazio dei nomi con il comando per il tipo di individuazione delle istanze che preferisci (sostituisci i valori rossi con i tuoi):

   • Crea uno spazio dei nomi HTTP utilizzando. create_http_namespace() Le istanze di servizio registrate utilizzando uno spazio dei nomi HTTP possono essere scoperte utilizzandodiscover_instances(), ma non tramite DNS.

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

   • Crea uno spazio dei nomi privato basato su DNS e visibile solo all'interno di uno specifico Amazon VPC utilizzando. create_private_dns_namespace() Puoi scoprire le istanze registrate con uno spazio dei nomi DNS privato utilizzando uno dei due o utilizzando 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)

   • Crea uno spazio dei nomi pubblico basato su DNS visibile su Internet utilizzando. create_public_dns_namespace() Puoi scoprire le istanze registrate con uno spazio dei nomi DNS pubblico utilizzando uno dei due o utilizzando il DNS. discover_instances()

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

   • Esempio di output di risposta

     {
         'OperationId': 'gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd',
         'ResponseMetadata': {
             '...': '...',
         },
     }

     Nota

     Requisiti del namespace:

     • I namespace configurati per le query DNS pubbliche devono terminare con un dominio di primo livello (ad esempio.com).

     • Il nome del namespace può contenere fino a 1.024 caratteri e deve iniziare e finire con una lettera.

     • Caratteri validi: a-z, A-Z, 0-9,. (punto), _ (trattino basso) e - (trattino).

Valori che specificate quando create un namespace

Quando si crea uno spazio AWS Cloud Map dei nomi, si specificano i seguenti valori.

Nota

Dopo aver creato uno spazio dei nomi, puoi modificare i tag. Tuttavia, non puoi modificare nessun altro valore.

Valori

• Namespace name

• Namespace description

• Instance discovery

• Tags

• VPC

Nome dello spazio dei nomi

Il nome specificato per uno spazio dei nomi dipende dal modo in cui si desidera che l'applicazione rilevi le istanze. Il metodo di rilevamento delle istanze è determinato dall'opzione scelta per l'individuazione delle istanze. Le opzioni vengono visualizzate più avanti nella pagina corrente della console. Essi sono i seguenti:

Chiamate API

Se si seleziona questa opzione, l'applicazione individua le istanze del servizio specificando il nome dello spazio dei nomi e il nome del servizio in una richiesta DiscoverInstances.. Per ulteriori informazioni, consulta DiscoverInstances nella documentazione di riferimento dell'API AWS Cloud Map .

Puoi specificare un nome composto da un massimo di 1.024 caratteri. Un nome può contenere lettere maiuscole e minuscole, numeri, caratteri di sottolineatura (_) e trattini (-).

Chiamate API e query DNS nei VPC

Inserisci il nome di dominio che desideri che le tue applicazioni in un VPC utilizzino quando scoprono istanze inviando query DNS. AWS Cloud Map crea automaticamente una zona ospitata privata Amazon Route 53 con questo nome. Quando registri le istanze del servizio, AWS Cloud Map crea i record DNS nella zona ospitata con i nomi nel seguente formato:

service-name.namespace-name

Se si seleziona questa opzione, l'applicazione può anche individuare le istanze del servizio specificando il nome dello spazio dei nomi e il nome del servizio in una richiesta DiscoverInstances. Per ulteriori informazioni, consulta DiscoverInstances nella documentazione di riferimento dell'API AWS Cloud Map .

È possibile specificare un nome di dominio internazionalizzato (IDN) convertendo prima il nome in Punycode. Per informazioni sui convertitori online, cerca su internet "convertitore punycode".

È possibile anche convertire un nome di dominio internazionalizzato in Punycode quando si creano spazi dei nomi in modo programmatico. Ad esempio, se stai utilizzando Java, puoi convertire un valore Unicode in Punycode utilizzando il metodo toASCII della libreria java.net.IDN.

Chiamate API e query DNS pubbliche

Inserire il nome del dominio che le applicazioni devono utilizzare per individuare le istanze inviando query DNS pubbliche. Deve essere un nome di dominio registrato. Quando crei lo spazio dei nomi, crea AWS Cloud Map automaticamente una zona ospitata pubblica di Amazon Route 53 con lo stesso nome. Quando registri le istanze del servizio, AWS Cloud Map crea i record DNS nella zona ospitata con i nomi nel seguente formato:

service-name.namespace-name

Se si seleziona questa opzione, l'applicazione può anche individuare le istanze del servizio specificando il nome dello spazio dei nomi e il nome del servizio in una richiesta DiscoverInstances. Per ulteriori informazioni, consulta DiscoverInstances nella documentazione di riferimento dell'API AWS Cloud Map .

È possibile specificare un nome di dominio internazionalizzato (IDN) convertendo prima il nome in Punycode. Per informazioni sui convertitori online, cerca su internet "convertitore punycode".

È possibile anche convertire un nome di dominio internazionalizzato in Punycode quando si creano spazi dei nomi in modo programmatico. Ad esempio, se stai utilizzando Java, puoi convertire un valore Unicode in Punycode utilizzando il metodo toASCII della libreria java.net.IDN.

Descrizione del namespace

Inserire una descrizione per lo spazio dei nomi. Il valore inserito qui appare nella pagina Namespaces (Spazio dei nomi) e nella pagina di dettaglio per ogni spazio dei nomi.

Individuazione delle ist

Specifica il modo in cui desideri che la tua applicazione trovi le istanze registrate:

Chiamate API

Scegli questa opzione se vuoi che la tua applicazione utilizzi solo le chiamate API per scoprire le istanze registrate.

Chiamate API e query DNS nei VPC

Scegli questa opzione se vuoi che la tua applicazione utilizzi le chiamate API o le query DNS in un VPC per scoprire le istanze. Non è necessario utilizzare entrambi i metodi.

Chiamate API e query DNS pubbliche

Scegli questa opzione se vuoi che la tua applicazione utilizzi le chiamate API o le query DNS pubbliche per scoprire le istanze. Non è necessario utilizzare entrambi i metodi.

SOA TTL

Per le chiamate API e le query DNS in VPC o le chiamate API e le query DNS pubbliche, il valore time to live (TTL) per il record DNS di inizio dell'autorità (SOA) della zona ospitata da Route 53 creata con il tuo spazio dei nomi. Il valore determina per quanto tempo i resolver DNS memorizzano nella cache le informazioni per questo record prima che i resolver inoltrino un'altra query DNS ad Amazon Route 53 per ottenere le impostazioni aggiornate. Un valore più basso ridurrà anche il tempo in cui una voce mancante verrà memorizzata nella cache (memorizzazione nella cache negativa) a scapito di ulteriori query per quel namespace.

Tag

Puoi specificare uno o più tag da aggiungere al tuo namespace. Un tag è un'etichetta opzionale che puoi assegnare a una risorsa. AWS Ciascun tag è formato da una chiave e da un valore, Ad esempio, puoi definire un tag con Key = Environment e Value = Production. I tag consentono di classificare le AWS risorse in modo da gestirle più facilmente.

Puoi aggiornare o rimuovere i tag dai tuoi namespace dopo che sono stati creati. Per ulteriori informazioni, consulta Tagging delle risorse AWS Cloud Map.

VPC

Quando scegli le chiamate API e le query DNS nei VPC per sfruttare il valore del rilevamento delle istanze, crea AWS Cloud Map una zona ospitata privata Amazon Route 53 con lo stesso nome. AWS Cloud Map associa il VPC scelto nell'elenco VPC a quella zona ospitata privata.

Route 53 Resolver risolve le query DNS che hanno origine nel VPC utilizzando i record nella zona ospitata privata. Se la zona ospitata privata non include un record che corrisponde al nome di dominio in una query DNS, Route 53 risponde alla query con (dominio inesistente). NXDOMAIN

È possibile associare VPC aggiuntivi alla zona ospitata privata. Per ulteriori informazioni, consulta AssociateVPC WithHostedZone nell'Amazon Route 53 API Reference.