DNS クエリと API コールで AWS Cloud Map サービス検出を使用する方法について説明します。 - AWS Cloud Map
前提条件ステップ 1: 名前空間を作成するステップ 2: サービスを作成するステップ 3: サービスインスタンスを作成するステップ 4: サービスインスタンスを検出するステップ 5：クリーンアップ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

DNS クエリと API コールで AWS Cloud Map サービス検出を使用する方法について説明します。

次のチュートリアルでは、2 つのバックエンドサービスを使用したマイクロサービスアーキテクチャをシミュレートします。最初のサービスは、DNS クエリを使用して検出できます。2 番目のサービスは API を使用して AWS Cloud Map のみ検出できます。

注記

ドメイン名や IP アドレスなどのリソースの詳細は、シミュレーションのみを目的としています。インターネット経由で解決することはできません。

このチュートリアルのend-to-end AWS CLI バージョンについては、「」を参照してくださいを使用して DNS クエリと API コールで AWS Cloud Map サービス検出を使用する方法について説明します。 AWS CLI。

前提条件

チュートリアルを正常に完了するには、次の前提条件を満たす必要があります。

  • 開始する前に、「を使用するように をセットアップする AWS Cloud Map」のステップを完了します。

  • をまだインストールしていない場合は AWS Command Line Interface、「 の最新バージョンのインストールまたは更新 AWS CLI」の手順に従ってインストールします。

    このチュートリアルでは、コマンドを実行するためのコマンドラインターミナルまたはシェルが必要です。Linux および macOS では、任意のシェルとパッケージマネージャーを使用してください。

    注記

    Windows では、Lambda でよく使用される一部の Bash CLI コマンド (zip など) が、オペレーティングシステムの組み込みターミナルでサポートされていません。Ubuntu および Bash の Windows 統合バージョンを取得するには、Windows Subsystem for Linux をインストールします。

  • このチュートリアルでは、digDNS ルックアップユーティリティコマンドを使用するローカル環境が必要です。

ステップ 1: AWS Cloud Map 名前空間を作成する

このステップでは、パブリック AWS Cloud Map 名前空間を作成します。 は、同じ名前でユーザーに代わって Route 53 ホストゾーン AWS Cloud Map を作成します。これにより、パブリック DNS レコードまたは AWS Cloud Map API コールを使用して、この名前空間で作成されたサービスインスタンスを検出できます。

  1. にサインイン AWS Management Console し、https://console.aws.amazon.com/cloudmap/ で AWS Cloud Map コンソールを開きます。

  2. [名前空間の作成] を選択します。

  3. 名前空間名には、 を指定しますcloudmap-tutorial.com。

    注記

    これを本番環境で使用する場合は、所有またはアクセス権のあるドメインの名前を指定する必要があります。ただし、このチュートリアルでは、実際に使用されているドメインである必要はありません。

  4. （オプション) 名前空間の説明に、名前空間を使用する対象の説明を指定します。

  5. インスタンス検出では、API コールとパブリック DNS クエリを選択します。

  6. 残りのデフォルト値のままにして、名前空間の作成を選択します。

ステップ 2: AWS Cloud Map サービスを作成する

このステップでは、2 つのサービスを作成します。最初のサービスは、パブリック DNS コールと API コールを使用して検出できます。2 番目のサービスは API コールを使用してのみ検出できます。

  1. にサインイン AWS Management Console し、https://console.aws.amazon.com/cloudmap/ で AWS Cloud Map コンソールを開きます。

  2. 左側のナビゲーションペインで、名前空間を選択して、作成した名前空間を一覧表示します。

  3. 名前空間のリストから、cloudmap-tutorial.com名前空間を選択し、詳細の表示を選択します。

  4. 「サービス」セクションで「サービスの作成」を選択し、以下を実行して最初のサービスを作成します。

    1. [サービス名] に public-service と入力します。サービス名は、 が AWS Cloud Map 作成する DNS レコードに適用されます。使用される形式は です<service-name>.<namespace-name>。

    2. サービス検出設定で、API と DNS を選択します。

    3. DNS 設定セクションのルーティングポリシーで、複数値回答ルーティングを選択します。

      注記

      選択すると、コンソールはこれを MULTIVALUE に変換します。使用可能なルーティングオプションの詳細については、Route 53 デベロッパーガイドの「ルーティングポリシーの選択」を参照してください。

    4. 残りのデフォルト値のままにして、名前空間の詳細ページに戻るサービスの作成を選択します。

  5. 「サービス」セクションで「サービスの作成」を選択し、以下を実行して 2 番目のサービスを作成します。

    1. [サービス名] に backend-service と入力します。

    2. Service Discovery Configuration では、API のみを選択します。

    3. 残りのデフォルト値のままにして、サービスの作成を選択します。

ステップ 3: AWS Cloud Map サービスインスタンスを登録する

