1.18. 서비스 메시 연결

1. cluster-admin 역할의 사용자로 OpenShift Container Platform 웹 콘솔에 로그인합니다.
2. Operators 설치된 Operator로 이동합니다.
3. 프로젝트 메뉴를 클릭하고 Service Mesh Control Plane을 설치한 프로젝트를 선택합니다. 예를 들면 red-mesh-system 입니다.
4. Red Hat OpenShift Service Mesh Operator를 클릭합니다.
5. Istio Service Mesh Control Plane 탭에서 ServiceMeshControlPlane 의 이름을 클릭합니다(예: red-mesh ).
6. ServiceMeshControlPlane 세부 정보 만들기 페이지에서 YAML을 클릭하여 구성을 수정합니다.
7. ServiceMeshControlPlane 을 수정하여 페더레이션 인그레스 및 송신 게이트웨이를 추가하고 신뢰 도메인을 지정합니다.
8. 저장을 클릭합니다.

1. cluster-admin 역할의 사용자로 OpenShift Container Platform CLI에 로그인합니다. 다음 명령을 입력합니다. 메시지가 표시되면 사용자 이름과 암호를 입력합니다.

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

2. Service Mesh Control Plane을 설치한 프로젝트로 변경합니다(예: red-mesh-system).

   $ oc project red-mesh-system

3. ServiceMeshControlPlane 파일을 편집하여 페더레이션 인그레스 및 송신 게이트웨이를 추가하고 신뢰 도메인을 지정합니다.

4. 다음 명령을 실행하여 Service Mesh Control Plane을 편집합니다. 여기서 red-mesh-system 은 시스템 네임스페이스이고 red-mesh 는 ServiceMeshControlPlane 오브젝트의 이름입니다.

   $ oc edit -n red-mesh-system smcp red-mesh

5. 다음 명령을 입력합니다. 여기서 red-mesh-system 은 시스템 네임스페이스이며, Service Mesh Control Plane 설치 상태를 확인합니다.

   $ oc get smcp -n red-mesh-system

   READY 열에 모든 구성 요소가 준비되었음을 나타내는 설치가 성공적으로 완료되었습니다.

   NAME       READY   STATUS            PROFILES      VERSION   AGE
   red-mesh   10/10   ComponentsReady   ["default"]   2.1.0     4m25s

1. cluster-admin 역할의 사용자로 OpenShift Container Platform CLI에 로그인합니다. 다음 명령을 입력합니다. 메시지가 표시되면 사용자 이름과 암호를 입력합니다.

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

2. 컨트롤 플레인을 설치한 프로젝트(예: red-mesh-system )로 변경합니다.

   $ oc project red-mesh-system

3. 통합하려는 두 메시에 대해 다음 예제를 기반으로 ServiceMesh Period 파일을 만듭니다.

   red-mesh에 대한 ServiceMeshPeer 리소스 예 - green-mesh

   kind: ServiceMeshPeer
   apiVersion: federation.maistra.io/v1
   metadata:
     name: green-mesh
     namespace: red-mesh-system
   spec:
     remote:
       addresses:
       - ingress-red-mesh.green-mesh-system.apps.domain.com
     gateways:
       ingress:
         name: ingress-green-mesh
       egress:
         name: egress-green-mesh
     security:
       trustDomain: green-mesh.local
       clientID: green-mesh.local/ns/green-mesh-system/sa/egress-red-mesh-service-account
       certificateChain:
         kind: ConfigMap
         name: green-mesh-ca-root-cert

4. 다음 명령을 실행하여 리소스를 배포합니다. 여기서 red-mesh-system 은 시스템 네임스페이스이고 servicemeshpeer.yaml 에는 편집한 파일에 대한 전체 경로가 포함됩니다.

   $ oc create -n red-mesh-system -f servicemeshpeer.yaml

5. 빨간색 메시와 녹색 메시 간 연결이 설정되었는지 확인하려면 red-mesh-system 네임스페이스에서 green-mesh ServiceMesh peer의 상태를 검사합니다.

   $ oc -n red-mesh-system get servicemeshpeer green-mesh -o yaml

   red-mesh와 green-mesh 간의 ServiceMeshpeer 연결 예

   status:
     discoveryStatus:
       active:
       - pod: istiod-red-mesh-b65457658-9wq5j
         remotes:
         - connected: true
           lastConnected: "2021-10-05T13:02:25Z"
           lastFullSync: "2021-10-05T13:02:25Z"
           source: 10.128.2.149
         watch:
           connected: true
           lastConnected: "2021-10-05T13:02:55Z"
           lastDisconnectStatus: 503 Service Unavailable
           lastFullSync: "2021-10-05T13:05:43Z"

   status.discoveryStatus.active.remotes 필드에는 피어 메시의 istiod(이 예에서는 녹색 메시)가 현재 메시(이 예에서는 빨간색 메시)에서 istiod에 연결되어 있음을 보여줍니다.

   status.discoveryStatus.active.watch 필드에는 현재 메시의 istiod가 피어 메시의 istiod에 연결되어 있는 것으로 표시됩니다.

   green-mesh-system 에서 red-mesh 피어라는 servicemeshpeer 를 선택하면 녹색 메시의 관점에서 동일한 두 연결에 대한 정보를 확인할 수 있습니다.

   두 메시 간 연결이 설정되지 않으면 ServiceMeshPeriod 상태는 status.discoveryStatus.inactive 필드에 이를 나타냅니다.

   연결 시도가 실패한 이유에 대한 자세한 내용은 Istiod 로그, 피어에 대한 송신 트래픽을 처리하는 송신 게이트웨이의 액세스 로그 및 피어 메시의 현재 메시에 대한 수신 트래픽을 처리하는 수신 게이트웨이를 검사합니다.

   예를 들어 빨간색 메시가 녹색 메시에 연결할 수 없는 경우 다음 로그를 확인합니다.

   • red-mesh-system의 Istiod-red-mesh
   • red-mesh-system의 egress-Green-mesh
   • green-mesh-system의 ingress-red-mesh

