2.4. Ingress Controller 엔드포인트 게시 전략 구성

프로세스

1. Ingress Controller에 대한 사용자 정의 리소스(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
   # ...

   Copy to Clipboard Toggle word wrap

   1

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

   2

   Ingress Controller가 서비스하는 DNS 이름입니다. 예를 들어, 기본 ingresscontroller 도메인은 apps.ipi-cluster.example.com 이므로 <custom_ic_domain_name>을 nodeportsvc.ipi-cluster.example.com 으로 지정합니다.

   3

   사용자 정의 Ingress 컨트롤러를 포함하는 노드에 대한 레이블을 지정합니다.

   4

   네임스페이스 집합에 대한 레이블을 지정합니다. <키>:<값>을 키-값 쌍의 맵으로 대체합니다. 여기서 <키> 는 새 레이블의 고유한 이름이고 <값> 은 해당 값입니다. 예를 들어: ingresscontroller: custom-ic .

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

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

   1

   Copy to Clipboard Toggle word wrap

   1

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

3. IngressController 객체를 생성합니다.

   $ oc create -f <ingress_controller_cr>.yaml

   Copy to Clipboard Toggle word wrap

4. IngressController CR에 대해 생성된 서비스의 포트를 찾으세요.

   $ oc get svc -n openshift-ingress

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

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

   $ oc new-project <project_name>

   Copy to Clipboard Toggle word wrap

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

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

   1

   Copy to Clipboard Toggle word wrap

   1

   <키>=<값> 은 Ingress Controller CR의 namespaceSelector 섹션에 있는 값과 일치해야 합니다.

7. 클러스터에 새 애플리케이션을 만듭니다.

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

   1

   Copy to Clipboard Toggle word wrap

   1

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

8. 서비스에 대한 Route 객체를 생성하면 Pod가 서비스를 사용하여 클러스터 외부에 애플리케이션을 노출할 수 있습니다.

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

   1

   Copy to Clipboard Toggle word wrap
   참고

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

9. 경로가 승인됨 상태인지 확인하고 사용자 지정 Ingress 컨트롤러에 대한 메타데이터가 포함되어 있는지 확인하세요.

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

   Copy to Clipboard Toggle word wrap

   출력 예

   # ...
   {
     "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"
       }
     ],
   }

   Copy to Clipboard Toggle word wrap

10. 기본 IngressController CR을 업데이트하여 기본 Ingress Controller가 NodePort 유형 서비스를 관리하지 못하도록 합니다. 기본 Ingress Controller는 다른 모든 클러스터 트래픽을 계속 모니터링합니다.

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

    Copy to Clipboard Toggle word wrap

검증

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

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

   Copy to Clipboard Toggle word wrap

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

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

   1

   Copy to Clipboard Toggle word wrap

   1 1

   여기서 <port> 는 NodePort 유형 서비스 의 노드 포트입니다. oc get svc -n openshift-ingress 명령의 예시 출력을 기준으로 하면 80:32432/TCP HTTP 경로는 32432 가 노드 포트임을 의미합니다.

   출력 예

   Hello OpenShift!

   Copy to Clipboard Toggle word wrap