# App EngineとCloud Endpoints APIゲートウェイ導入方法

## 目次
1. はじめに
2. App Engine環境セットアップ
   - 2.1 Google Cloudプロジェクトの作成
   - 2.2 App Engineアプリケーションの作成
3. API仕様の定義
   - 3.1 OpenAPI仕様の作成
4. Cloud Endpointsの構成
   - 4.1 Endpointsサービスのデプロイ
   - 4.2 APIキーの生成
5. App EngineでのAPIゲートウェイの利用
   - 5.1 App Engineサービスの設定
   - 5.2 APIリクエストの確認
6. セキュリティと管理
   - 6.1 認証とアクセス制御の設定
   - 6.2 ロギングとモニタリング
7. まとめ

## 1. はじめに
App EngineはGoogle Cloud上でアプリケーションをホスティングするための完全マネージドサービスであり、Cloud EndpointsはAPIを管理するためのソリューションです。この記事では、App EngineとCloud Endpointsを組み合わせてAPIを管理するための具体的な手順を解説します。

## 2. App Engine環境セットアップ

### 2.1 Google Cloudプロジェクトの作成
最初にGoogle Cloud Platform（GCP）上で新しいプロジェクトを作成します。
1. [Google Cloud Console](https://console.cloud.google.com/)にアクセスします。
2. 「プロジェクトを選択」から新しいプロジェクトを作成します。
3. プロジェクトIDをメモします（後続のステップで使用）。

### 2.2 App Engineアプリケーションの作成
1. プロジェクトが選択された状態で、左上のメニューバーから「App Engine」を選択します。
2. 「設定」をクリックし、デフォルトの地域を選択してApp Engineアプリケーションを作成します。

## 3. API仕様の定義

### 3.1 OpenAPI仕様の作成
Cloud EndpointsはOpenAPI仕様を利用してAPIを定義します。以下は基本的なOpenAPI仕様の例です。

```yaml
openapi: "3.0.0"
info:
  title: "My API"
  version: "1.0.0"
paths:
  /hello:
    get:
      summary: "Returns a greeting"
      responses:
        '200':
          description: "A successful response"
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  message:
                    type: "string"
```

## 4. Cloud Endpointsの構成

### 4.1 Endpointsサービスのデプロイ
1. 作成したOpenAPI仕様ファイルを`api.yaml`として保存します。
2. gcloud CLIで以下のコマンドを実行し、デプロイします。

   ```sh
   gcloud endpoints services deploy api.yaml
   ```

### 4.2 APIキーの生成
1. Google Cloud Consoleの「APIとサービス」セクションに移動します。
2. 「認証情報」タブでAPIキーを生成します。
3. このキーは、API呼び出し時に認証に使用されます。

## 5. App EngineでのAPIゲートウェイの利用

### 5.1 App Engineサービスの設定
App Engineのコード内で、前節で導入したCloud Endpointsを利用してAPIルートを設定します。以下のような簡単なハンドラを作成します。

```python
from flask import Flask

app = Flask(__name__)

@app.route('/hello', methods=['GET'])
def hello():
    return {"message": "Hello, world!"}

if __name__ == '__main__':
    app.run(host='127.0.0.1', port=8080, debug=True)
```

### 5.2 APIリクエストの確認
APIが正常に動作することを確認するために、ブラウザやcurlコマンドを利用してエンドポイントをテストします。

```sh
curl -H "x-api-key: YOUR_API_KEY" https://YOUR_PROJECT_ID.appspot.com/hello
```

## 6. セキュリティと管理

### 6.1 認証とアクセス制御の設定
1. Cloud EndpointsでAPIキーを利用してリクエストを認証します。
2. 必要に応じてOAuth2認証を設定し、ユーザーのアクセスを管理します。

### 6.2 ロギングとモニタリング
1. Stackdriver（現：Cloud Operations）を利用してAPIリクエストのロギングとモニタリングを行います。
2. リクエスト数やエラーレートをダッシュボード上で可視化します。

## 7. まとめ
App EngineとCloud Endpointsを使用することで、スケーラブルかつ管理されたAPIを迅速に導入できます。セキュリティやアクセス制御の設定により、信頼性の高いサービスを提供可能です。この手順を基に、より複雑なアプリケーションやサービスへの展開を検討してみてください。 [cv:issue_marketplace_engineer]

App EngineとCloud Endpoints APIゲートウェイ導入方法

目次

続きを読むには単価診断を受けてください（30秒）