このステップでは、名前空間内のサービスごとに 1 つずつ、2 つのサービスインスタンスを作成します。

  1. にサインイン AWS Management Console し、https://console.aws.amazon.com/cloudmap/ で AWS Cloud Map コンソールを開きます。

  2. 名前空間のリストから、ステップ 1 で作成した名前空間を選択し、詳細の表示を選択します。

  3. 名前空間の詳細ページで、サービスのリストからpublic-serviceサービスを選択し、詳細の表示を選択します。

  4. 「サービスインスタンス」セクションで「サービスインスタンスの登録」を選択し、以下を実行して最初のサービスインスタンスを作成します。

    1. サービスインスタンス ID には、 を指定しますfirst。

    2. IPv4 アドレスには、 を指定します192.168.2.1。

    3. 残りのデフォルト値のままにして、サービスインスタンスの登録を選択します。

  5. ページの上部にあるパンくずリストを使用して、cloudmap-tutorial.com を選択して名前空間の詳細ページに戻ります。

  6. 名前空間の詳細ページで、サービスのリストからバックエンドサービスを選択し、詳細の表示を選択します。

  7. 「サービスインスタンス」セクションで「サービスインスタンスの登録」を選択し、以下を実行して 2 番目のサービスインスタンスを作成します。

    1. サービスインスタンス ID で、 を指定secondして、これが 2 番目のサービスインスタンスであることを示します。

    2. インスタンスタイプで、別のリソースの識別情報を選択します。

    3. カスタム属性の場合、 をキーservice-nameとして、 を値backendとしてキーと値のペアを追加します。

    4. [サービスインスタンスの登録] を選択します。

ステップ 4: AWS Cloud Map サービスインスタンスを検出する

AWS Cloud Map 名前空間、サービス、サービスインスタンスが作成されたら、インスタンスを検出することで、すべてが機能していることを確認できます。dig コマンドを使用してパブリック DNS 設定を確認し、 AWS Cloud Map API を使用してバックエンドサービスを確認します。dig コマンドの詳細については、「dig - DNS lookup utility」を参照してください。

  1. にサインイン AWS Management Console し、https://console.aws.amazon.com/route53/ で Route 53 コンソールを開きます。

  2. 左のナビゲーションで、[Hosted zones] (ホストゾーン) を選択します。

  3. cloudmap-tutorial.com ホストゾーンを選択します。これにより、ホストゾーンの詳細が別のペインに表示されます。ホストゾーンに関連付けられたネームサーバーをメモしておきます。次のステップで使用します。

  4. dig コマンドとホストゾーンの Route 53 ネームサーバーのいずれかを使用して、サービスインスタンスの DNS レコードをクエリします。

    dig @hosted-zone-nameserver public-service.cloudmap-tutorial.com

    出力ANSWER SECTIONの には、public-serviceサービスに関連付けられた IPv4 アドレスが表示されます。

    ;; ANSWER SECTION:
public-service.cloudmap-tutorial.com. 300 IN A	192.168.2.1

  5. を使用して AWS CLI、2 番目のサービスインスタンスの属性をクエリします。

    aws servicediscovery discover-instances --namespace-name cloudmap-tutorial.com --service-name backend-service --region region

    出力には、サービスに関連付けられた属性がキーと値のペアとして表示されます。

    {
    "Instances": [
        {
            "InstanceId": "second",
            "NamespaceName": "cloudmap-tutorial.com",
            "ServiceName": "backend-service",
            "HealthStatus": "UNKNOWN",
            "Attributes": {
                "service-name": "backend"
            }
        }
    ],
    "InstancesRevision": 71462688285136850
}

ステップ 5: リソースをクリーンアップする

チュートリアルを完了したら、リソースを削除できます。 AWS Cloud Map は、逆の順序でクリーンアップし、サービスインスタンスを最初に、次に サービス、最後に 名前空間をクリーンアップする必要があります。 AWS Cloud Map は、これらのステップを実行すると、ユーザーに代わって Route 53 リソースをクリーンアップします。

  1. にサインイン AWS Management Console し、https://console.aws.amazon.com/cloudmap/ で AWS Cloud Map コンソールを開きます。

  2. 名前空間のリストから、cloudmap-tutorial.com名前空間を選択し、詳細の表示を選択します。

  3. 名前空間の詳細ページで、サービスのリストからpublic-serviceサービスを選択し、詳細の表示を選択します。

  4. サービスインスタンスセクションで、firstインスタンスを選択し、登録解除を選択します。

  5. ページの上部にあるパンくずリストを使用して、cloudmap-tutorial.com を選択して名前空間の詳細ページに戻ります。

  6. 名前空間の詳細ページで、サービスのリストからパブリックサービスを選択し、削除を選択します。

  7. に対してステップ 3～6 を繰り返しますbackend-service。

  8. 左側のナビゲーションで、名前空間を選択します。

  9. cloudmap-tutorial.com 名前空間を選択し、削除を選択します。

    注記

    はユーザーに代わって Route 53 リソースを AWS Cloud Map クリーンアップしますが、Route 53 コンソールに移動して、cloudmap-tutorial.comホストゾーンが削除されたことを確認できます。