28.4. Ingress 컨트롤러 끝점 게시 전략 구성

프로세스

1. Ingress 컨트롤러에 대한 CR(사용자 정의 리소스) 파일을 생성합니다.

   IngressController 오브젝트에 대한 정보를 정의하는 CR 파일의 예

   apiVersion: v1
   items:
   - apiVersion: operator.openshift.io/v1
     kind: IngressController
     metadata:
       name: <custom_ic_name> 1
       namespace: openshift-ingress-operator
     spec:
       replicas: 1
       domain: <custom_ic_domain_name> 2
       nodePlacement:
         nodeSelector:
           matchLabels:
             <key>: <value> 3
       namespaceSelector:
        matchLabels:
          <key>: <value> 4
       endpointPublishingStrategy:
         type: NodePortService
   # ...

   1

   IngressController CR의 사용자 정의 이름을 지정합니다.

   2

   Ingress 컨트롤러 서비스의 DNS 이름입니다. 예를 들어 기본 ingresscontroller 도메인은 apps.ipi-cluster.example.com 이므로 < custom_ic_domain_name >을 nodeportsvc.ipi-cluster.example.com 으로 지정합니다.

   3

   사용자 정의 Ingress 컨트롤러를 포함하는 노드의 라벨을 지정합니다.

   4

   네임스페이스 집합의 라벨을 지정합니다. < key>:<value >를 <key>가 새 레이블의 고유 이름이며 < value >가 값인 키 -값 쌍의 맵으로 바꿉니다. 예: ingresscontroller: custom-ic.

2. oc label node 명령을 사용하여 노드에 라벨을 추가합니다.

   $ oc label node <node_name> <key>=<value> 1

   1

   여기서 <value >는 IngressController CR의 nodePlacement 섹션에 지정된 키-값 쌍과 일치해야 합니다.

3. IngressController 오브젝트를 생성합니다.

   $ oc create -f <ingress_controller_cr>.yaml

4. IngressController CR에 대해 생성된 서비스의 포트를 찾습니다.

   $ oc get svc -n openshift-ingress

   router-nodeport-custom-ic3 서비스의 포트 80:32432/TCP 를 표시하는 출력 예

   NAME                        TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)                                     AGE
   router-internal-default      ClusterIP   172.30.195.74    <none>        80/TCP,443/TCP,1936/TCP                     223d
   router-nodeport-custom-ic3   NodePort    172.30.109.219   <none>        80:32432/TCP,443:31366/TCP,1936:30499/TCP   155m

5. 새 프로젝트를 생성하려면 다음 명령을 입력합니다.

   $ oc new-project <project_name>

6. 새 네임스페이스에 레이블을 지정하려면 다음 명령을 입력합니다.

   $ oc label namespace <project_name> <key>=<value> 1

   1

   여기서 & lt;key>=& lt;value>는 Ingress 컨트롤러 CR의 namespaceSelector 섹션에 있는 값과 일치해야 합니다.

7. 클러스터에 새 애플리케이션을 생성합니다.

   $ oc new-app --image=<image_name> 1

   1

   < image_name >의 예는 quay.io/openshifttest/hello-openshift:multiarch 입니다.

8. Pod에서 서비스를 사용하여 클러스터 외부에 애플리케이션을 노출할 수 있도록 서비스의 Route 오브젝트를 생성합니다.

   $ oc expose svc/<service_name> --hostname=<svc_name>-<project_name>.<custom_ic_domain_name> 1

   참고

   --hostname 인수에서 사용자 정의 Ingress 컨트롤러의 도메인 이름을 지정해야 합니다. 이 작업을 수행하지 않으면 Ingress Operator는 기본 Ingress 컨트롤러를 사용하여 클러스터의 모든 경로를 제공합니다.

9. 경로에 Admitted 상태가 있고 사용자 정의 Ingress 컨트롤러에 대한 메타데이터가 포함되어 있는지 확인합니다.

   $ oc get route/hello-openshift -o json | jq '.status.ingress'

   출력 예

   # ...
   {
     "conditions": [
       {
         "lastTransitionTime": "2024-05-17T18:25:41Z",
         "status": "True",
         "type": "Admitted"
       }
     ],
     [
       {
         "host": "hello-openshift.nodeportsvc.ipi-cluster.example.com",
         "routerCanonicalHostname": "router-nodeportsvc.nodeportsvc.ipi-cluster.example.com",
         "routerName": "nodeportsvc", "wildcardPolicy": "None"
       }
     ],
   }

10. 기본 Ingress 컨트롤러에서 NodePort-type 서비스를 관리하지 못하도록 기본 IngressController CR을 업데이트합니다. 기본 Ingress 컨트롤러는 다른 모든 클러스터 트래픽을 계속 모니터링합니다.

    $ oc patch --type=merge -n openshift-ingress-operator ingresscontroller/default --patch '{"spec":{"namespaceSelector":{"matchExpressions":[{"key":"<key>","operator":"NotIn","values":["<value>]}]}}}'

검증

1. 다음 명령을 입력하여 DNS 항목이 클러스터 내부 및 외부에서 라우팅될 수 있는지 확인합니다. 이 명령은 절차의 앞부분에서 oc label node 명령을 실행하여 레이블을 수신한 노드의 IP 주소를 출력합니다.

   $ dig +short <svc_name>-<project_name>.<custom_ic_domain_name>

2. 클러스터가 DNS 확인을 위해 외부 DNS 서버의 IP 주소를 사용하는지 확인하려면 다음 명령을 입력하여 클러스터 연결을 확인합니다.

   $ curl <svc_name>-<project_name>.<custom_ic_domain_name>:<port> 1

   1 1

   여기서 <port >는 NodePort-type 서비스 의 노드 포트입니다. oc get svc -n openshift-ingress 명령의 예제 출력에 따라 80:32432/TCP HTTP 경로는 32432 가 노드 포트임을 의미합니다.

   출력 예

   Hello OpenShift!