1.9. 서비스 메시에 서비스 추가

프로세스

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

프로세스

1. OpenShift Container Platform 웹 콘솔에 cluster-admin 권한이 있는 사용자로 로그인합니다. Red Hat OpenShift Dedicated를 사용하는 경우 dedicated-admin 역할의 계정이 있어야 합니다.
2. 홈 프로젝트를 클릭합니다.
3. 프로젝트 만들기를 클릭합니다.

4. Project Name 으로 info 를 입력하고 Display Name 을 입력하고 Description 을 입력한 다음 Create 를 클릭합니다.

   • 또는 CLI에서 이 명령을 실행하여 info 프로젝트를 생성할 수도 있습니다.

     $ oc new-project info

5. Operators 설치된 Operator를 클릭합니다.
6. 프로젝트 메뉴를 클릭하고 Service Mesh Control Plane 네임스페이스를 사용합니다. 이 예제에서는 istio-system을 사용합니다.
7. Red Hat OpenShift Service Mesh Operator를 클릭합니다.

8. Istio Service Mesh 멤버 목록 탭을 클릭합니다.

   1. 이미 Istio Service Mesh 멤버 롤을 생성한 경우, 이름을 클릭한 다음 YAML 탭을 클릭하여 YAML 편집기를 엽니다.
   2. ServiceMeshMemberRoll을 생성하지 않은 경우 ServiceMeshMemberRoll 생성을 클릭합니다.
9. Members를 클릭한 다음 Value 필드에 프로젝트 이름을 입력합니다.

10. 생성을 클릭하여 업데이트된 서비스 메시 멤버 롤을 저장합니다.

    1. 또는 다음 예제를 YAML 파일에 저장합니다.

       Bookinfo ServiceMeshMemberRoll example servicemeshmemberroll-default.yaml

       apiVersion: maistra.io/v1
       kind: ServiceMeshMemberRoll
       metadata:
         name: default
       spec:
         members:
         - info

    2. 다음 명령을 실행하여 해당 파일을 업로드하고 istio-system 네임스페이스에 ServiceMeshMemberRoll 리소스를 만듭니다. 이 예제에서 istio-system 은 Service Mesh Control Plane 프로젝트의 이름입니다.

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

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

    $ oc get smmr -n istio-system -o wide

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

    NAME      READY   STATUS       AGE   MEMBERS
    default   1/1     Configured   70s   ["info"]

12. CLI에서 bookinfo.yaml 파일을 적용하여 'info' 프로젝트에 Bookinfo 애플리케이션을 배포합니다.

    $ oc apply -n info -f https://raw.githubusercontent.com/Maistra/istio/maistra-2.3/samples/bookinfo/platform/kube/bookinfo.yaml

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

    service/details created
    serviceaccount/info-details created
    deployment.apps/details-v1 created
    service/ratings created
    serviceaccount/info-ratings created
    deployment.apps/ratings-v1 created
    service/reviews created
    serviceaccount/info-reviews created
    deployment.apps/reviews-v1 created
    deployment.apps/reviews-v2 created
    deployment.apps/reviews-v3 created
    service/productpage created
    serviceaccount/info-productpage created
    deployment.apps/productpage-v1 created

13. info-gateway.yaml 파일을 적용하여 수신 게이트웨이를 생성합니다.

    $ oc apply -n info -f https://raw.githubusercontent.com/Maistra/istio/maistra-2.3/samples/bookinfo/networking/bookinfo-gateway.yaml

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

    gateway.networking.istio.io/info-gateway created
    virtualservice.networking.istio.io/info created

14. GATEWAY_URL 매개변수 값을 설정합니다.

    $ export GATEWAY_URL=$(oc -n istio-system get route istio-ingressgateway -o jsonpath='{.spec.host}')

프로세스

1. 대상 규칙을 추가하려면 다음 명령 중 하나를 실행합니다.

   • 상호 TLS를 활성화하지 않은 경우:

     $ oc apply -n info -f https://raw.githubusercontent.com/Maistra/istio/maistra-2.3/samples/bookinfo/networking/destination-rule-all.yaml

   • 상호 TLS를 활성화한 경우:

     $ oc apply -n info -f https://raw.githubusercontent.com/Maistra/istio/maistra-2.3/samples/bookinfo/networking/destination-rule-all-mtls.yaml

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

     destinationrule.networking.istio.io/productpage created
     destinationrule.networking.istio.io/reviews created
     destinationrule.networking.istio.io/ratings created
     destinationrule.networking.istio.io/details created

CLI의 프로시저

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

2. 다음 명령으로 모든 pod가 준비되었는지 확인합니다.

   $ oc get pods -n info

   모든 pod의 상태는 Running이어야 합니다. 출력은 다음과 유사합니다.

   NAME                              READY   STATUS    RESTARTS   AGE
   details-v1-55b869668-jh7hb        2/2     Running   0          12m
   productpage-v1-6fc77ff794-nsl8r   2/2     Running   0          12m
   ratings-v1-7d7d8d8b56-55scn       2/2     Running   0          12m
   reviews-v1-868597db96-bdxgq       2/2     Running   0          12m
   reviews-v2-5b64f47978-cvssp       2/2     Running   0          12m
   reviews-v3-6dfd49b55b-vcwpf       2/2     Running   0          12m

3. 다음 명령을 실행하여 제품 페이지의 URL을 검색합니다.

   echo "http://$GATEWAY_URL/productpage"

4. 웹 브라우저에 출력을 복사하여 붙여넣어 Bookinfo 제품 페이지가 배포되었는지 확인합니다.

Kiali 웹 콘솔의 절차

1. Kiali 웹 콘솔의 주소를 가져옵니다.

   1. OpenShift Container Platform 웹 콘솔에 cluster-admin 권한이 있는 사용자로 로그인합니다. Red Hat OpenShift Dedicated를 사용하는 경우 dedicated-admin 역할의 계정이 있어야 합니다.
   2. 네트워킹 경로로 이동합니다.

   3. 경로 페이지의 네임스페이스 메뉴에서 Service Mesh Control Plane 프로젝트(예: istio-system )를 선택합니다.

      Location (위치) 열에는 각 경로의 연결된 주소가 표시됩니다.

   4. Kiali의 위치 열에서 링크를 클릭합니다.
   5. OpenShift로 로그인을 클릭합니다. Kiali 개요 화면에 각 프로젝트 네임스페이스에 대한 타일이 표시됩니다.
2. Kiali에서 그래프 를 클릭합니다.
3. 네임스페이스 목록에서 info를 선택하고 그래프 유형 목록에서 앱 그래프 를 선택합니다.

4. 디스플레이 메뉴에서 유휴 노드 표시를 클릭합니다.

   이렇게 하면 정의되었지만 요청 수신 또는 전송되지 않은 노드가 표시됩니다. 애플리케이션이 올바르게 정의되었지만 요청 트래픽이 보고되지 않았는지 확인할 수 있습니다.

   
   • Duration 메뉴를 사용하여 오래된 트래픽이 캡처되도록 기간을 늘립니다.
   • Refresh Rate 메뉴를 사용하여 트래픽을 더 자주 새로 고치거나 전혀 새로 고침하지 않습니다.
5. 서비스,워크로드 또는 Istio Config 를 클릭하여 정보 구성 요소의 목록 보기를 확인하고 정상인지 확인합니다.