2장. 메시로 트래픽 가져오기

프로세스

1. 다음 명령을 실행하여 httpbin 이라는 네임스페이스를 생성합니다.

   $ oc create namespace httpbin

2. 네임스페이스에서 사이드카 삽입을 활성화합니다. InPlace 업그레이드 전략을 사용하는 경우 다음 명령을 실행합니다.

   $ oc label namespace httpbin istio-injection=enabled

   참고

   RevisionBased 업그레이드 전략을 사용하는 경우 다음 명령을 실행합니다.

   1. < revision-name> 을 찾으려면 다음 명령을 실행합니다.

      $ oc get istiorevisions.sailoperator.io

      샘플 출력:

      NAME      TYPE    READY   STATUS    IN USE   VERSION   AGE
      default   Local   True    Healthy   True    v1.24.3   3m33s

   2. 사이드카 삽입을 활성화하려면 버전 이름으로 네임스페이스에 레이블을 지정합니다.

      $ oc label namespace httpbin istio.io/rev=default

3. 다음 명령을 실행하여 httpbin 이라는 샘플 서비스를 배포합니다.

   $ oc apply -n httpbin -f https://raw.githubusercontent.com/openshift-service-mesh/istio/refs/heads/master/samples/httpbin/httpbin.yaml

4. Istio 게이트웨이 리소스를 정의하는 httpbin-gw.yaml 이라는 YAML 파일을 생성합니다. 이 리소스는 호스트 httpbin.example.com 의 포트 80(HTTP)을 노출하도록 게이트웨이 프록시를 구성합니다.

   apiVersion: networking.istio.io/v1
   kind: Gateway
   metadata:
     name: httpbin-gateway
     namespace: httpbin
   spec:
     selector:
       istio: <gateway_name> 

   1

   
     servers:
     - port:
         number: 80
         name: http
         protocol: HTTP
       hosts:
       - httpbin.example.com 

   2

   1

   선택기 를 게이트웨이 프록시 배포 의 Pod 템플릿에 지정된 고유한 레이블 또는 세트로 설정합니다. 기본적으로 Istio Gateway 리소스 구성은 모든 네임스페이스의 일치하는 게이트웨이 포드에 적용됩니다.

   2

   hosts 필드를 사용하여 연결된 포트에서 메시 서비스에 액세스하려고 할 때 클라이언트에서 사용할 수 있는 주소 목록을 지정합니다.

5. 다음 명령을 실행하여 YAML 파일을 적용합니다.

   $ oc apply -f httpbin-gw.yaml

6. VirtualService 에 대한 httpbin-vs.yaml 이라는 YAML 파일을 생성합니다. VirtualService 는 게이트웨이 프록시에서 httpbin 서비스로 트래픽을 라우팅하는 규칙을 정의합니다.

   apiVersion: networking.istio.io/v1
   kind: VirtualService
   metadata:
     name: httpbin
     namespace: httpbin
   spec:
     hosts:
     - httpbin.example.com 

   1

   
     gateways:
     - httpbin-gateway 

   2

   
     http:
     - match:
       - uri:
           prefix: /status
       - uri:
           prefix: /headers
       route:
       - destination: 

   3

   
           port:
             number: 8000
           host: httpbin

   1

   VirtualService 의 라우팅 규칙이 적용되는 호스트 를 지정합니다. 지정된 호스트 는 VirtualService가 바인딩된 Istio 게이트웨이 리소스에서 노출해야 합니다.

   2

   게이트웨이 목록에 게이트웨이 이름을 추가하여 이전 단계에서 생성한 Istio Gateway 리소스에 VirtualService 를 바인딩합니다.

   3

   httpbin 서비스의 호스트 및 포트 를 포함하는 대상 을 정의하여 이전에 배포된 httpbin 서비스에 일치하는 트래픽을 라우팅합니다.

7. 다음 명령을 실행하여 YAML 파일을 적용합니다.

   $ oc apply -f httpbin-vs.yaml

