3scale 설치

1. 새 데이터베이스를 만듭니다.

   Oracle Database가 3scale로 작동하려면 다음 설정이 필요합니다.

   ALTER SYSTEM SET max_string_size=extended SCOPE=SPFILE;
   ALTER SYSTEM SET compatible='12.2.0.1' SCOPE=SPFILE;

   Copy to Clipboard Toggle word wrap

2. 데이터베이스 세부 정보를 수집합니다.

   3scale 구성에 필요한 다음 정보를 가져옵니다.

   • Oracle 데이터베이스 URL
   • Oracle Database 서비스 이름

   • Oracle Database 시스템 암호

     DestinationRule _URL 매개변수는 다음 형식을 따라야 합니다.

절차

1. 3scale OpenShift 템플릿 GitHub 리포지토리를 복제합니다. 다음 명령을 사용합니다.

   $ git clone --branch 2.6.0.GA https://github.com/3scale/3scale-amp-openshift-templates.git

   Copy to Clipboard Toggle word wrap
2. Oracle Database Instant Client Package 파일을 3scale-amp-openshift-templates/amp/system-oracle/oracle-client-files 디렉터리에 배치합니다.
3. 3scale 2.6 amp.yml 템플릿을 다운로드합니다.

4. -f 옵션을 사용하여 oc new-app 명령을 실행하고 build.yml OpenShift 템플릿을 지정합니다.

   $ oc new-app -f build.yml

   Copy to Clipboard Toggle word wrap

5. oc new-app 명령을 -f 옵션과 함께 실행하여 amp.yml OpenShift 템플릿을 표시하고 -p 옵션을 사용하여 OpenShift 클러스터 도메인으로 WILDCARD_DOMAIN 매개변수를 지정합니다.

   $ oc new-app -f amp.yml -p WILDCARD_DOMAIN=mydomain.com

   Copy to Clipboard Toggle word wrap

6. 다음 oc 패치 명령을 입력하고 SYSTEM_PASSWORD 를 1.2절. “Oracle 데이터베이스 준비” 에서 설정한 Oracle Database 시스템 암호로 교체합니다.

   $ oc patch dc/system-app -p '[{"op": "add", "path": "/spec/strategy/rollingParams/pre/execNewPod/env/-", "value": {"name": "ORACLE_SYSTEM_PASSWORD", "value": "SYSTEM_PASSWORD"}}]' --type=json
   
   $ oc patch dc/system-app -p '{"spec": {"strategy": {"rollingParams": {"post":{"execNewPod": {"env": [{"name": "ORACLE_SYSTEM_PASSWORD", "value": "SYSTEM_PASSWORD"}]}}}}}}'

   Copy to Clipboard Toggle word wrap

7. 1.2절. “Oracle 데이터베이스 준비” 에 지정된 Oracle 데이터베이스를 가리키도록 다음 명령을 입력하고 DestinationRule _URL 을 대체합니다.

   $ oc patch secret/system-database -p '{"stringData": {"URL": "DATABASE_URL"}}'

   Copy to Clipboard Toggle word wrap

8. 다음 명령을 사용하여 가져오기 보안을 빌더에 연결합니다.

   $ oc secrets link builder threescale-registry-auth

   Copy to Clipboard Toggle word wrap

9. oc start-build 명령을 입력하여 새 시스템 이미지를 빌드합니다.

   $ oc start-build 3scale-amp-system-oracle --from-dir=.

   Copy to Clipboard Toggle word wrap

1. 각 노드에 RHEL(Red Hat Enterprise Linux)을 설치합니다.
2. 인터페이스 또는 명령줄을 통해 RHSM(Red Hat Subscription Manager)을 사용하여 Red Hat에 노드를 등록합니다.
3. RHSM 을 사용하여 3scale 서브스크립션에 노드를 연결합니다.

4. 노드에 OpenShift를 설치하고 다음 요구 사항을 준수합니다.

   • 지원되는 OpenShift 버전을 사용합니다.
   • 여러 쓰기를 지원하는 파일 시스템에서 영구 스토리지를 구성합니다.
5. OpenShift 명령줄 인터페이스를 설치합니다.

6. 서브스크립션 관리자를 사용하여 rhel-7-server-3scale-amp-2.6-rpms 리포지토리에 대한 액세스를 활성화합니다.

   sudo subscription-manager repos --enable=rhel-7-server-3scale-amp-2.6-rpms

   Copy to Clipboard Toggle word wrap

