3.2. 샘플 Jenkins CI/CD 파이프라인 배포

절차

1. 3scale Hosted 관리 포털 콘솔에 로그인합니다.
2. 계정 관리 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. 개발자 계정 ID 를 저장합니다. /buyers/accounts/ 이후 URL의 마지막 부분입니다. 예를 들면 다음과 같습니다.

   export SAAS_DEVELOPER_ACCOUNT_ID=123...456

절차

1. 3scale 온-프레미스 관리 포털 콘솔에 로그인합니다.
2. 계정 관리 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. 개발자 계정 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. 2장. 3scale toolbox 사용 에 설명된 대로 3scale toolbox를 로컬로 설치합니다.

2. 적절한 toolbox 명령을 실행하여 3scale 원격 인스턴스를 생성합니다.

   3scale Hosted

   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
   • 하이브리드 - 오픈

   • 하이브리드 - 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 백엔드 예제를 배포합니다.

   • 다중 환경

   • 의미 체계 버전 관리

     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. 프로젝트에 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-rhel7:3scale2.7
   
   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-rhel7:3scale2.7
   
   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