Elastic Container Instance:ApsaraDB RDSインスタンスに接続するようにエラスティックコンテナインスタンスを設定する

背景情報

ApsaraDB RDSは、安定性、信頼性、拡張性に優れたオンラインデータベースサービスです。ApsaraDB RDSは、アリババクラウドのApsara Distributed File Systemと高性能SSDを使用して、MySQL、SQL Server、PostgreSQLなどのデータベースエンジンをサポートしています。このトピックでは、ApsaraDB RDS for MySQLインスタンスを例として使用して、エラスティックコンテナインスタンスをApsaraDB RDSインスタンスに接続する方法を説明します。ビジネス要件に基づいてデータベースエンジンを選択できます。詳細については、「はじめに」トピックの「データベースエンジン」セクションを参照してください(はじめに)。

前提条件

• ApsaraDB RDS for MySQLインスタンスが作成され、インスタンスのユーザーアカウントが作成されていること。詳細については、ApsaraDB RDS for MySQLインスタンスを作成するおよびApsaraDB RDS for MySQLインスタンスのデータベースとアカウントを作成するを参照してください。

• ACK Serverlessクラスタが作成されていること。詳細については、ACK Serverlessクラスタを作成するを参照してください。

  説明

  この例では、ACK Serverlessクラスタを使用しています。別のタイプのKubernetesクラスタを使用する場合は、Elastic Container Instanceに接続するために、仮想ノードがクラスタにデプロイされていることを確認してください。

• ApsaraDB RDSインスタンスとKubernetesクラスタが相互に通信できることを確認してください。

  ApsaraDB RDSインスタンスとKubernetesクラスタを同じ仮想プライベートクラウド（VPC）にデプロイすることをお勧めします。これにより、ApsaraDB RDSインスタンスとクラスタ内のアプリケーションは、VPCを介して相互に接続されます。インスタンスとクラスタを異なるVPCにデプロイする場合は、インスタンスとクラスタ内のアプリケーション間のインターネット接続を有効にする必要があります。

ApsaraDB RDSインスタンスのホワイトリストを設定し、データベースのエンドポイントを取得する。

アプリケーションをApsaraDB RDSインスタンスに接続するように設定する

このトピックでは、VPCを使用して、ACK Serverlessクラスタ内のアプリケーションをApsaraDB RDSインスタンスに接続します。手順：

1. ACKコンソールにログインします。

2. クラスタページで、管理するクラスタを見つけ、クラスタ名をクリックします。クラスタの管理ページが表示されます。

3. ConfigMapを作成して、ApsaraDB RDSインスタンスへの接続を設定します。

   説明

   ConfigMapを使用すると、環境設定をコンテナイメージから分離できます。これにより、アプリケーション設定の変更が容易になります。

   1. 左側のナビゲーションペインで、設定> Configmapを選択します。

   2. ページの右上隅にある作成をクリックします。

   3. ConfigMapを設定し、OKをクリックします。

      表示されるパネルで、ConfigMapの名前を指定します。例：rds-config。次に、次の表に示すパラメータを設定します。

      パラメータ	例	説明
      host	rm-2zem97a62s9******.mysql.rds.aliyuncs.com	データベースのエンドポイント。エンドポイントは、ApsaraDB RDSインスタンスのデータベース接続ページで取得できます。
      port	3306	データベースのポート番号。ポート番号は、ApsaraDB RDSインスタンスのデータベース接続ページで取得できます。
      database	test-db	データベースの名前。データベースの名前は、ApsaraDB RDSインスタンスのデータベースページで取得できます。

4. シークレットを作成して、データベースのユーザー名とパスワードを追加します。

   説明

   シークレットを使用すると、データベースのユーザー名やパスワードなどの機密情報をアプリケーションに安全に渡すことができます。

   1. 左側のナビゲーションペインで、設定> シークレットを選択します。

   2. 作成をクリックします。

   3. シークレットを設定し、OKをクリックします。

      表示されるパネルで、シークレットの名前を指定します。例：rds-secret。次に、次の表に示すパラメータを設定します。

      パラメータ	例	説明
      username	test	データベースにアクセスするために使用するユーザー名。ユーザー名は、ApsaraDB RDSインスタンスのアカウントページで取得できます。
      password	pwd******	データベースにアクセスするために使用するパスワード。パスワードを忘れた場合は、アカウントページでパスワードをリセットできます。

