2.20. 서비스 메시 연결

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. 다음 명령을 실행하여 red-mesh-system 이 시스템 네임스페이스이고 red-mesh 가 ServiceMeshControlPlane 오브젝트의 이름입니다.

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

5. 다음 명령을 입력합니다. 여기서 red-mesh-system 은 시스템 네임스페이스로 서비스 메시 컨트롤 플레인 설치 상태를 확인합니다.

   $ 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. 결합할 두 메시에 대한 다음 예제를 기반으로 ServiceMeshPeer 파일을 만듭니다.

   red-mesh to green-mesh의 ServiceMeshPeer 리소스 예

   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 ServiceMeshPeer 의 상태를 검사합니다.

   $ 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 를 확인하는 경우 녹색 메시 관점에서 동일한 두 연결에 대한 정보를 찾을 수 있습니다.

   두 메시 간의 연결이 설정되지 않은 경우 ServiceMeshPeer 상태는 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 를 생성합니다.

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. green-mesh 가 이전에 red-mesh 에서 내보낸 서비스를 가져오는 다음 예제를 기반으로 ImportedServiceSet 파일을 만듭니다.

   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 리소스를 생성합니다.

프로세스

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 예제와 같이 red-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 를 region,zone 또는 subzone으로 설정합니다.
   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를 사용할 수 없는 경우 us-east 리전의 green-mesh에서 us-west 의 빨간색-mesh로 트래픽을 라우팅해야 하는 다음 예제를 기반으로 DestinationRule 파일을 만듭니다.

   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