8.7. 3scale ActiveDoc カスタムリソースのデプロイ

手順

1. シークレットを作成します。以下に例を示します。

   $ oc create secret generic myoasdoc1 --from-file myoasdoc1.yaml
   
   secret/myoasdoc1 created

   Copy to Clipboard Toggle word wrap

2. ActiveDoc CR を定義します。OAS ドキュメントが含まれるシークレットへの参照を指定するようにしてください。たとえば、myactivedoccr1.yaml ファイルを作成できます。

   apiVersion: capabilities.3scale.net/v1beta1
   kind: ActiveDoc
   metadata:
     name: myactivedoccr1
   spec:
     name: "Operated ActiveDoc From secret"
     activeDocOpenAPIRef:
       secretRef:
         name: myoasdoc1

   Copy to Clipboard Toggle word wrap

3. 定義したばかりのリソースを作成します。以下に例を示します。

   $ oc create -f myactivedoccr1.yaml

   Copy to Clipboard Toggle word wrap

   この例では、出力は以下のようになります。

   activedoc.capabilities.3scale.net/myactivedoccr1 created

   Copy to Clipboard Toggle word wrap

検証

1. Red Hat OpenShift Container Platform (OCP) 管理者アカウントにログインします。
2. Operators > Installed Operators に移動します。
3. Red Hat Integration - 3scale をクリックします。
4. Active Doc タブをクリックします。
5. OAS ドキュメントが存在することを確認します。上記の例では、myactivedoccr1 という名前の新しい OAS ドキュメントが表示されます。

手順

1. OpenShift アカウントで、Operators > Installed operators に移動します。
2. 3scale operator をクリックします。
3. Active Doc タブをクリックします。

4. ActiveDoc CR を作成します。以下に例を示します。

   apiVersion: capabilities.3scale.net/v1beta1
   kind: ActiveDoc
   metadata:
     name: myactivedoccr1
   spec:
     openapiRef:
       url: "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/master/examples/v3.0/petstore.yaml"
     providerAccountRef:
       name: mytenant

   Copy to Clipboard Toggle word wrap

5. オプション。Self-managed APIcast の場合、ActiveDoc CR で productionPublicBaseURL および stagingPublicBaseURL フィールドをデプロイメントの URL に設定します。以下に例を示します。

   apiVersion: capabilities.3scale.net/v1beta1
   kind: ActiveDoc
   metadata:
     name: myactivedoccr1
   spec:
     openapiRef:
       url: "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/master/examples/v3.0/petstore.yaml"
     productionPublicBaseURL: "https://production.my-gateway.example.com"
     stagingPublicBaseURL: "https://staging.my-gateway.example.com"

   Copy to Clipboard Toggle word wrap
6. Save をクリックします。3scale operator が ActiveDoc CR を作成するまでに数秒かかります。

検証

1. Red Hat OpenShift Container Platform (OCP) 管理者アカウントにログインします。
2. Operators > Installed Operators に移動します。
3. Red Hat Integration 3scale をクリックします。
4. Active Doc タブをクリックします。
5. OAS ドキュメントが存在することを確認します。上記の例では、myactivedoccr1 という名前の新しい OAS ドキュメントが表示されます。