このページは Cloud Translation API によって翻訳されました。

Edge Microgateway をサービスとしてデプロイ

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。詳細

はじめに

このトピックでは、次のように Kubernetes クラスタで Edge Appliance を実行する方法について説明します。 スタンドアロンサービス。

詳細については、Edge API と Kubernetes の統合の概要をご覧ください。

始める前に

前提条件に記載されている手順を完了します。

Edge AppSheet を構成する

次のコマンドで、Apigee 組織の Edge Appliance を構成します。プロキシ edgemicro-auth をデプロイします。

次のコマンドを実行します。

edgemicro configure -o [org] -e [env] -u [username]

ここで

org: Edge 組織名（組織管理者である必要があります）。
env: 組織の環境（テスト環境や本番環境など）。
username: Apigee アカウントに関連付けられているメールアドレス。

で確認できます。

例

edgemicro configure -o docs -e test -u jdoe@example.com

出力（以下の例）はファイルに保存されます。

$HOME/.edgemicro/org_name-env_name-config.yaml

。

current nodejs version is v6.9.1
current edgemicro version is 2.5.25
password:
file doesn't exist, setting up
Give me a minute or two... this can take a while...
App edgemicro-auth deployed.
checking org for existing KVM
KVM already exists in your org
configuring host edgemicroservices.apigee.net for region us-west1

saving configuration information to: /Users/jdoe/.edgemicro/myorg-test-config.yaml

vault info:
 -----BEGIN CERTIFICATE-----
MIICpDCCAYwCCQCV9eBcO9a5WzANBgkqhkiG9w0BAQsFADAUMRIwEAYDVQQDDAls
b2NhbGhvc3QwHhcNMagwODA5MDAzMDEzWhcNMTgwODEwMDAzMDEzWjAUMRIwEAYD
VQQDDBlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDh
nAHT7JHX/WvWHRFb8FLm53SPIDld5LyPOUfINdEyhSIEeXoOUKg4EPweJPVSC9Vm
Hw4ZMtEqWJM/XsQWvLe8ylRJa5wgmzmFCqAsuzs9+rmc9KvJqjpOh2uRTUf7KKfT
iXL2UEseprcI5g8zNyqKyEf/ecWIwz3AkkPAZebVTsrdDfIDHvkyhhvlAHZAB9kn
GtqP3N8kOlv4KQto9Gr7GYUGUIDugt7gM1F611+RBS+fYRi32GUAq/UQDkhYL8cp
oIJiF7UYkk2+9t9CdOCDuIUCvJioHJQd0xvDpkC9f6LvwjwnCwku+4F2Q63+av5I
mJoZJQPvW5aP53Qkk+kHAgMBAAEwDKYJKoZIhvcNAQELBQADggEBALyUBolXUFN8
1bf268nR+gS8MOFDTxO1bUz+bKuT/g3K1PuNUJTueT+0L1H2OiZUzazAqwn2sqzN
lQuvLg6LjxjlNkqTJGiJvGDcYVq45dv7UyxAZxhqxTxhlQ+Yu5R9pbQnzujezHpH
6gtCoCkSt/QqiJ3YsmsVu5is+HpIJepMt0CyMh5tK9j87hl46QhHklaVfQ3ycMVm
/wNPR/pjizg1FDUeq4nj/7DBVbMf9net/BDaZLeSW1HJ1vcsCXIcSZfQd4QymGFn
8ADrND7ydVjwO/s23soPDTy0g4yLIZvky2tpT8d7YahNqSv2n7sXsLxruzcyCoQ4
w+e3Z3F7IKI=
-----END CERTIFICATE-----

The following credentials are required to start edge micro
  key: 1a3b2754c7f20614817b86e09895825ecc252d34df6c4be21ae24356f09e6eb4
  secret: 16ad2431de73f07f57a6d44048f08d93b63f783bf1f2ac4221182aa7289c7cef

edgemicro configuration complete!

Edge AppSheet をサービスとしてデプロイする

次のコマンドを実行して、Apigee をサービスとして Kubernetes クラスタ:
```
kubectl apply -f <(edgemicroctl -org=org -env=env -key=edgemicro-key
-sec=edgemicro-secret -conf=file path of org-env-config.yaml)
```
ここで
- org - edgemicro configure コマンドで指定した Apigee 組織。
- env - edgemicro configure コマンドで指定した環境。
- edgemicro-key - edgemicro configure コマンドから返されたキー。
- edgemicro-secret - edgemicro configure コマンドから返されたシークレット。
- file path of org-env-config.yaml - edgemicro configure コマンドから返された Edge Micro 構成ファイルのパス。
例:
```
kubectl apply -f <(edgemicroctl -org=jdoe -env=test -key=989cce9d41cac94e72626d906562a1d76a19445f8901b3508858bb064988eccb -sec=ec92b793178de7b7e88e346f55a951e3fdae05e700e3ddea7d63977826379784 -conf=/Users/jdoe/.edgemicro/jdoe-test-config.yaml)
```
出力例:
```
config/myorg-test-config.yaml)
service "edge-microgateway" created
deployment "edge-microgateway" created
secret "mgwsecret" created
```
次のコードをコピーしてターミナルに貼り付けます。このコードは、Ingress コントローラを edge-microgateway サービスへの外部アクセス。必要に応じて次のコマンドをターミナルに貼り付けた後に実行します。
```
cat <<EOF | kubectl apply -f -
apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  name: edge-microgateway-ingress
  annotations:
    kubernetes.io/ingress.class: "nginx"
spec:
  rules:
  - http:
      paths:
      - path: /
        backend:
          serviceName: edge-microgateway
          servicePort: 8000
EOF
```
成功すると、次の出力が表示されます。
```
ingress "edge-microgateway-ingress" created
```
これで、外部アクセスを許可するように Ingress コントローラが edge-microgateway サービス。

