4장. Red Hat OpenShift에서 APIcast 실행
이 튜토리얼에서는 Red Hat OpenShift에 APIcast API 게이트웨이를 배포하는 방법을 설명합니다.
사전 요구 사항
- Red Hat 3scale API Management 관리 포털에서 3장. APIcast 설치 APIcast를 구성해야 합니다.
- 통합 설정에서 자체 관리 게이트웨이가 배포 옵션으로 선택되어 있는지 확인합니다.
- 계속 진행하도록 스테이징 및 프로덕션 환경이 모두 구성되어 있어야 합니다.
Red Hat OpenShift에서 APIcast를 실행하려면 다음 섹션에 설명된 단계를 수행하십시오.
4.1. Red Hat OpenShift 설정
실행 중인 OpenShift 클러스터가 이미 있는 경우 이 섹션을 생략할 수 있습니다. 그렇지 않은 경우 계속 읽으십시오.
프로덕션 배포의 경우 OpenShift 설치에 대한 지침을 따를 수 있습니다.
이 튜토리얼에서는 다음을 사용하여 OpenShift 클러스터를 설치합니다.
- Red Hat Enterprise Linux (RHEL) 7
- Docker 컨테이너 환경 v1.10.3
- OpenShift Origin CLI(명령줄 인터페이스) - v1.3.1
Red Hat OpenShift를 설정하려면 다음 섹션을 사용하십시오.
4.1.1. Docker 컨테이너 환경 설치
Red Hat에서 제공하는 Docker 형식의 컨테이너 이미지는 RHEL에서 Extras 채널의 일부로 릴리스됩니다. 추가 리포지토리를 활성화하려면 서브스크립션 관리자 또는 yum config 관리자를 사용할 수 있습니다. 자세한 내용은 RHEL 제품 설명서 를 참조하십시오.
AWS EC2 인스턴스에 배포된 RHEL 7의 경우 다음 지침을 사용합니다.
절차
모든 리포지토리를 나열합니다.
sudo yum repolist all
*-extras
리포지토리를 찾아 활성화합니다.sudo yum-config-manager --enable rhui-REGION-rhel-server-extras
Docker 형식의 컨테이너 이미지를 설치합니다.
sudo yum install docker docker-registry
/etc/sysconfig/docker
파일에 다음 행을 추가하거나 제거하여172.30.0.0/16
의 비보안 레지스트리를 추가합니다.INSECURE_REGISTRY='--insecure-registry 172.30.0.0/16'
Docker 서비스를 시작합니다.
sudo systemctl start docker
다음 명령을 사용하여 컨테이너 서비스가 실행 중인지 확인합니다.
sudo systemctl status docker
4.1.2. OpenShift 클러스터 시작
OpenShift 클러스터를 시작하려면 다음을 수행합니다.
절차
OpenShift 릴리스 페이지에서 클라이언트 툴의 안정적인 최신 릴리스 (
openshift-origin-client-tools-VERSION-linux-64bit.tar.gz
)를 다운로드하여PATH
에 있는 아카이브에서 추출된 Linuxoc
바이너리를 배치합니다.참고docker 명령은
root
사용자로 실행되므로 root 권한으로oc
또는 docker 명령을 실행해야 합니다.docker 명령을 실행하고 다음을 실행할 수 있는 권한이 있는 사용자로 터미널을 엽니다.
oc cluster up
출력 하단에서 배포된 클러스터에 대한 정보를 확인할 수 있습니다.
-- Server Information ... OpenShift server started. The server is accessible via web console at: https://172.30.0.112:8443 You are logged in as: User: developer Password: developer To login as administrator: oc login -u system:admin
-
OpenShift 서버에 할당된 IP 주소를 확인합니다. 이 튜토리얼에서
OPENSHIFT-SERVER-IP
를 참조합니다.
4.1.3. 원격 서버에서 OpenShift 클러스터 설정(선택 사항)
원격 서버에 OpenShift 클러스터를 배포하는 경우 클러스터 시작 시 공용 호스트 이름과 라우팅 접미사를 명시적으로 지정해야 OpenShift 웹 콘솔에 원격으로 액세스할 수 있습니다.
예를 들어 AWS EC2 인스턴스에 배포하는 경우 다음 옵션을 지정해야 합니다.
oc cluster up --public-hostname=ec2-54-321-67-89.compute-1.amazonaws.com --routing-suffix=54.321.67.89.xip.io
여기서 ec2-54-321-67-89.amazonaws.com
은 공용 도메인이며 54.321.67.89
는 인스턴스의 IP입니다. 그러면 https://ec2-54-321-67-89.compute-1.amazonaws.com:8443 에서 OpenShift 웹 콘솔에 액세스할 수 있습니다.