アプリ環境を構成する

新しい値の作成

Atlas App Services UI で、左側のナビゲーション メニューにある [ Valuesをクリックし、次にCreate New Valueをクリックします。

値の名前を入力し、値のタイプとして [ Environmentを選択します。

各環境の値を定義する

値にアクセスする環境タグごとに値を定義します。 環境ごとに異なる値を定義できます。どの環境でも未定義の値を残すことができます。

アプリ環境を指定する

アプリは常に特定の環境で実行されるため、すべての環境値の値に影響します。 アプリの現在の環境はDeploy > Environment画面で指定できます。

保存と配置

環境値を定義したら、 Saveをクリックして構成を更新します。 アプリケーションで配置案が有効になっている場合は、 Review & Deployをクリックして変更を配置します。

MongoDB Atlas ユーザーの認証

MongoDB Atlas Admin API キーを使用して CLI にログインします。

appservices login --api-key="<my api key>" --private-api-key="<my private api key>"

アプリの最新バージョンを取得する

アプリの構成ファイルのローカル コピーを取得します。 アプリの最新バージョンを取得するには、次のコマンドを実行します。

appservices pull --remote="<Your App ID>"

また、UI または管理 API からアプリケーションの構成ファイルのコピーをエクスポートすることもできます。 方法については、「アプリをエクスポートする 」を参照してください。

1 つ以上の環境を定義する

/environmentsディレクトリには、サポートされている環境タグごとに.jsonファイルが含まれています。 各ファイルは、対応する環境のすべての環境値を定義します。

App Services は次の環境タグをサポートしています。

• ""

• "development"

• "testing"

• "qa"

• "production"

使用する環境ごとに ファイルを開きます。 各ファイルで、値の名前をその環境内の値にマッピングするvaluesサブドキュメントにエントリを追加します。

{
  "values": {
    "baseUrl": "https://example.com"
  }
}

{
  "values": {
    "baseUrl": "https://dev.example.com"
  }
}

アプリ環境を設定する

アプリは常に特定の環境で実行されるため、すべての環境値の値に影響します。 アプリの現在の環境はroot_config.jsonで指定できます。

{
  ...,
  "environment": "development"
}

アプリを配置する

各環境の値を定義したら、更新された構成をリモート アプリにプッシュできます。 App Services CLI は、プッシュ時に更新された環境値をすぐに配置します。

appservices push --remote="<Your App ID>"

MongoDB Atlas ユーザーの認証

MongoDB Atlas API キー ペアを使用して、管理ユーザー認証エンドポイントを呼び出します。

curl -X POST \
  https://services.cloud.mongodb.com/api/admin/v3.0/auth/providers/mongodb-cloud/login \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "username": "<Public API Key>",
    "apiKey": "<Private API Key>"
  }'

認証に成功すると、レスポンス本文にはaccess_token値を持つ JSON オブジェクトが含まれます。

{
  "access_token": "<access_token>",
  "refresh_token": "<refresh_token>",
  "user_id": "<user_id>",
  "device_id": "<device_id>"
}

access_tokenは App Services Admin API へのアクセスを許可します。 すべての管理 API リクエストのAuthorizationヘッダーに Bearer トークンとして含める必要があります。

環境値を定義する

環境値の作成エンドポイントを呼び出すことで、アプリの環境値を定義できます。 各環境値には名前と、環境タグを環境内の値にマッピングするvaluesオブジェクトがあります。

curl -X GET \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/environment_values/{environmentValueId} \
  -H 'Authorization: Bearer <access_token>' \
  -d '{
    "name": "myEnvironmentValue",
    "values": {
      "none": "alpha",
      "development": "beta",
      "testing": "gamma",
      "qa": "delta",
      "production": "epsilon"
    }
  }'

アプリ環境を設定する

アプリ環境の設定エンドポイントを呼び出すことで、アプリの環境タグを設定できます。

curl -X PUT \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/environment \
  -H 'Authorization: Bearer <access_token>' \
  -d '{ "environment": "production" }'