PolarDB:エンタープライズグレード SaaS サービス

準備 1: RAM ユーザー AccessKey の取得

PolarDB Agent Express SaaS 管理アプリケーションは、AccessKey を使用して Alibaba Cloud API を呼び出して、リソースを作成および管理します。最小権限の原則に従い、このタスク専用の RAM ユーザーと AccessKey を使用してください。

1. 権限ポリシーの作成

   1. RAM コンソールにログインします。左側メニューで、[権限] > [ポリシー] を選択します。

   2. [ポリシーの作成] をクリックして、[スクリプト] タブに移動します。

   3. 以下の JSON ポリシーをポリシーエディターに貼り付けて、[OK] をクリックします。

      JSON ポリシー

      {
        "Version": "1",
        "Statement": [
          {
            "Effect": "Allow",
            "Action": [
              "polardb:DescribeDBClusters",
              "polardb:DescribeAIDBClusters",
              "polardb:DescribeDBClusterAttribute",
              "polardb:DescribeDBClusterEndpoints",
              "polardb:DescribeRegions",
              "polardb:DescribeHistoryEvents",
              "polardb:DescribePolarAgents",
              "polardb:DescribeApplications",
              "polardb:CreateApplication",
              "polardb:DeleteApplication",
              "polardb:DescribeApplicationAttribute",
              "polardb:OperateApplication",
              "polardb:UpgradeApplicationVersion",
              "polardb:DescribeApplicationParameters",
              "polardb:ModifyApplicationParameter",
              "polardb:ModifyApplicationDescription",
              "polardb:ModifyApplicationWhitelist",
              "polardb:CreateApplicationEndpointAddress",
              "polardb:DeleteApplicationEndpointAddress",
              "polardb:DescribePolarClawSkills",
              "polardb:ModifyPolarClawSkill",
              "polardb:DescribeApplicationPerformance",
              "polardb:DescribeApplicationBackupPolicy",
              "polardb:ModifyApplicationBackupPolicy",
              "polardb:DescribeApplicationBackups",
              "polardb:CreateApplicationBackup",
              "polardb:DeleteApplicationBackup",
              "polardb:RestoreApplicationByBackupSet",
              "polardb:DescribeApplicationPrompts",
              "polardb:CreateApplicationPrompt",
              "polardb:ModifyApplicationPrompt",
              "polardb:DeleteApplicationPrompt",
              "polardb:ApplyApplicationPrompts",
              "polardb:ModifyApplicationPromptStatus",
              "polardb:DescribeApplicationLogs",
              "polardb:DescribeApplicationSessionIds",
              "polardb:DescribeApplicationSessionLogs",
              "polardb:DescribePolarClawSkillsMarket",
              "polardb:DescribePolarClawSkillTemplates",
              "polardb:DescribePolarClawSkillTemplate",
              "polardb:DescribePolarClawSkillAssessment",
              "polardb:CreatePolarClawSkillTemplate",
              "polardb:DeletePolarClawSkillTemplate",
              "polardb:CreatePolarClawSkill",
              "polardb:GetPolarClawSkillRegion",
              "polardb:CheckPolarClawSkill",
              "polardb:DeletePolarClawSkill",
              "polardb:CreateBatchTask",
              "polardb:DescribeBatchTasks",
              "polardb:DescribeBatchTask",
              "polardb:DescribeGatewayList",
              "polardb:DescribeAIGatewayInstances",
              "polardb:DescribeAIGatewayAttribute",
              "polardb:ListAIGatewayModelApis",
              "polardb:GetAIGatewayModelApiCreationOptions",
              "polardb:CreateAIGatewayModelApi",
              "polardb:ModifyAIGatewayModelApi",
              "polardb:DeleteAIGatewayModelApi",
              "polardb:ListAIGatewayModelServices",
              "polardb:CreateAIGatewayModelService",
              "polardb:ListAIGatewayConsumerGroups",
              "polardb:CreateAIGatewayConsumerGroup",
              "polardb:DeleteAIGatewayConsumerGroup",
              "polardb:ModifyAIGatewayConsumerGroup",
              "polardb:ListAIGatewayConsumers",
              "polardb:DescribeAIGatewayConsumer",
              "polardb:CreateAIGatewayConsumer",
              "polardb:ResetAIGatewayConsumerApiKey",
              "polardb:DeleteAIGatewayConsumer",
              "polardb:ListAIGatewayRateLimitPolicies",
              "polardb:CreateAIGatewayRateLimitPolicy",
              "polardb:DeleteAIGatewayRateLimitPolicy",
              "polardb:ModifyAIGatewayRateLimitPolicy",
              "polardb:ListAIGatewayBudgetPolicies",
              "polardb:CreateAIGatewayBudgetPolicy",
              "polardb:DeleteAIGatewayBudgetPolicy",
              "polardb:ModifyAIGatewayBudgetPolicy",
              "polardb:DescribeGatewayAttribute",
              "polardb:DescribeBudgetStats",
              "polardb:DescribeCostRules",
              "polardb:CreateCostRule",
              "polardb:ModifyCostRule",
              "polardb:DeleteCostRule",
              "polardb:StartAIGateway",
              "polardb:StopAIGateway",
              "polardb:RestartAIGateway",
              "polardb:ReleaseAIGateway",
              "polardb:CreateAIGatewayPublicEndpoint",
              "polardb:DescribeAIGatewaySecurityGroups",
              "polardb:DescribeAIGatewayIPArrayList",
              "polardb:ModifyAIGatewaySecurityIPs",
              "polardb:DescribeAIGatewayPerformance",
              "polardb:ListAIGatewayEvents",
              "polardb:ListTagResourcesForRegion",
              "polardb:TagResources",
              "polardb:UntagResources",
              "polardb:DescribeModelServices",
              "polardb:DescribeModelApis",
              "polardb:DescribeConsumerGroups",
              "polardb:DescribeRateLimitPolicy"
            ],
            "Resource": "*"
          },
          {
            "Effect": "Allow",
            "Action": [
              "ecs:DescribeSecurityGroups"
            ],
            "Resource": "*"
          },
          {
            "Effect": "Allow",
            "Action": [
              "tag:ListTagKeys",
              "tag:ListTagValues"
            ],
            "Resource": "*"
          },
          {
            "Effect": "Allow",
            "Action": [
              "oss:PutBucketPolicy",
              "oss:GetBucketPolicy",
              "oss:PutObject"
            ],
            "Resource": "*"
          },  
          {
            "Effect": "Allow",
            "Action": [
              "bss:Refund*"
            ],
            "Resource": "*"
          },
          {
            "Effect": "Allow",
            "Action": [
              "bss:Renew*"
            ],
            "Resource": "*"
          },
          {
            "Effect": "Allow",
            "Action": [
              "bss:ModifyInstance"
            ],
            "Resource": "*"
          }
        ]
      }

   4. ポリシーに名前を付け (例: PolarDB Agent ExpressSaaSMinimalAccess)、作成を完了します。