テストサービスをデプロイする

次の手順では、シンプルなテストサービスをクラスタにデプロイします。「 Ingress コントローラにより、クラスタの外部から Service を呼び出せません。後で、サービスをターゲットとして呼び出すように Edge Appliance を構成します。 Ingress コントローラは、edge-microgateway サービスへの外部アクセスを許可します。

サンプルの helloworld サービスをデプロイします。Ingress はコンテナのクラスタの外部からサービスを呼び出すことはできません。
```
kubectl apply -f samples/helloworld/helloworld-service.yaml
```
出力例:
```
service "helloworld" created deployment "helloworld" created
```

デプロイが成功したことを確認します。Cloud Identity には外部 IP アドレスが helloworld サービス。次の手順では、Edge をアクセスするために使用します。

kubectl get services -n default

出力例:

NAME                TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)          AGE
edge-microgateway   NodePort    10.35.247.222   <none>        8000:32000/TCP   12m
helloworld          NodePort    10.35.245.103   <none>        8081:30294/TCP   47s
kubernetes          ClusterIP   10.35.240.1     <none>        443/TCP          47m

サービスのプロキシを行うように Edge AppSheet を構成する

helloworld サービスの内部 IP を取得し、ターゲットとして追加します。「マイクロゲートウェイ対応」のあります。「マイクロゲートウェイ対応」のプロキシは要件があります。

mTLS 対応について知っておくべきこともご覧ください。 proxy をご覧ください。

テストサービスの内部 IP を取得する

helloworld サービスの内部クラスタ IP とポートを取得します。

kubectl get services helloworld

出力例:

NAME         TYPE       CLUSTER-IP      EXTERNAL-IP   PORT(S)          AGE
helloworld   NodePort   10.55.254.255   <none>        8081:30329/TCP   3m

CLUSTER-IP と PORT の値をコピーします。たとえば、上記の値は、10.55.254.255 と 8081 です。お客様の異なります

Edge に Apigee 対応プロキシを作成する

Edge UI にログインします。
以前に構成したときに指定した組織を選択します。説明します。
[Develop >API プロキシ] をクリックします。
[+ Proxy] をクリックします。[Build a Proxy] ウィザードが開きます。
ウィザードの最初のページで、[Reverse proxy (most common)] を選択します。
[次へ] をクリックします。
ウィザードの [Details] ページで、次のように構成します。以下の欄に必ずご記入ください示されているとおりに操作します。プロキシ名に接頭辞があることを確認してください edgemicro_。
1. プロキシ名: edgemicro_hello
2. プロキシベースパス: /hello
  
  重要: 次のステップでは、作成したクラスタの IP 番号とポート番号番号を使用します。必要があります。これはプロキシのターゲット IP です。
3. 既存の API: http://<cluster_ip>:<port>
  
  例: http://10.55.254.255:8081
[次へ] をクリックします。
ウィザードの [Security] ページで、[Pass through (none)] を選択します。
[次へ] をクリックします。
ウィザードの [Virtual Hosts] ページで、デフォルト値を受け入れます。
[次へ] をクリックします。
ウィザードの [Build] ページでプロキシ設定を確認します。必ず、 test 環境が選択されています。
[Build and Deploy] をクリックします。

デベロッパーを作成する

テスト用の既存のデベロッパーを使用するか、次のようにしてデベロッパーを新しく作成できます。

サイドナビゲーションメニューで [Publish] > [Developers] を選択します。
[+ Developer] をクリックします。
新しいデベロッパーを作成するためにダイアログに入力します。任意のデベロッパーを使用できます。名前またはメールアドレスを入力します。

API プロダクトを作成する

以下の手順に沿って API プロダクトを作成します。2 つのプロキシをプロダクト: edgemicro-auth と edgemicro_hello

詳しくは、 API プロダクトについて知っておくべきことのプロダクト構成オプション構成します。

サイドナビゲーションメニューで、[Publish] > [API Products] を選択します。
[+ API Product] をクリックします。[Product Details] ページが表示されます。
[Product Details] ページに、次のように入力します。[保存] は、次の時点まで指示があります。

名前 hello-world-product

表示名 Edge Micro hello product

環境 test

アクセス Public

