4.2. サンプル Jenkins CI/CD パイプラインのデプロイ

手順

1. ホスト型 3scale 管理ポータルコンソールにログインします。
2. Account Management API への書き込みアクセス権限を設定して、新しいアクセストークンを生成します。

3. 後で使用できるように、生成されたアクセストークンを保存します。以下に例を示します。

   export SAAS_ACCESS_TOKEN=123...456

4. 後で使用できるように、3scale テナントの名前を保存します。これは、管理ポータル URL の -admin.3scale.net の前にある文字列です。以下に例を示します。

   export SAAS_TENANT=my_username

5. 管理ポータルで Audience > Accounts > Listing の順に移動します。
6. Developer をクリックします。

7. Developer Account ID を保存します。これは、/buyers/accounts/ に続く URL の最後の部分です。以下に例を示します。

   export SAAS_DEVELOPER_ACCOUNT_ID=123...456

手順

1. オンプレミス型 3scale 管理ポータルコンソールにログインします。
2. Account Management API への書き込みアクセス権限を設定して、新しいアクセストークンを生成します。

3. 後で使用できるように、生成されたアクセストークンを保存します。以下に例を示します。

   export SAAS_ACCESS_TOKEN=123...456

4. 後で使用できるように、3scale テナントの名前を保存します。

   export ONPREM_ADMIN_PORTAL_HOSTNAME="$(oc get route system-provider-admin -o jsonpath='{.spec.host}')"

5. ワイルドカードルートを定義します。

   export OPENSHIFT_ROUTER_SUFFIX=app.openshift.test # Replace me!
   
   export APICAST_ONPREM_STAGING_WILDCARD_DOMAIN=onprem-staging.$OPENSHIFT_ROUTER_SUFFIX
   
   export APICAST_ONPREM_PRODUCTION_WILDCARD_DOMAIN=onprem-production.$OPENSHIFT_ROUTER_SUFFIX

   注記

   OPENSHIFT_ROUTER_SUFFIX の値を OpenShift ルーターの接尾辞に設定する必要があります (たとえば、app.openshift.test)。

6. ワイルドカードルートを既存のオンプレミス型 3scale インスタンスに追加します。

   oc create route edge apicast-wildcard-staging --service=apicast-staging --hostname="wildcard.$APICAST_ONPREM_STAGING_WILDCARD_DOMAIN" --insecure-policy=Allow --wildcard-policy=Subdomain
   
   oc create route edge apicast-wildcard-production --service=apicast-production --hostname="wildcard.$APICAST_ONPREM_PRODUCTION_WILDCARD_DOMAIN" --insecure-policy=Allow --wildcard-policy=Subdomain

7. 管理ポータルで Audience > Accounts > Listing の順に移動します。
8. Developer をクリックします。

9. Developer Account ID を保存します。これは、/buyers/accounts/ に続く URL の最後の部分です。

   export ONPREM_DEVELOPER_ACCOUNT_ID=5

手順

1. RH-SSO のドキュメント で説明されているように、RH-SSO 7.3 をデプロイします。

   以下のコマンド例は、簡単なサマリーを提供します。

   oc replace -n openshift --force -f https://raw.githubusercontent.com/jboss-container-images/redhat-sso-7-openshift-image/sso73-dev/templates/sso73-image-stream.json
   
   oc replace -n openshift --force -f https://raw.githubusercontent.com/jboss-container-images/redhat-sso-7-openshift-image/sso73-dev/templates/sso73-x509-postgresql-persistent.json
   
   oc -n openshift import-image redhat-sso73-openshift:1.0
   
   oc policy add-role-to-user view system:serviceaccount:$(oc project -q):default
   
   oc new-app --template=sso73-x509-postgresql-persistent --name=sso -p DB_USERNAME=sso -p SSO_ADMIN_USERNAME=admin -p DB_DATABASE=sso

2. 後で使用できるように、RH-SSO インストールのホスト名を保存します。

   export SSO_HOSTNAME="$(oc get route sso -o jsonpath='{.spec.host}')"

3. 3scale デベロッパーポータルのドキュメント で説明されているように 3scale 向けに RH-SSO を設定します。

4. 後で使用できるように、レルム名、クライアント ID、およびクライアントシークレットを保存します。

   export REALM=3scale
   
   export CLIENT_ID=3scale-admin
   
   export CLIENT_SECRET=123...456

手順

1. 3scale toolbox で説明されているように、ローカルに 3scale toolbox をインストールします。

2. 適切な toolbox コマンドを実行して、3scale のリモートインスタンスを作成します。

   ホスト型 3scale

   3scale remote add 3scale-saas "https://$SAAS_ACCESS_TOKEN@$SAAS_TENANT-admin.3scale.net/"

   オンプレミス型 3scale

   3scale remote add 3scale-onprem "https://$ONPREM_ACCESS_TOKEN@$ONPREM_ADMIN_PORTAL_HOSTNAME/"