2. RAM ユーザーの作成と権限の付与

   1. 左側メニューで、[ID] > [ユーザー] を選択して、RAM ユーザーを選択または作成します。

      1. 既存のユーザーを使用する場合：ユーザーの詳細ページに移動します。[AccessKey] タブで、既存の AccessKey を使用するか、新しい AccessKey を作成できます。新しい AccessKey を作成するには、[ローカル開発環境で使用] を選択して、生成された [AccessKey ID] と [AccessKey Secret] を安全に保存してください。

      2. 新しいユーザーを作成する場合：[ユーザーの作成] ページで、[基本情報] を入力して、[アクセスに永続的な AccessKey を使用] を選択します。ユーザーが作成されたら、[AccessKey ID] と [AccessKey Secret] を保存してください。

   2. ユーザー詳細ページで、[権限管理] タブに切り替え、[承認を追加] をクリックし、前の手順で作成した PolarDB Agent ExpressSaaSMinimalAccess ポリシーをユーザーに付与します。

準備 2: エンタープライズアプリケーション認証情報の取得

PolarDB Agent Express SaaS 管理アプリケーションは、Lark、DingTalk、または WeCom のカスタムアプリケーションをユーザー認証に使用します。

ステップ 1: PolarDB Agent Express SaaS 管理アプリケーションの作成