5. Elastic Container Instanceベースのポッドを作成し、ポッドをApsaraDB RDSインスタンスに接続できるかどうかをテストします。

   1. 左側のナビゲーションペインで、ワークロード> ポッドを選択します。

   2. YAMLから作成をクリックします。

   3. YAMLファイルの内容を入力し、作成をクリックします。

      ApsaraDB RDS for MySQLは、オープンソースのMySQLと完全に互換性があります。オープンソースのMySQLデータベースに接続するのと同じ方法で、データベースクライアントからApsaraDB RDSインスタンスに接続できます。次のコードは、設定例を示しています。

      説明

      このトピックで提供されている設定例を使用してデータベース接続をテストする場合は、ApsaraDB RDSインスタンスにusernameという名前のテーブルを作成し、テーブルにuserという名前の列を追加します。

      次のYAMLコードは、環境変数を使用して、データベースのエンドポイント、ポート番号、名前、ユーザー名、パスワードなどのデータベース接続情報を渡します。イメージには、データベースをクラスタに接続してデータを挿入するために使用できるPythonスクリプトが含まれています。

      apiVersion: v1
      kind: Pod
      metadata:
        labels:
          name: rds-test
        name: rds-test
      spec:
        containers:
        - name: test-rds
          image: registry.cn-hangzhou.aliyuncs.com/eci_open/sqlclient:1.0.1  # ApsaraDB RDSインスタンスをクラスタに接続するために使用されるPythonジョブを含むイメージ。
          imagePullPolicy: IfNotPresent
          command: ["/bin/bash","-c","python3 /testapp/mysqlclient.py"]
          env:
          - name: MYSQL_HOST 
            valueFrom:
              configMapKeyRef:
                name: rds-config  # ConfigMapの名前。
                key: host # ConfigMapのキー。
          - name: MYSQL_PORT
            valueFrom:
              configMapKeyRef:
                name: rds-config # ConfigMapの名前。
                key: port # ConfigMapのキー。
          - name: MYSQL_DB
            valueFrom:
              configMapKeyRef:
                name: rds-config  # ConfigMapの名前。
                key: database # ConfigMapのキー。
          - name: MYSQL_USERNAME
            valueFrom:
              secretKeyRef:
                name: rds-secret # シークレットの名前。
                key: username # シークレットのキー。
          - name: MYSQL_PWD
            valueFrom:
              secretKeyRef:
                name: rds-secret # シークレットの名前。
                key: password # シークレットのキー。
        restartPolicy: Never

      上記のイメージには、usernameテーブルのuser列にデータを挿入するために使用できるPythonスクリプト（mysqlclient.py）が含まれています。スクリプトの内容：

      import pymysql
      import os
      import time
      
      config = {
          'host': str(os.getenv('MYSQL_HOST')),
          'port': int(os.getenv('MYSQL_PORT')),
          'user': str(os.getenv('MYSQL_USERNAME')),
          'password': str(os.getenv('MYSQL_PWD')),
          'database': str(os.getenv('MYSQL_DB')),
      }
      
      def mysqlClient():
          print("connecting database ......")  # データベースに接続しています......
          db = pymysql.connect(**config)
          try:
              cursor = db.cursor()
              cursor.execute("INSERT INTO username(user) VALUES('Mrs')")
              cursor.close()
              db.commit()
      
              cursor = db.cursor()
              cursor.execute("SELECT user FROM username")
              result = cursor.fetchall()
              cursor.close()
              if result != None:
                  print(result)
                  time.sleep(99999)
          except Exception as e:
              print('System Error: ', e) # システムエラー：
          finally:
              db.close()
      
      
      if __name__ == '__main__':
          mysqlClient()

6. ApsaraDB RDSデータベースにログインし、接続結果を表示します。

   1. ApsaraDB RDSコンソールにログインします。

   2. 左側のナビゲーションペインで、インスタンスをクリックします。上部のナビゲーションバーで、ApsaraDB RDSインスタンスがデプロイされているリージョンを選択します。次に、インスタンスを見つけ、インスタンスIDをクリックします。

   3. 左側のナビゲーションペインで、データベースをクリックします。

   4. 表示するApsaraDB RDSデータベースを見つけます。SQLクエリをクリックします。

   5. 表示されるダイアログボックスで、ApsaraDB RDSデータベースのユーザー名とパスワードを入力し、ログインをクリックします。

   6. 結果をクエリするSQLコマンドを入力します。

      SELECT * FROM 'username'コマンドを実行します。usernameテーブルのuser列にデータエントリが追加されていることがわかります。

      

FAQ

次の部分では、ApsaraDB RDSデータベースがElastic Container Instanceに接続できない一般的な理由について説明します。

• 異なるネットワークタイプ

• 異なるVPC

• ドメイン名解決の失敗またはエラー

• 異なるリージョン

• 誤ったIPアドレスホワイトリスト設定

• 読み取り専用インスタンスにIPアドレスホワイトリストが設定されていない

• 無効な内部またはパブリックエンドポイント

• 接続クォータの枯渇

• 無効なユーザー名またはパスワード

• 無効なホストアドレス

ApsaraDB RDSインスタンスへの接続に使用するネットワークタイプに基づいてソリューションを選択します。詳細については、ApsaraDB for RDSインスタンスを接続できない場合はどうすればよいですか？を参照してください。