鍵承認タイプ Automatic
ページの下半分で、[+ Custom Resource] をクリックします。
リソースを / （単一のスラッシュ）に設定します。
もう一度 [+ Custom Resource] を選択し、パス /** を追加します。
ページの下部にある [+ API Proxy] をクリックします。
edgemicro-auth という名前のプロキシを選択します。
もう一度 [+ API Proxy] をクリックします。
edgemicro_hello という名前の Apigee 対応プロキシを選択します。
[保存] をクリックします。

デベロッパーアプリを作成する

サイドナビゲーションメニューで、[Publish] > [Apps] を選択します。
[+ App] をクリックします。[Developer App Details] ページが表示されます。

[Developer App] ページに、次のように入力します。指示があるまで保存しないできます。

名前	`hello-world-app`
表示名	`Edge Micro hello app`
デベロッパー	作成したテストデベロッパーを選択しなくても、どのデベロッパーでもかまいません。

[Credentials] セクションで [+ Product] をクリックし、目的のプロダクトを選択します。作成日: hello-world-product.
[保存] をクリックします。
すべてのデベロッパーアプリを一覧表示するページに戻ります。
作成したアプリ hello-world-app を選択します。
[Consumer Key] の横にある [Show] をクリックします。
コンシューマキーの値をコピーします。この値は API キー: 次のサービスに対して安全な API 呼び出しを行います。 /hello。
数分待って、Apigee で行った変更が反映されるまでに数分かかりますにデプロイされた Edge Dataproc のインスタンスと Edge を同期します。作成します。

注: Edge Dataproc は、Apigee Edge で行われた変更を 600 ごとにポーリングします。秒（デフォルト）で、プロキシに対する構成の変更が pull されます。 API プロダクト、デベロッパーアプリなどがあります。デフォルトの 600 秒を変更するには、Edge の宣言します。詳細については、Edge API とドキュメントをご覧ください。

プロキシをテストする

Ingress の IP アドレスを取得する

Ingress の外部 IP を使用して、Edge API サービスを呼び出せます。実行することもできます。

Ingress コントローラの外部 IP アドレスを取得します。

kubectl get ing -o wide

出力例:

NAME                        HOSTS     ADDRESS          PORTS     AGE
edge-microgateway-ingress   *         35.238.249.62    80        37m

Ingress の ADDRESS 値をコピーして、変数にエクスポートします。マイページ次のように変数を手動で設定できます。
```
export GATEWAY_IP=external_ip
```
例:
```
export GATEWAY_IP=35.238.249.62
```
または、次のコマンドを使用して自動的に設定します。
```
export GATEWAY_IP=$(kubectl describe ing edge-microgateway --namespace default | grep "Address" | cut -d ':' -f2 | tr -d "[:space:]")
```
変数がエクスポートされたことを確認します。例:
```
echo $GATEWAY_IP
```
出力例:
```
35.238.249.62
```

API を呼び出す

構成の変更がマイクロゲートウェイに取り込まれたら、次のことができます。 API を呼び出してみてくださいIngress コントローラの IP（変数 GATEWAY_IP に保存）を使用します。 API を呼び出す必要があります。この IP では、Kubernetes クラスタの外部からプロキシを呼び出すことができます。「 Ingress から Edge Appliance へのマッピングは、Edge Appliance をデプロイしたときに作成されています。デプロイします。

API キーなしで API を呼び出す。次のようなエラーメッセージが表示されます。下にあります。
```
curl $GATEWAY_IP:80/hello/
```
予想される出力:
```
{"error":"missing_authorization","error_description":"Missing Authorization
header"}
```
このメッセージが表示された場合は、同期が完了するまでもう少し待つ必要があるかもしれません。完了する:
```
{"message":"no match found for /hello/","status":404}
```
API 呼び出しを成功させるには、API キーが必要です。
作成したデベロッパーアプリからコンシューマキーを取得します。この値はテストプロキシの呼び出しに必要な API キー:
```
curl -H 'x-api-key:your-edge-api-key' $GATEWAY_IP:80/hello/
```
例:
```
curl -H "x-api-key:DeX2eEesYAdRJ5Gdbo77nT9uUfJZql19" $GATEWAY_IP:80/hello/
```
出力:
```
Hello world
```
「Hello World」と表示されたら「新規顧客の獲得」目標を Kubernetes 内の helloworld サービスを呼び出す Edge Appliance 作成します。

次のステップ

詳細については、タスクセクションをご覧くださいカスタムプラグインの追加、デプロイのスケーリング、構成の変更、実行したい他のタスクを実行できます

名前	`hello-world-product`
表示名	`Edge Micro hello product`
環境	`test`
アクセス	`Public`
鍵承認タイプ	`Automatic`

Edge Microgateway をサービスとしてデプロイ

はじめに

始める前に

Edge AppSheet を構成する

Edge AppSheet をサービスとしてデプロイする

テストサービスをデプロイする

サービスのプロキシを行うように Edge AppSheet を構成する

テストサービスの内部 IP を取得する

Edge に Apigee 対応プロキシを作成する

デベロッパーを作成する

API プロダクトを作成する

デベロッパー アプリを作成する

プロキシをテストする

Ingress の IP アドレスを取得する

API を呼び出す

次のステップ

デベロッパーアプリを作成する