8. 확인을 위해 다음 명령을 실행하여 curl 클라이언트의 네임스페이스를 생성합니다.

   $ oc create namespace curl

9. 다음 명령을 실행하여 curl 클라이언트를 배포합니다.

   $ oc apply -n curl -f https://raw.githubusercontent.com/openshift-service-mesh/istio/refs/heads/master/samples/curl/curl.yaml

10. 다음 명령을 실행하여 CURL_POD 변수를 curl 포드의 이름으로 설정합니다.

    $ CURL_POD=$(oc get pods -n curl -l app=curl -o jsonpath='{.items[*].metadata.name}')

11. curl 클라이언트를 사용하여 수신 게이트웨이 서비스 리소스를 통해 httpbin 애플리케이션의 /headers 엔드포인트로 요청을 보냅니다. 요청의 Host 헤더를 httpbin.example.com 으로 설정하여 Istio Gateway 및 VirtualService 리소스가 지정하는 호스트와 일치시킵니다. 다음 curl 명령을 실행하여 요청을 보냅니다.

    $ oc exec $CURL_POD -n curl -- \
      curl -s -I \
        -H Host:httpbin.example.com \
        <gateway_name>.<gateway_namespace>.svc.cluster.local/headers

12. 응답에는 요청이 성공했음을 나타내는 200 OK HTTP 상태가 있어야 합니다.

    출력 예

    HTTP/1.1 200 OK
    server: istio-envoy
    ...

13. 다음 명령을 실행하여 httpbin VirtualService 에 정의된 해당 URI 접두사 일치가 없는 엔드포인트에 curl 요청을 보냅니다.

    $ oc exec $CURL_POD -n curl -- \
      curl -s -I \
        -H Host:httpbin.example.com \
        <gateway_name>.<gateway_namespace>.svc.cluster.local/get

    응답에서 404 Not Found 상태를 반환해야 합니다. 이는 /get 끝점에 httpbin VirtualService 리소스에 일치하는 URI 접두사가 없기 때문에 예상됩니다.

    출력 예

    HTTP/1.1 404 Not Found
    server: istio-envoy
    ...

14. 서비스 유형을 LoadBalancer 로 설정하여 클러스터 외부의 트래픽에 게이트웨이 프록시를 노출합니다.

    $ oc patch service <gateway_name> -n <gateway_namespace> -p '{"spec": {"type": "LoadBalancer"}}'

    참고

    게이트웨이는 OpenShift 경로를 사용하여 클러스터 외부의 트래픽에도 노출될 수 있습니다. 자세한 내용은 "OpenShift 경로를 사용하여 클러스터 외부의 트래픽에 게이트웨이 추가"를 참조하십시오.

15. 게이트웨이 서비스 리소스의 외부 호스트 이름 또는 IP 주소를 사용할 때 클러스터 외부에서 httpbin 서비스에 액세스할 수 있는지 확인합니다. 클러스터가 실행 중인 환경에 대해 INGRESS_HOST 변수를 적절하게 설정해야 합니다.

    1. 클러스터가 AWS에서 실행되는 경우 다음 명령을 실행하여 INGRESS_HOST 변수를 설정합니다.

       $ INGRESS_HOST=$(oc get service <gateway_name> -n <gateway_namespace> -o jsonpath='{.status.loadBalancer.ingress[0].hostname}')

    2. 클러스터가 GCP 또는 Azure에서 실행되는 경우 다음 명령을 실행하여 INGRESS_HOST 변수를 설정합니다.

       $ INGRESS_HOST=$(oc get service <gateway_name> -n <gateway_namespace> -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

    3. 다음 명령을 실행하여 게이트웨이 호스트를 사용하여 curl 요청을 httpbin 서비스로 보냅니다.

       $ curl -s -I -H Host:httpbin.example.com http://$INGRESS_HOST/headers

16. 응답에 HTTP/1.1 200 OK 상태가 있는지 확인합니다. 이 상태는 요청이 성공했음을 나타냅니다.