2.5. Service Mesh 설치

절차

1. cluster-admin 역할의 사용자로 OpenShift Container Platform 웹 콘솔에 로그인합니다.

2. istio-system이라는 프로젝트를 생성합니다.

   1. 홈 프로젝트로 이동합니다.
   2. 프로젝트 만들기를 클릭합니다.
   3. 이름 필드에 istio-system을 입력합니다.
   4. 생성을 클릭합니다.
3. Operators 설치된 Operator로 이동합니다.
4. 필요한 경우 프로젝트 메뉴에서 istio-system을 선택합니다. Operator가 새 프로젝트에 복사될 때까지 몇 분 정도 기다려야 할 수 있습니다.

5. Red Hat OpenShift Service Mesh Operator를 클릭합니다. 제공된 API에서 Operator는 두 가지 리소스 유형을 생성할 수 있는 링크를 제공합니다.

   • ServiceMeshControlPlane 리소스
   • ServiceMeshMemberRoll 리소스
6. Istio Service Mesh Control Plane에서 ServiceMeshControlPlane 만들기를 클릭합니다.

7. Service Mesh Control Plane 페이지에서 필요에 따라 기본 ServiceMeshControlPlane 템플릿에 대한 YAML을 수정합니다.

   참고

   컨트롤 플레인 사용자 지정에 대한 자세한 내용은 Red Hat OpenShift Service Mesh 설치 사용자 지정을 참조하십시오. 프로덕션의 경우 기본 Jaeger 템플릿을 변경해야 합니다.

8. 생성을 클릭하여 컨트롤 플레인을 생성합니다. Operator는 구성 매개변수를 기반으로 pods, 서비스 및 Service Mesh Control Plane 구성 요소를 생성합니다.
9. Istio Service Mesh Control Plane 탭을 클릭합니다.
10. 새 컨트롤 플레인의 이름을 클릭합니다.
11. 리소스 탭을 클릭하여 Operator가 생성 및 구성된 Red Hat OpenShift Service Mesh Control Plane 리소스를 확인합니다.

프로세스

1. cluster-admin 역할의 사용자로 OpenShift Container Platform CLI에 로그인합니다.

   $ oc login --username=<NAMEOFUSER> https://<HOSTNAME>:6443

2. istio-system이라는 프로젝트를 생성합니다.

   $ oc new-project istio-system

3. “Red Hat OpenShift Service Mesh 설치 사용자 지정”에서 확인된 예제를 사용하여 istio-installation.yaml이라는 ServiceMeshControlPlane 파일을 생성합니다. 필요에 따라, 사용 사례와 일치하도록 사용자 지정할 수 있습니다. 프로덕션 배포의 경우 기본 Jaeger 템플릿을 변경해야 합니다.

4. 다음 명령을 실행하여 컨트롤 플레인을 배포합니다.

   $ oc create -n istio-system -f istio-installation.yaml

5. 다음 명령을 실행하여 컨트롤 플레인 설치 상태를 확인합니다.

   $ oc get smcp -n istio-system

   STATUS 열이 ComponentsReady 이면 설치가 성공적으로 완료되었습니다.

   NAME            READY   STATUS            PROFILES      VERSION   AGE
   basic-install   11/11   ComponentsReady   ["default"]   v1.1.18   4m25s

6. 다음 명령을 실행하여 설치 프로세스 중에 Pod의 진행 상황을 확인합니다.

   $ oc get pods -n istio-system -w

   출력은 다음과 유사합니다.

   출력 예

   NAME                                     READY   STATUS             RESTARTS   AGE
   grafana-7bf5764d9d-2b2f6                 2/2     Running            0          28h
   istio-citadel-576b9c5bbd-z84z4           1/1     Running            0          28h
   istio-egressgateway-5476bc4656-r4zdv     1/1     Running            0          28h
   istio-galley-7d57b47bb7-lqdxv            1/1     Running            0          28h
   istio-ingressgateway-dbb8f7f46-ct6n5     1/1     Running            0          28h
   istio-pilot-546bf69578-ccg5x             2/2     Running            0          28h
   istio-policy-77fd498655-7pvjw            2/2     Running            0          28h
   istio-sidecar-injector-df45bd899-ctxdt   1/1     Running            0          28h
   istio-telemetry-66f697d6d5-cj28l         2/2     Running            0          28h
   jaeger-896945cbc-7lqrr                   2/2     Running            0          11h
   kiali-78d9c5b87c-snjzh                   1/1     Running            0          22h
   prometheus-6dff867c97-gr2n5              2/2     Running            0          28h