1. cluster-admin 역할의 사용자로 OpenShift Container Platform CLI에 로그인합니다. 다음 명령을 입력합니다. 메시지가 표시되면 사용자 이름과 암호를 입력합니다.

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

2. Service Mesh Control Plane을 설치한 프로젝트(예: red-mesh-system )로 변경합니다.

   $ oc project red-mesh-system

3. red-mesh 가 서비스를 green-mesh 로 내보내는 다음 예제를 기반으로 ExportedServiceSet 파일을 만듭니다.

   red-mesh에서 green-mesh로 ExportedServiceSet 리소스의 예

   apiVersion: federation.maistra.io/v1
   kind: ExportedServiceSet
   metadata:
     name: green-mesh
     namespace: red-mesh-system
   spec:
     exportRules:
     - type: NameSelector
       nameSelector:
         namespace: red-mesh-info
         name: ratings
         alias:
           namespace: info
           name: red-ratings
     - type: NameSelector
       nameSelector:
         namespace: red-mesh-info
         name: reviews

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

   $ oc create -n <ControlPlaneNamespace> -f <ExportedServiceSet.yaml>

   예를 들어 다음과 같습니다.

   $ oc create -n red-mesh-system -f export-to-green-mesh.yaml

5. 페더레이션 메시의 각 메시 피어에 필요한 추가 ExportedServiceSets 를 만듭니다.

6. red-mesh 에서 내보낸 서비스를 검증하여 green-mesh 와 공유하려면 다음 명령을 실행합니다.

   $ oc get exportedserviceset <PeerMeshExportedTo> -o yaml

   예를 들어 다음과 같습니다.

   $ oc get exportedserviceset green-mesh -o yaml

7. 다음 명령을 실행하여 green-mesh와 공유할 red-mesh 내보내기를 서비스의 유효성을 검사합니다.

   $ oc get exportedserviceset <PeerMeshExportedTo> -o yaml

   예를 들어 다음과 같습니다.

   $ oc -n red-mesh-system get exportedserviceset green-mesh -o yaml

   녹색 메시와 공유되는 빨간색 메시에서 내보낸 서비스의 유효성을 검사하는 예입니다.

     status:
       exportedServices:
       - exportedName: red-ratings.info.svc.green-mesh-exports.local
         localService:
           hostname: ratings.red-mesh-info.svc.cluster.local
           name: ratings
           namespace: red-mesh-info
       - exportedName: reviews.red-mesh-info.svc.green-mesh-exports.local
         localService:
           hostname: reviews.red-mesh-info.svc.cluster.local
           name: reviews
           namespace: red-mesh-info

   status.exportedServices 어레이는 현재 내보낸 서비스를 나열합니다(해당 서비스는 ExportedServiceSet 오브젝트의 내보내기 규칙과 일치함). 배열의 각 항목은 내보낸 서비스의 이름과 내보낸 로컬 서비스에 대한 세부 정보를 나타냅니다.

   내보낼 것으로 예상되는 서비스가 누락된 경우 Service 오브젝트가 있는지, 해당 이름 또는 레이블이 ExportedServiceSet 오브젝트에 정의된 exportRules 와 일치하고 Service 오브젝트의 네임스페이스가 ServiceMeshMemberRoll 또는 ServiceMeshMember 오브젝트를 사용하여 서비스 메시의 멤버로 구성되어 있는지 확인합니다.

1. cluster-admin 역할의 사용자로 OpenShift Container Platform CLI에 로그인합니다. 다음 명령을 입력합니다. 메시지가 표시되면 사용자 이름과 암호를 입력합니다.

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

2. Service Mesh Control Plane을 설치한 프로젝트(예: green-mesh-system )로 변경합니다.

   $ oc project green-mesh-system

