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

프로세스

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 리소스에만 속할 수 있습니다.

   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

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

4. 파일을 저장하고 편집기를 종료합니다.

프로세스

1. OpenShift Container Platform 웹 콘솔에 로그인합니다.
2. Operators 설치된 Operator로 이동합니다.
3. 프로젝트 메뉴를 클릭하고 드롭다운 목록에서 메시에 추가할 프로젝트를 선택합니다. 예를 들면 istio-system입니다.
4. Red Hat OpenShift Service Mesh Operator를 클릭합니다.
5. Istio Service Mesh 멤버 탭을 클릭합니다.
6. ServiceMeshMember 생성을클릭합니다.
7. ServiceMeshMember 의 기본 이름을 수락합니다.
8. ControlPlaneRef 를 확장하려면 클릭합니다.
9. 네임스페이스 필드에서 ServiceMeshControlPlane 리소스가 속한 프로젝트를 선택합니다. 예를 들면 istio-system입니다.
10. 이름 필드에 이 네임스페이스가 속한 ServiceMeshControlPlane 리소스의 이름을 입력합니다. 예를 들어 basic.
11. 생성을 클릭합니다.

검증

1. 다음 단계를 사용하여 ServiceMeshMember 리소스가 생성되고 프로젝트가 메시에 추가되었는지 확인합니다.

   1. 리소스 이름을 클릭합니다(예: default ).
   2. 화면 끝에 표시된 Conditions 섹션을 확인합니다.

   3. Reconciled 및 Ready 조건의 Status가 True 인지 확인합니다.

      Status 가 False 인 경우 자세한 내용은 Reason 및 Message 열을 참조하십시오.

프로세스

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

2. ServiceMeshMember 매니페스트에 대한 YAML 파일을 생성합니다. 매니페스트는 istio-system 네임스페이스에 배포된 ServiceMeshControlPlane 리소스에서 생성한 서비스 메시에 my-application 프로젝트를 추가합니다.

   apiVersion: maistra.io/v1
   kind: ServiceMeshMember
   metadata:
     name: default
     namespace: my-application
   spec:
     controlPlaneRef:
       namespace: istio-system
       name: basic

3. YAML 파일을 적용하여 ServiceMeshMember 리소스를 생성합니다.

   $ oc apply -f <file-name>

프로세스

1. Operators 설치된 Operator로 이동합니다.
2. 프로젝트 메뉴를 클릭하고 드롭다운 목록에서 ServiceMeshMemberRoll 리소스가 배포된 프로젝트를 선택합니다. 예: istio-system.
3. Red Hat OpenShift Service Mesh Operator를 클릭합니다.
4. Istio Service Mesh 멤버 목록 탭을 클릭합니다.
5. ServiceMeshMember Roll 을 클릭합니다.
6. ServiceMeshMemberRoll 의 기본 이름을 수락합니다.

7. 라벨 필드에 키-값 쌍을 입력하여 서비스 메시에 포함할 네임스페이스를 식별하는 레이블을 정의합니다. 프로젝트 네임스페이스에 선택기에 의해 지정된 라벨이 있는 경우 프로젝트 네임스페이스가 서비스 메시에 포함됩니다. 두 레이블을 모두 포함할 필요는 없습니다.

   예를 들어 mykey=myvalue 를 입력하면 메시의 일부로 이 라벨이 있는 모든 네임스페이스가 포함됩니다. 선택기가 일치하는 항목을 식별하면 프로젝트 네임스페이스가 서비스 메시에 추가됩니다.

   myotherkey=myothervalue 를 입력하면 메시의 일부로 이 라벨이 있는 모든 네임스페이스가 포함됩니다. 선택기가 일치하는 항목을 식별하면 프로젝트 네임스페이스가 서비스 메시에 추가됩니다.

8. 생성을 클릭합니다.

프로세스

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

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

   $ oc edit smmr default -n istio-system

   서비스가 포함된 프로젝트와 분리된 모든 프로젝트에 Service Mesh Control Plane을 배포할 수 있습니다.

3. ServiceMeshMemberRoll 리소스의 spec.memberSelectors 필드에 네임스페이스 레이블 선택기를 포함하도록 YAML 파일을 수정합니다.

   참고

   matchLabels 필드를 사용하는 대신 선택기에서 matchExpressions 필드를 사용할 수도 있습니다.

   apiVersion: maistra.io/v1
   kind: ServiceMeshMemberRoll
   metadata:
     name: default
     namespace: istio-system
   spec:
     memberSelectors: 1
     - matchLabels: 2
         mykey: myvalue 3
     - matchLabels: 4
         myotherkey: myothervalue 5

   1

   서비스 메시에 포함된 프로젝트 네임스페이스를 식별하는 데 사용되는 라벨 선택기가 포함되어 있습니다. 프로젝트 네임스페이스에 선택기에 의해 지정된 라벨이 있는 경우 프로젝트 네임스페이스가 서비스 메시에 포함됩니다. 프로젝트 네임스페이스는 두 레이블을 모두 포함할 필요가 없습니다.

   2 3

   mykey=myvalue 레이블이 있는 모든 네임스페이스를 지정합니다. 선택기가 일치하는 항목을 식별하면 프로젝트 네임스페이스가 서비스 메시에 추가됩니다.

   4 5

   myotherkey=myothervalue 레이블이 있는 모든 네임스페이스를 지정합니다. 선택기가 일치하는 항목을 식별하면 프로젝트 네임스페이스가 서비스 메시에 추가됩니다.

프로세스

1. 홈 프로젝트를 클릭합니다.
2. 프로젝트 만들기를 클릭합니다.

3. 프로젝트 이름으로 info 를 입력하고 디스플레이 이름 을 입력하고 설명을 입력한 다음 생성 을 클릭합니다.

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

     $ oc new-project info

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

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

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

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

   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

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

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

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

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

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

    $ oc apply -n info -f https://raw.githubusercontent.com/Maistra/istio/maistra-2.5/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

12. info-gateway.yaml 파일을 적용하여 수신 게이트웨이를 만듭니다.

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

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

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

13. 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.5/samples/bookinfo/networking/destination-rule-all.yaml

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

     $ oc apply -n info -f https://raw.githubusercontent.com/Maistra/istio/maistra-2.5/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. 다음 명령으로 모든 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

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

   echo "http://$GATEWAY_URL/productpage"

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

Kiali 웹 콘솔의 절차

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

   1. OpenShift Container Platform 웹 콘솔에 로그인합니다.
   2. 네트워킹 경로로 이동합니다.

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

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

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

4. 표시 메뉴에서 유휴 노드 표시를 클릭합니다.

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

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