7. 3scale-amp-template이라는 3scale 템플릿을 설치합니다. 이는 /opt/amp/templates에 저장됩니다.

   sudo yum install 3scale-amp-template

   Copy to Clipboard Toggle word wrap

1. 기본적으로 개발자로 로그인하여 다음 단계를 진행할 수 있습니다.

   그렇지 않으면 이전 단계에서 다운로드하여 설치한 OpenShift 클라이언트 툴에서 oc login 명령을 사용하여 OpenShift에 로그인합니다. 기본 로그인 인증 정보는 username = " developer" 및 password = " developer" 입니다.

   oc login https://OPENSHIFT-SERVER-IP:8443

   Copy to Clipboard Toggle word wrap

   Login successful. 출력이 표시되어야 합니다.

2. 프로젝트를 생성합니다. 이 예에서는 표시 이름을 게이트웨이로설정

   oc new-project "3scalegateway" --display-name="gateway" --description="3scale gateway demo"

   Copy to Clipboard Toggle word wrap

   응답은 다음과 같아야 합니다.

   Now using project "3scalegateway" on server "https://172.30.0.112:8443".

   Copy to Clipboard Toggle word wrap

   명령 프롬프트의 텍스트 출력에서 제안된 다음 단계를 무시하고 아래의 다음 단계로 진행합니다.

3. <access_token> 및 <domain>을 자체 인증 정보로 교체하여 프로젝트를 참조하는 새 시크릿을 생성합니다. <access_token> 및 <domain>에 대한 자세한 내용은 아래를 참조하십시오.

   oc create secret generic apicast-configuration-url-secret --from-literal=password=https://<access_token>@<admin_portal_domain>  --type=kubernetes.io/basic-auth

   Copy to Clipboard Toggle word wrap

   여기서 < access_token >은 3scale 계정 관리 API의 액세스 토큰 (서비스 토큰이 아님)이며 < domain>-admin.3scale.net 은 3scale 관리자 포털의 URL입니다.

   응답은 다음과 같아야 합니다.

   secret/apicast-configuration-url-secret

   Copy to Clipboard Toggle word wrap

4. 템플릿에서 APIcast 게이트웨이 애플리케이션을 생성하고 배포를 시작합니다.

   oc new-app -f https://raw.githubusercontent.com/3scale/3scale-amp-openshift-templates/2.6.0.GA/apicast-gateway/apicast.yml

   Copy to Clipboard Toggle word wrap

   출력 하단에 다음 메시지가 표시됩니다.

   --> Creating resources with label app=3scale-gateway ...
       deploymentconfig "apicast" created
       service "apicast" created
   --> Success
       Run 'oc status' to view your app.

   Copy to Clipboard Toggle word wrap

1. 브라우저에서 OpenShift 클러스터의 웹 콘솔을 엽니다. https://OPENSHIFT-SERVER-IP:8443/console/

   원격 서버에서 OpenShift 클러스터를 시작한 경우 OPENSHIFT-SERVER-IP 대신 --public-hostname에 지정된 값을 사용합니다.

   로그인 화면이 표시됩니다.

   

   View larger image

   
   참고

   신뢰할 수 없는 웹 사이트에 대한 경고가 표시될 수 있습니다. 이는 유효한 인증서를 구성하지 않고도 보안 프로토콜을 통해 웹 콘솔에 액세스하려고 하기 때문에 이는 예상된 결과입니다. 프로덕션 환경에서 이 문제를 방지해야 하지만 이 테스트 설정에서는 계속 진행하여 이 주소에 대한 예외를 생성할 수 있습니다.

2. 위의 OpenShift 설치 섹션에서 만들거나 가져온 개발자 자격 증명을 사용하여 로그인합니다.

   위의 명령줄에서 생성한 게이트웨이 프로젝트를 포함하여 프로젝트 목록이 표시됩니다.

   

   View larger image

   

   게이트웨이 프로젝트가 표시되지 않으면 다른 사용자로 만들었을 수 있으며 이 사용자에게 정책 역할을 할당해야 합니다.