프로세스

1. OpenShift Container Platform 웹 콘솔에 로그인합니다.

2. 메시에 대한 서비스가 아직 없거나 처음부터 시작하려는 경우 애플리케이션에 대한 프로젝트를 생성합니다. Service Mesh Control Plane을 설치한 프로젝트와 달라야 합니다.

   1. 홈 프로젝트로 이동합니다.
   2. 이름 필드에 이름을 입력합니다.
   3. 생성을 클릭합니다.
3. Operators 설치된 Operator로 이동합니다.
4. 프로젝트 메뉴를 클릭하고 목록에서 ServiceMeshControlPlane 리소스가 배포되는 프로젝트를 선택합니다(예: istio-system).
5. Red Hat OpenShift Service Mesh Operator를 클릭합니다.
6. Istio Service Mesh 멤버 목록 탭을 클릭합니다.
7. ServiceMeshMemberRoll 만들기를 클릭합니다.
8. Members를 클릭한 다음 Value 필드에 프로젝트 이름을 입력합니다. 여러 프로젝트를 추가할 수 있지만 프로젝트는 하나의 ServiceMeshMemberRoll 리소스에만 속할 수 있습니다.
9. 생성을 클릭합니다.

프로세스

1. OpenShift Container Platform CLI에 로그인합니다.

   $ oc login --username=<NAMEOFUSER> https://<HOSTNAME>:6443

2. 메시에 대한 서비스가 아직 없거나 처음부터 시작하려는 경우 애플리케이션에 대한 프로젝트를 생성합니다. Service Mesh Control Plane을 설치한 프로젝트와 달라야 합니다.

   $ oc new-project <your-project>

3. 프로젝트를 멤버로 추가하려면 다음 예제 YAML을 수정합니다. 여러 프로젝트를 추가할 수 있지만 프로젝트는 하나의 ServiceMeshMemberRoll 리소스에만 속할 수 있습니다. 이 예제에서 istio-system 은 Service Mesh Control Plane 프로젝트의 이름입니다.

   servicemeshmemberroll-default.yaml 예

   apiVersion: maistra.io/v1
   kind: ServiceMeshMemberRoll
   metadata:
     name: default
     namespace: istio-system
   spec:
     members:
       # a list of projects joined into the service mesh
       - your-project-name
       - another-project-name

4. 다음 명령을 실행하여 istio-system 네임스페이스에 ServiceMeshMemberRoll 리소스를 업로드하고 만듭니다.

   $ oc create -n istio-system -f servicemeshmemberroll-default.yaml

5. 다음 명령을 실행하여 ServiceMeshMemberRoll이 성공적으로 생성되었는지 확인합니다.

   $ oc get smmr -n istio-system default

   STATUS 열이 Configured인 경우 설치가 성공적으로 완료된 것입니다.

프로세스

1. OpenShift Container Platform 웹 콘솔에 로그인합니다.
2. Operators 설치된 Operator로 이동합니다.
3. 프로젝트 메뉴를 클릭하고 목록에서 ServiceMeshControlPlane 리소스가 배포되는 프로젝트를 선택합니다(예: istio-system).
4. Red Hat OpenShift Service Mesh Operator를 클릭합니다.
5. Istio Service Mesh 멤버 목록 탭을 클릭합니다.
6. default 링크를 클릭합니다.
7. YAML 탭을 클릭합니다.
8. YAML을 수정하여 프로젝트를 멤버로 추가하거나 제거합니다. 여러 프로젝트를 추가할 수 있지만 프로젝트는 하나의 ServiceMeshMemberRoll 리소스에만 속할 수 있습니다.
9. 저장을 클릭합니다.
10. 새로 고침을 클릭합니다.

프로세스

1. OpenShift Container Platform CLI에 로그인합니다.

2. ServiceMeshMemberRoll 리소스를 편집합니다.

   $ oc edit smmr -n <controlplane-namespace>

3. YAML을 수정하여 프로젝트를 멤버로 추가하거나 제거합니다. 여러 프로젝트를 추가할 수 있지만 프로젝트는 하나의 ServiceMeshMemberRoll 리소스에만 속할 수 있습니다.

   servicemeshmemberroll-default.yaml 예

   apiVersion: maistra.io/v1
   kind: ServiceMeshMemberRoll
   metadata:
     name: default
     namespace: istio-system #control plane project
   spec:
     members:
       # a list of projects joined into the service mesh
       - your-project-name
       - another-project-name