3. 다음 예제를 기반으로 ImportedServiceSet 파일을 만듭니다. 여기서 green-mesh 가 이전에 red-mesh 에서 내보낸 서비스를 가져옵니다.

   red-mesh에서 green-mesh로 ImportedServiceSet 리소스의 예

   kind: ImportedServiceSet
   apiVersion: federation.maistra.io/v1
   metadata:
     name: red-mesh
     namespace: green-mesh-system
   spec:
     importRules:
     - type: NameSelector
       importAsLocal: false
       nameSelector:
         namespace: info
         name: red-ratings
         alias:
           namespace: info
           name: ratings

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

   $ oc create -n <ControlPlaneNamespace> -f <ImportedServiceSet.yaml>

   예를 들어 다음과 같습니다.

   $ oc create -n green-mesh-system -f import-from-red-mesh.yaml

5. 페더레이션 메시의 각 메시 피어에 필요한 대로 추가로 ImportedServiceSet 리소스를 만듭니다.

6. green-mesh 에 가져온 서비스를 확인하려면 다음 명령을 실행합니다.

   $ oc get importedserviceset <PeerMeshImportedInto> -o yaml

   예를 들어 다음과 같습니다.

   $ oc get importedserviceset green-mesh -o yaml

7. 다음 명령을 실행하여 메시로 가져온 서비스의 유효성을 검사합니다.

   $ oc get importedserviceset <PeerMeshImportedInto> -o yaml

   예를 들어, 빨간색 메시에서 내보낸 서비스가 'green-mesh- system 네임스페이스에서 가져온serviceset/red-mesh' 오브젝트의 status 섹션을 사용하여 녹색 메시로 가져왔는지 확인합니다.

   $ oc -n green-mesh-system get importedserviceset/red-mesh -o yaml

   status:
     importedServices:
     - exportedName: red-ratings.info.svc.green-mesh-exports.local
       localService:
         hostname: ratings.info.svc.red-mesh-imports.local
         name: ratings
         namespace: info
     - exportedName: reviews.red-mesh-info.svc.green-mesh-exports.local
       localService:
         hostname: ""
         name: ""
         namespace: ""

   위 예제에서는 localService 아래에 있는 채워진 필드에 표시된 대로 ratings 서비스만 가져옵니다. reviews 서비스는 가져오기용으로 사용할 수 있지만 ImportedServiceSet 오브젝트의 importRules 와 일치하지 않기 때문에 현재 가져온 것은 아닙니다.

절차

1. cluster-admin 역할의 사용자로 OpenShift Container Platform CLI에 로그인하고 다음 명령을 입력합니다.

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

2. Service Mesh Control Plane을 설치한 프로젝트로 변경하고 다음 명령을 입력합니다.

   $ oc project <smcp-system>

   예를 들면 green-mesh-system 입니다.

   $ oc project green-mesh-system

3. ImportedServiceSet 파일을 편집합니다. 여기서 < ImportedServiceSet.yaml >에는 편집하려는 파일에 대한 전체 경로가 포함되어 있으며 다음 명령을 입력합니다.

   $ oc edit -n <smcp-system> -f <ImportedServiceSet.yaml>

   예를 들어 이전 ImportedServiceSet 예제에 표시된 대로 빨간색-mesh-system에서 green-mesh-system으로 가져오는 파일을 수정하려면 다음을 수행합니다.

   $ oc edit -n green-mesh-system -f import-from-red-mesh.yaml

4. 파일을 수정합니다.

   1. spec.importRules.importAsLocal 을 true 로 설정합니다.
   2. spec.locality 를 지역 , 영역 또는 하위 영역으로 설정합니다.
   3. 변경 사항을 저장하십시오.

절차

1. cluster-admin 역할의 사용자로 OpenShift Container Platform CLI에 로그인합니다. 다음 명령을 입력합니다. 메시지가 표시되면 사용자 이름과 암호를 입력합니다.

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

2. Service Mesh Control Plane을 설치한 프로젝트로 변경합니다.

   $ oc project <smcp-system>

   예를 들면 green-mesh-system 입니다.

   $ oc project green-mesh-system

3. green-mesh가 사용할 수 없는 다음 예제를 기반으로 DestinationRule 파일을 만듭니다. 이 파일은 us-east 리전의 green-mesh에서 us-west 으로 트래픽을 라우팅해야 합니다.

   DestinationRule예

   apiVersion: networking.istio.io/v1beta1
   kind: DestinationRule
   metadata:
     name: default-failover
     namespace: info
   spec:
     host: "ratings.info.svc.cluster.local"
     trafficPolicy:
       loadBalancer:
         localityLbSetting:
           enabled: true
           failover:
             - from: us-east
               to: us-west
       outlierDetection:
         consecutive5xxErrors: 3
         interval: 10s
         baseEjectionTime: 1m

4. DestinationRule 을 배포합니다. 여기서 < DestinationRule >에는 파일의 전체 경로가 포함되어 다음 명령을 입력합니다.

   $ oc create -n <application namespace> -f <DestinationRule.yaml>

   예를 들어 다음과 같습니다.

   $ oc create -n info -f green-mesh-us-west-DestinationRule.yaml