3. 以下の OpenShift コマンドを実行して、3scale 管理ポータルとアクセストークンが含まれるシークレットをプロビジョニングします。

   oc create secret generic 3scale-toolbox -n "$TOOLBOX_NAMESPACE" --from-file="$HOME/.3scalerc.yaml"

手順

1. 以下のサンプルで使用するために、Beer Catalog API バックエンドの例をデプロイします。

   • SaaS - API key
   • Hybrid - open

   • Hybrid - OIDC

     oc new-app -n "$TOOLBOX_NAMESPACE" -i openshift/redhat-openjdk18-openshift:1.4 https://github.com/microcks/api-lifecycle.git --context-dir=/beer-catalog-demo/api-implementation --name=beer-catalog
     
     oc expose -n "$TOOLBOX_NAMESPACE" svc/beer-catalog

2. 後で使用できるように、Beer Catalog API のホスト名を保存します。

   export BEER_CATALOG_HOSTNAME="$(oc get route -n "$TOOLBOX_NAMESPACE" beer-catalog -o jsonpath='{.spec.host}')"

3. 以下のサンプルで使用するために、Red Hat Event API バックエンドの例をデプロイします。

   • Multi-environment

   • Semantic versioning

     oc new-app -n "$TOOLBOX_NAMESPACE" -i openshift/nodejs:10 'https://github.com/nmasse-itix/rhte-api.git#085b015' --name=event-api
     
     oc expose -n "$TOOLBOX_NAMESPACE" svc/event-api

4. 後で使用できるように、Event API のホスト名を保存します。

   export EVENT_API_HOSTNAME="$(oc get route -n "$TOOLBOX_NAMESPACE" event-api -o jsonpath='{.spec.host}')"

手順

1. ワイルドカードルートを定義します。

   export APICAST_SELF_MANAGED_STAGING_WILDCARD_DOMAIN=saas-staging.$OPENSHIFT_ROUTER_SUFFIX
   
   export APICAST_SELF_MANAGED_PRODUCTION_WILDCARD_DOMAIN=saas-production.$OPENSHIFT_ROUTER_SUFFIX

2. Self-managed APIcast インスタンスをプロジェクトにデプロイします。

   oc create secret generic 3scale-tenant --from-literal=password=https://$SAAS_ACCESS_TOKEN@$SAAS_TENANT-admin.3scale.net
   
   oc create -f https://raw.githubusercontent.com/3scale/apicast/v3.5.0/openshift/apicast-template.yml
   
   oc new-app --template=3scale-gateway --name=apicast-staging -p CONFIGURATION_URL_SECRET=3scale-tenant -p CONFIGURATION_CACHE=0 -p RESPONSE_CODES=true -p LOG_LEVEL=info -p CONFIGURATION_LOADER=lazy -p APICAST_NAME=apicast-staging -p DEPLOYMENT_ENVIRONMENT=sandbox -p IMAGE_NAME=registry.redhat.io/3scale-amp2/apicast-gateway-rhel8:3scale2.8
   
   oc new-app --template=3scale-gateway --name=apicast-production -p CONFIGURATION_URL_SECRET=3scale-tenant -p CONFIGURATION_CACHE=60 -p RESPONSE_CODES=true -p LOG_LEVEL=info -p CONFIGURATION_LOADER=boot -p APICAST_NAME=apicast-production -p DEPLOYMENT_ENVIRONMENT=production -p IMAGE_NAME=registry.redhat.io/3scale-amp2/apicast-gateway-rhel8:3scale2.8
   
   oc scale dc/apicast-staging --replicas=1
   
   oc scale dc/apicast-production --replicas=1
   
   oc create route edge apicast-staging --service=apicast-staging --hostname="wildcard.$APICAST_SELF_MANAGED_STAGING_WILDCARD_DOMAIN" --insecure-policy=Allow --wildcard-policy=Subdomain
   
   oc create route edge apicast-production --service=apicast-production --hostname="wildcard.$APICAST_SELF_MANAGED_PRODUCTION_WILDCARD_DOMAIN" --insecure-policy=Allow --wildcard-policy=Subdomain

手順

1. 提供される OpenShift テンプレートを使用して、Jenkins パイプラインをインストールします。

   oc process -f saas-usecase-apikey/setup.yaml \
              -p DEVELOPER_ACCOUNT_ID="$SAAS_DEVELOPER_ACCOUNT_ID" \
              -p PRIVATE_BASE_URL="http://$BEER_CATALOG_HOSTNAME" \
              -p NAMESPACE="$TOOLBOX_NAMESPACE" |oc create -f -

2. サンプルを以下のようにデプロイします。

   oc start-build saas-usecase-apikey