2.3. Kubernetes 게이트웨이 API를 사용하여 서비스 노출

프로세스

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

   $ oc create namespace httpbin

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   게이트웨이 리소스 파일 예

   apiVersion: gateway.networking.k8s.io/v1
   kind: Gateway
   metadata:
     name: httpbin-gateway
     namespace: httpbin
   spec:
     gatewayClassName: istio
     listeners:
     - name: default
       hostname: "httpbin.example.com" 

   1

   
       port: 80
       protocol: HTTP
       allowedRoutes:
         namespaces:
           from: All

   Copy to Clipboard Toggle word wrap

   1

   클라이언트가 연결된 포트에서 메시 서비스에 액세스하려고 할 때 사용하는 가상 호스트 이름을 지정합니다.

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

   $ oc apply -f httpbin-gw.yaml

   Copy to Clipboard Toggle word wrap

5. HTTPRoute 리소스를 정의하는 httpbin-hr.yaml 이라는 YAML 파일을 생성합니다. HTTPRoute 리소스는 게이트웨이 프록시에서 httpbin 서비스로 트래픽을 라우팅하는 규칙을 지정합니다.

   HTTPRoute 파일 예

   apiVersion: gateway.networking.k8s.io/v1
   kind: HTTPRoute
   metadata:
     name: httpbin
     namespace: httpbin
   spec:
     parentRefs: 

   1

   
     - name: httpbin-gateway
       namespace: httpbin
     rules:
     - matches:
       - path:
           type: PathPrefix
           value: /status
       - path:
           type: PathPrefix
           value: /headers
       backendRefs: 

   2

   
       - name: httpbin
         port: 8000

   Copy to Clipboard Toggle word wrap

   1

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

   2

   httpbin 서비스의 이름 및 포트를 포함하는 backendRefs 를 정의하여 일치하는 트래픽을 httpbin 서비스로 라우팅합니다.

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

   $ oc apply -f httpbin-hr.yaml

   Copy to Clipboard Toggle word wrap

7. 다음 명령을 실행하여 Gateway API 서비스가 준비되고 주소가 서비스에 할당되었는지 확인합니다.

   $ oc wait --for=condition=programmed gtw httpbin-gateway -n httpbin

   Copy to Clipboard Toggle word wrap

검증

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

   $ oc create namespace curl

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   응답에서 200 OK HTTP 상태를 반환해야 하며, 이는 요청이 성공했음을 나타냅니다.

   출력 예

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   응답에서 404 Not Found 상태를 반환합니다. 이는 /get 엔드포인트에 httpbin HTTPROUTE 리소스에 일치하는 URI 접두사가 없기 때문에 예상됩니다.

   출력 예

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap
   참고

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

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

   1. 다음 명령을 실행하여 INGRESS_HOST 변수를 설정합니다.

      $ export INGRESS_HOST=$(oc get gtw <gateway_name> -n <gateway_namespace> -o jsonpath='{.status.addresses[0].value}')

      Copy to Clipboard Toggle word wrap

   2. 다음 명령을 실행하여 INGRESS_PORT 변수를 설정합니다.

      $ INGRESS_PORT=$(oc get gtw <gateway_name> -n <gateway_namespace> -o jsonpath='{.spec.listeners[?(@.name=="http")].port}')

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap
8. 응답에 HTTP/1.1 200 OK 상태가 있는지 확인합니다. 이 상태는 요청이 성공했음을 나타냅니다.