3. 게이트웨이 링크를 클릭하면 개요 탭이 표시됩니다.

   OpenShift는 APIcast용 코드를 다운로드하고 배포를 시작했습니다. 배포가 진행 중일 때 실행 중인 Deployment #1 메시지가 표시될 수 있습니다.

   빌드가 완료되면 UI가 새로 고침되고 템플릿에 정의된 OpenShift에서 시작한 APIcast 2개(포드 ) 인스턴스가 두 개 표시됩니다.

   

   View larger image

   

   각 APIcast 인스턴스는 시작 시 3scale 관리 포털의 통합 페이지에서 제공한 설정을 사용하여 3scale에서 필요한 구성을 다운로드합니다.

   OpenShift는 두 개의 APIcast 인스턴스를 유지 관리하고 두가지 모두의 상태를 모니터링합니다. 비정상 APIcast 인스턴스는 자동으로 새 APIcast 인스턴스로 교체됩니다.

4. APIcast 인스턴스가 트래픽을 수신하도록 허용하려면 경로를 생성해야 합니다. 경로 생성을 클릭하여 시작합니다.

   

   View larger image

   

   위의 3scale에 설정한 것과 동일한 호스트를 Public Base URL 섹션에 (http:// 및 포트 없이) gateway.openshift.demo와 같이 입력한 다음 만들기 버튼을 클릭합니다.

   

   View larger image

   

   정의하는 모든 3scale 서비스에 대해 새 경로를 생성해야 합니다.

1. 모든 리포지토리 나열합니다: sudo yum repolist all.
2. *-extras 리포지토리를 찾습니다.
3. extras 리포지토리 sudo yum-config-manager --enable rhui-REGION-rhel-server-extras를 활성화합니다.
4. Docker 컨테이너 환경 패키지 설치: sudo yum install docker.

1. Docker 데몬을 시작합니다.

   sudo systemctl start docker.service.

2. Docker 데몬이 실행 중인지 확인합니다.

   sudo systemctl status docker.service.

   Red Hat 레지스트리에서 Docker 형식의 컨테이너 이미지를 사용할 준비가 되어 있는 경우 다음을 다운로드할 수 있습니다.

   sudo docker pull registry.access.redhat.com/3scale-amp26/apicast-gateway.

3. Docker 형식의 컨테이너에서 APIcast를 실행합니다.

   sudo docker run --name apicast --rm -p 8080:8080 -e THREESCALE_PORTAL_ENDPOINT=https://<access_token>@<domain>-admin.3scale.net registry.access.redhat.com/3scale-amp26/apicast-gateway.

   여기서 <access_token>은 3scale 계정 관리 API의 액세스 토큰입니다. 액세스 토큰 대신 공급자 키를 사용할 수 있습니다. <domain>-admin.3scale.net 은 3scale 관리 포털의 URL입니다.

절차

1. OpenShift Container Platform 콘솔에서 관리자 권한이 있는 계정을 사용하여 로그인합니다.
2. 카탈로그 > OperatorHub를 클릭합니다.
3. 키워드로 필터링 상자에3scale operator를 입력하여 3scale operator 찾습니다.
4. 3scale Operator를 클릭합니다. Operator에 대한 정보가 표시됩니다.
5. Operator에 대한 정보를 읽고 설치를 클릭합니다. Create Operator Subscription 페이지가 열립니다.

6. Create Operator Subscription 페이지에서 기본 선택 사항을 모두 수락하고 서브스크립션을 클릭합니다.

   참고

   Operator는 선택한 클러스터의 특정 단일 네임 스페이스에서만 사용할 수 있습니다.

   3scale-operator 세부 정보 페이지가 표시됩니다. 여기서 서브스크립션 개요가 표시됩니다.

7. 서브스크립션 업그레이드 상태가 Up to date 로 표시되면 Catalog > Installed Operators 를 클릭하여 3scale Operator CSV(ClusterServiceVersion)가 표시되고 상태가 결국 operator-test 프로젝트에서 InstallSucceeded로 표시되는지 확인합니다.

   1. 설치에 성공하면 OpenShift API 서버에서 Operator의 기능 기능과 관련된 APIManager CRD 및 CRD가 등록됩니다.

8. 성공적으로 설치한 후 oc get를 통해 CRD에서 정의한 리소스 유형을 쿼리합니다.

   1. 예를 들어 APIManager CRD가 올바르게 등록되었는지 확인하려면 다음 명령을 실행합니다.

      oc get apimanagers

      Copy to Clipboard Toggle word wrap

9. 다음 출력이 표시되어야 합니다.

   No resources found.

   Copy to Clipboard Toggle word wrap

   문제 해결 정보는 OpenShift Container Platform 설명서를 참조하십시오.

절차

1. 3scale 온-프레미스 인스턴스가 호스팅되는 OpenShift 노드에 로그인하고 해당 프로젝트로 변경합니다.

   oc login -u <user> <url>
   oc project <3scale-project>

   Copy to Clipboard Toggle word wrap

   <user>, <url>, <3scale-project> 를 사용자 고유의 자격 증명 및 프로젝트 이름으로 바꿉니다.

2. 표시된 순서에 따라 모든 pod를 축소합니다. 이는 데이터 손실을 방지 할 것입니다.

   3scale 온-프레미스 중지

   OpenShift 웹 콘솔 또는 CLI(명령줄 인터페이스)에서 모든 배포 구성을 다음 순서로 0개의 복제본으로 축소합니다.

   • 3scale 2.6 이전 버전의 경우 apicast-wildcard-router 및 zync 3scale 2.6 이상 버전의 경우 zync-que 및 zync
   • apicast-staging 및 apicast-production.

   • system-sidekiq, backend-cron, system-sphinx.

     • 3scale 2.3에는 system-resque가 포함되어 있습니다.
   • system-app.
   • backend-listener 및 backend-worker.

   • backend-redis,system-memcache,system-mysql,system-redis, zync-database.

     다음 예제에서는 apicast-wildcard-router 및 zync 에 대해 CLI에서 이 작업을 수행하는 방법을 보여줍니다.

     oc scale dc/apicast-wildcard-router --replicas=0
     oc scale dc/zync --replicas=0

     Copy to Clipboard Toggle word wrap
     참고

     각 단계에 대한 배포 구성은 동시에 축소할 수 있습니다. 예를 들어 apicast-wildcard-router 및 zync를 함께 축소할 수 있습니다. 그러나 다음 항목을 축소하기 전에 각 단계의 Pod가 종료될 때까지 기다리는 것이 좋습니다. 3scale 인스턴스는 완전히 다시 시작될 때까지 완전히 액세스할 수 없습니다.

3. 3scale 프로젝트에서 실행 중인 Pod가 없는지 확인하려면 다음 명령을 사용합니다.

   oc get pod

   Copy to Clipboard Toggle word wrap

   명령에서 리소스를 찾을 수 없음을 반환해야 합니다.

4. 다음 명령을 사용하여 데이터베이스 수준 Pod를 다시 확장합니다.

   oc scale dc/{backend-redis,system-memcache,system-mysql,system-redis,zync-database} --replicas=1

   Copy to Clipboard Toggle word wrap

5. 다음 단계를 진행하기 전에 system-mysql pod를 통해 외부 MySQL 데이터베이스에 로그인할 수 있는지 확인합니다.

   oc rsh system-mysql-<system_mysql_pod_id>
   mysql -u root -p -h <host>

   Copy to Clipboard Toggle word wrap
   • <system_mysql_pod_id> : system-mysql Pod의 식별자입니다.

   • 사용자는 항상 root여야 합니다. 자세한 내용은 9.1절. “외부 MySQL 데이터베이스 제한 사항” 에서 참조하십시오.

     1. CLI에 mysql>이 표시됩니다. exit을 입력한 다음 return을 누릅니다. 다음 프롬프트에서 exit을 다시 입력하여 OpenShift 노드 콘솔로 돌아갑니다.

6. 다음 명령을 사용하여 전체 MySQL 덤프를 수행합니다.

   oc rsh system-mysql-<system_mysql_pod_id> /bin/bash -c "mysqldump -u root --single-transaction --routines --triggers --all-databases" > system-mysql-dump.sql

   Copy to Clipboard Toggle word wrap
   • <system_mysql_pod_id>를 고유한 system-mysql Pod ID 로 바꿉니다.

   • 다음 예제와 같이 system-mysql-dump.sql 파일에 유효한 MySQL 수준 덤프가 포함되어 있는지 확인합니다.

     $ head -n 10 system-mysql-dump.sql
     -- MySQL dump 10.13  Distrib 5.7.24, for Linux (x86_64)
     --
     -- Host: localhost    Database:
     -- ------------------------------------------------------
     -- Server version   5.7.24
     
     /*!40101 SET @OLD_CHARACTER_SET_CLIENT=@@CHARACTER_SET_CLIENT */;
     /*!40101 SET @OLD_CHARACTER_SET_RESULTS=@@CHARACTER_SET_RESULTS */;
     /*!40101 SET @OLD_COLLATION_CONNECTION=@@COLLATION_CONNECTION */;
     /*!40101 SET NAMES utf8 */;

     Copy to Clipboard Toggle word wrap

7. system-mysql pod를 축소하고 0(영) 복제본으로 둡니다.

   oc scale dc/system-mysql --replicas=0

   Copy to Clipboard Toggle word wrap

8. URL mysql2://root:<password>@<host>/system 과 동일한 base64 를 찾아 <password> 및 <host>를 적절하게 바꿉니다.

   echo "mysql2://root:<password>@<host>/system" | base64

   Copy to Clipboard Toggle word wrap

9. 원격 MySQL 데이터베이스에 기본 'user'@'%' 를 생성합니다. SELECT 권한만 있으면 됩니다. 또한 동등한 base64를 찾을 수 있습니다.

   echo "user" | base64
   echo "<password>" | base64

   Copy to Clipboard Toggle word wrap
   • <password>를 'user'@'%'의 암호로 바꿉니다.

10. 백업을 수행하고 OpenShift 시크릿 system-database를 편집합니다.

    oc get secret system-database -o yaml > system-database-orig.bkp.yml
    oc edit secret system-database

    Copy to Clipboard Toggle word wrap
    • URL: [Step-8]의 값으로 바꿉니다.
    • DB_USER 및 DB_PASSWORD: 두 가지 모두에 대해 이전 단계의 값을 사용합니다.

11. 아래 명령을 사용하여 system-mysql-dump.sql 을 원격 데이터베이스 서버에 전송하고 덤프를 서버로 가져옵니다.

    mysql -u root -p < system-mysql-dump.sql

    Copy to Clipboard Toggle word wrap

12. system 이라는 새 데이터베이스가 생성되었는지 확인합니다.

    mysql -u root -p -se "SHOW DATABASES"

    Copy to Clipboard Toggle word wrap

13. 모든 Pod를 올바른 순서로 확장하는 Start 3scale 온-프레미스 에 대한 다음 지침을 사용합니다.

    3scale 온-프레미스 시작

    • backend-redis,system-memcache,system-mysql,system-redis, zync-database.
    • backend-listener 및 backend-worker.
    • system-app.

    • system-sidekiq, backend-cron, system-sphinx

      • 3scale 2.3에는 system-resque가 포함되어 있습니다.
    • apicast-staging 및 apicast-production.

    • 3scale 2.6 이전 버전의 경우 apicast-wildcard-router 및 zync 3scale 2.6 이상 버전의 경우 zync-que 및 zync

      다음 예제에서는 backend-redis,system-memcache,system-mysql,system-redis, zync-database 에 대해 CLI에서 이 작업을 수행하는 방법을 보여줍니다.

      oc scale dc/backend-redis --replicas=1
      oc scale dc/system-memcache --replicas=1
      oc scale dc/system-mysql --replicas=1
      oc scale dc/system-redis --replicas=1
      oc scale dc/zync-database --replicas=1

      Copy to Clipboard Toggle word wrap

      이제 system-app pod가 문제 없이 가동 및 실행되어야 합니다.

14. 검증 후 표시된 순서대로 다른 포드를 확장합니다.
15. system-mysql DeploymentConfig 오브젝트를 백업합니다. 모든 것이 제대로 실행되고 있는지 확인한 후 며칠 후에 삭제할 수 있습니다. system-mysql DeploymentConfig를 삭제하면 향후 이 절차가 다시 수행되는 경우 향후 혼동이 발생하지 않습니다.

1. system-database-orig.bkp.yml의 원래 값을 사용하여 시크릿 system-database를 편집합니다. [단계-10] 을 참조하십시오.

   oc edit secret system-database

   Copy to Clipboard Toggle word wrap

   URL, DB_USER, DB_PASSWORD를 원래 값으로 바꿉니다.

2. 모든 pod를 축소한 다음 system-mysql을 포함하여 다시 확장합니다. system-app pod 및 기타 pod를 시작한 후 다시 실행해야 합니다. 다음 명령을 실행하여 모든 Pod가 백업되어 실행 중인지 확인합니다.

   oc get pods -n <3scale-project>

   Copy to Clipboard Toggle word wrap