1. PolarDB コンソールにログインします。左側のナビゲーションペインで、PolarDB AI > PolarDB Agent Express をクリックします。上部のナビゲーションバーで、目的の[リージョン]を選択します。

2. 表示中の PolarDB Agent Express ページで、SaaS 設定タブに切り替え、今すぐ作成をクリックします。

3. 作成ページで、以下のパラメータを設定します。

   • [Alibaba Cloud アカウントの AK/SK]: 準備で取得した AccessKey ID と AccessKey Secret を入力します。

   • [VPC ネットワーク]および[ゾーンおよび vSwitch]：PolarDB Agent Express SaaS 管理アプリケーションをデプロイする VPC と vSwitch を選択します。

   • [セキュリティグループ]：セキュリティグループを選択して、そのインバウンドルールがポート 8080 でのトラフィックを許可していることを確認してください。

   • [SaaS サービスのログイン方法]: アプリケーションタイプ で Lark、DingTalk、または WeCom を選択し、準備で取得した対応するエンタープライズアプリケーションの認証情報を入力します。

4. [OK] をクリックして、作成プロセスを開始します。

ステップ 2: ネットワークとアクセスの設定

PolarDB Agent Express SaaS 管理アプリケーションが作成されると、デフォルトでは VPC 内からのみアクセス可能です。PolarDB Agent Express SaaS 管理アプリケーションがパブリックインターネット上の Lark、DingTalk、または WeCom 認証サービスと通信し、パブリックにアクセスできるようにするには、ネットワークの設定が必要です。

1. パブリック NAT ゲートウェイの作成：NAT ゲートウェイ - パブリック NAT ゲートウェイ購入ページにアクセスして作成します。作成プロセス中に、PolarDB Agent Express SaaS 管理アプリケーションと同じ VPC と vSwitch を選択してください。

2. SNAT エントリの設定: NAT ゲートウェイページに移動します。 対象のゲートウェイの操作列で、SNAT の構成 をクリックし、次に SNAT エントリの作成 をクリックします。 次のようにパラメーターを設定します:

   • [SNAT エントリの粒度]：[VPC レベル]。

   • [Elastic IP Address の選択]：ドロップダウンリストから、パブリックアクセスを提供する EIP を選択します。

   説明

   パブリックアクセスを有効にすると、NAT ゲートウェイとパブリックネットワークトラフィックの料金が発生します。詳細については、「NAT ゲートウェイの課金」をご参照ください。

3. (オプション) パブリックアドレスのリクエスト
   インターネットから管理アプリケーションにアクセスする場合は、PolarDB Agent Express SaaS 管理アプリケーションの詳細ページ (PolarDB コンソール内) に戻り、パブリックエンドポイントの有効化 をクリックして、そのパブリックアドレスをリクエストします。
   
   

ステップ 3: エンタープライズアプリケーションのコールバックアドレスの設定

ステップ 4: SaaS 管理アプリケーションへのアクセスと使用

1. アクセス許可リストの設定
   PolarDB Agent Express SaaS 管理アプリケーションの許可リスト設定で、アプリケーションへのアクセスを許可するクライアントの IP アドレスを追加してください。
   
   

   • インターネット経由でアクセスする場合は、ローカルネットワークのパブリック送信元 IP アドレスを追加します。

   • 内部ネットワーク経由でアクセスする場合は、VPC 内のクライアント IP アドレスを追加します。

2. アプリケーションへのアクセス
   PolarDB Agent Express SaaS 管理アプリケーションの詳細ページで、プライベートアドレスまたはリクエストしたパブリックアドレスを見つけて、ブラウザでアクセスします。
   
   

3. ログインして PolarDB Agent Express テンプレートを作成する
   初回ユーザーには、管理者権限が自動的に付与されます。[アカウント管理] ページで、PolarDB Agent Express アプリケーション (Lobster モジュール) 用の設定テンプレートを作成します。たとえば、モデルソースとして Model Studio を指定し、対応する ModelFrom と ModelApiKey を入力します。
   
   

4. チームメンバーによるアプリケーションの作成方法
   テンプレートが設定されると、他のチームメンバーは SaaS 管理アプリケーションにログインできます。[PolarDB Agent Express 管理] ページで、テンプレートを選択してワンクリックで独自の PolarDB Agent Express アプリケーションを作成できます。