NGINX Ingress Controller Documentation

NGINX Ingress Operator로 설치

이 문서에서는 NGINX Ingress Operator 를 사용하여 Kubernetes 클러스터에 NGINX Ingress Controller를 설치하는 방법을 설명합니다.

목차

1. 필수 구성 요소
2. NGINX Ingress Controller Manifest 생성
3. NGINX Ingress Controller 생성

1. 필수 구성 요소

  1. Ingress Controller 이미지에 대한 액세스 권한이 있는지 확인합니다.
    • NGINX Ingress Controller의 경우 DockerHubnginx/nginx-ingress 이미지를 사용합니다.
    • NGINX Plus Ingress Controller의 경우 Docker Registry에서 이미지를 가져오는 방법에 대한 자세한 내용은 여기를 참조하십시오.
    • 컨테이너 Registry에서 가져오려면 여기의 지침에 따라 JWT 토큰을 사용하여 Docker Registry Secret을 구성하십시오.
    • 여기의 지침에 따라 고유한 이미지를 Build하고 개인 Private Docker Registry에 Push할 수도 있습니다.
  2. 지침에 따라 NGINX Ingress Operator를 설치합니다.
  3. 지침에 기본 서버 Secret 및 SecurityContextConstraints를 만듭니다.

2. NGINX Ingress Controller Manifest 생성

다음 내용으로 manifest nginx-ingress-controller.yaml을 만듭니다.

apiVersion: charts.nginx.org/v1alpha1
kind: NginxIngress
metadata:
  name: nginxingress-sample
  namespace: nginx-ingress
spec:
  controller:
    defaultTLS:
      secret: nginx-ingress/default-server-secret
    image:
      pullPolicy: IfNotPresent
      repository: nginx/nginx-ingress
      tag: 2.4.1-ubi
    ingressClass: nginx
    kind: deployment
    nginxplus: false
    replicaCount: 1
    serviceAccount:
      imagePullSecretName: ""

Note: NGINX Plus의 경우 image.repositoryimage.tag 값을 변경하고 nginxPlusTrue로 변경합니다. 필요한 경우 serviceAccount.imagePullSecretName을 ServiceAccount와 연결되어야 하는 미리 생성된 Docker Config Secret의 이름으로 설정합니다.

3. NginxIngressController 생성

$ kubectl apply -f nginx-ingress-controller.yaml

NGINX Ingress Controller의 새 인스턴스는 NGINX Ingress 운영자가 기본 매개변수를 사용하여 default Namespace에 배포합니다.

NGINX Ingress Controller 리소스의 다른 매개변수를 구성하려면 설명서를 확인하세요.