5장. 클러스터 전체 프록시 구성


직접 인터넷 액세스가 거부될 때 OpenShift Container Platform 클러스터가 HTTP 또는 HTTPS 프록시를 사용하도록 설정하려면 기존 클러스터의 프록시 오브젝트를 수정하거나 새 클러스터의 install-config.yaml 파일에서 프록시 설정을 구성하여 클러스터 전체 프록시 설정을 구성할 수 있습니다.

지원되는 플랫폼에서 클러스터에 대한 클러스터 전체 송신 프록시를 활성화하면 RHCOS(Red Hat Enterprise Linux CoreOS)는 지원되는 플랫폼에 존재하는 install-config.yaml 파일의 networking.machineNetwork[].cidr,networking.clusterNetwork[].cidr, networking.serviceNetwork[] 필드의 값으로 status.noProxy 매개변수를 채웁니다.

참고

설치 후 작업에서는 networking.clusterNetwork[].cidr 값을 변경할 수 있지만 networking.machineNetwork[].cidr 및 networking.serviceNetwork[] 값은 변경할 수 없습니다. 자세한 내용은 "클러스터 네트워크 범위 구성"을 참조하십시오.

AWS(Amazon Web Services), Google Cloud, Microsoft Azure 및 RHOSP(Red Hat OpenStack Platform)에 설치하는 경우 status.noProxy 매개변수도 인스턴스 메타데이터 끝점 169.254.169.254 로 채워집니다.

RHCOS에서 프록시 오브젝트의 status: segment에 추가된 값의 예

apiVersion: config.openshift.io/v1
kind: Proxy
metadata:
  name: cluster
# ...
networking:
  clusterNetwork:
  - cidr: <ip_address_from_cidr>
    hostPrefix: 23
  network type: OVNKubernetes
  machineNetwork:
  - cidr: <ip_address_from_cidr>
  serviceNetwork:
  - 172.30.0.0/16
# ...
status:
  noProxy:
  - localhost
  - .cluster.local
  - .svc
  - 127.0.0.1
  - <api_server_internal_url>
# ...

다음과 같습니다.

<ip_address_from_cidr>
Pod IP 주소가 할당되는 IP 주소 블록을 지정합니다. 기본값은 10.128.0.0/14이며, 호스트 접두사는 /23입니다.
<ip_address_from_cidr>
머신의 IP 주소 블록을 지정합니다. 기본값은 10.0.0.0/16입니다.
<ip_address_from_cidr>
서비스의 IP 주소 블록을 지정합니다. 기본값은 172.30.0.0/16입니다.
<api_server_internal_url>
oc get infrastructure.config.openshift.io cluster -o jsonpath='{.status.etcdDiscoveryDomain}' 명령을 실행하여 내부 API 서버의 URL을 찾을 수 있습니다.
중요

노드 IP 주소가 지정된 networking.machineNetwork[].cidr 범위를 벗어나는 경우 noProxy 필드에 IP 주소를 추가해야 합니다. 이 구성을 사용하면 노드 간 트래픽이 프록시를 바이패스할 수 있습니다.

5.1. 사전 요구 사항

클러스터에서 액세스해야 하는 사이트를 검토하고 프록시를 바이패스해야 하는지 확인합니다. 클러스터를 호스팅하는 클라우드의 클라우드 공급자 API에 대한 호출을 포함하여 기본적으로 모든 클러스터 시스템 송신 트래픽이 프록시됩니다. 시스템 전체 프록시는 사용자 워크로드가 아닌 시스템 구성 요소에만 영향을 미칩니다. 필요한 경우 프록시를 바이패스하려면 프록시 오브젝트의 spec.no Proxy 매개변수에 사이트를 추가합니다.

5.2. 클러스터 전체 프록시 사용

OpenShift Container Platform 클러스터에 대해 클러스터 전체 송신 프록시를 활성화하려면 프록시 오브젝트를 수정하여 HTTP 및 HTTPS 프록시 설정을 구성하고 프록시를 바이패스하는 도메인을 지정할 수 있습니다.

프록시를 구성하지 않고 클러스터를 설치하거나 업그레이드하면 프록시 오브젝트 가 계속 생성되지만 사양 은 nil입니다. 예를 들면 다음과 같습니다.

apiVersion: config.openshift.io/v1
kind: Proxy
metadata:
  name: cluster
spec:
  trustedCA:
    name: ""
status:
참고

cluster라는 Proxy 오브젝트만 지원되며 추가 프록시는 생성할 수 없습니다.

클러스터 관리자는 cluster Proxy 오브젝트를 수정하여 OpenShift Container Platform의 프록시를 구성할 수 있습니다.

주의

클러스터에 대한 클러스터 전체 프록시 기능을 활성화하고 프록시 오브젝트 파일을 저장하면 MCO(Machine Config Operator)가 클러스터 외부에 존재하는 연결에 액세스할 수 있도록 클러스터의 모든 노드를 재부팅합니다. 이러한 노드를 수동으로 재부팅할 필요가 없습니다.

사전 요구 사항

  • 클러스터 관리자 권한이 있어야 합니다.
  • OpenShift Container Platform oc CLI 툴이 설치되어 있어야 합니다.

프로세스

  1. HTTPS 연결을 프록시하는 데 필요한 추가 CA 인증서가 포함된 구성 맵을 생성합니다.

    참고

    프록시의 ID 인증서가 RHCOS(Red Hat Enterprise Linux CoreOS) 신뢰 번들의 기관에서 서명한 경우 이 단계를 건너뛸 수 있습니다.

    1. user-ca-bundle.yaml 이라는 파일을 생성하고 PEM 인코딩 인증서 값을 제공합니다.

      apiVersion: v1
      data:
        ca-bundle.crt: | 
      1
      
          <MY_PEM_ENCODED_CERTS> 
      2
      
      kind: ConfigMap
      metadata:
        name: user-ca-bundle 
      3
      
        namespace: openshift-config 
      4

      다음과 같습니다.

      data.ca-bundle.crt
      ca-bundle.crt 라는 이름의 데이터 키를 지정합니다.
      <MY_PEM_ENCODED_CERTS>
      프록시의 ID 인증서에 서명하는 데 사용되는 PEM 인코딩 X.509 인증서를 하나 이상 지정합니다.
      user-ca-bundle
      프록시 오브젝트에서 참조하는 구성 맵 이름을 지정합니다.
      openshift-config
      구성 맵이 있어야 하는 네임스페이스를 지정합니다.
    2. 다음 명령을 입력하여 user-ca-bundle.yaml 파일에서 구성 맵을 생성합니다.

      $ oc create -f user-ca-bundle.yaml
  2. oc edit 명령을 사용하여 프록시 오브젝트를 수정합니다.

    $ oc edit proxy/cluster
  3. 프록시에 필요한 필드를 구성합니다.

    apiVersion: config.openshift.io/v1
    kind: Proxy
    metadata:
      name: cluster
    spec:
      httpProxy: http://<username>:<pswd>@<ip>:<port> 
    1
    
      httpsProxy: https://<username>:<pswd>@<ip>:<port> 
    2
    
      noProxy: example.com 
    3
    
      readinessEndpoints:
      - http://www.google.com 
    4
    
      - https://www.google.com
      trustedCA:
        name: user-ca-bundle 
    5

    다음과 같습니다.

    httpProxy
    클러스터 외부에서 HTTP 연결을 생성하는 데 사용할 프록시 URL을 지정합니다. URL 스키마는 http여야 합니다.
    httpsProxy
    클러스터 외부에서 HTTPS 연결을 생성하는 데 사용할 프록시 URL을 지정합니다. URL 스키마는 http 또는 https 여야 합니다. URL 스키마를 지원하는 프록시의 URL을 지정합니다. 예를 들어 대부분의 프록시는 https 를 사용하도록 구성된 경우 오류를 보고하지만 http 만 지원합니다. 이 실패 메시지는 로그에 전파되지 않을 수 있으며 대신 네트워크 연결 실패로 표시될 수 있습니다. 클러스터에서 https 연결을 수신하는 프록시를 사용하는 경우 프록시에서 사용하는 CA 및 인증서를 수락하도록 클러스터를 구성해야 할 수 있습니다.
    noProxy

    대상 도메인 이름, 도메인, IP 주소(또는 기타 네트워크 CIDR)의 쉼표로 구분된 목록과 프록시를 제외할 포트 번호를 지정합니다. 포트 번호는 IPv6 주소를 구성할 때만 지원됩니다. IPv4 주소를 구성할 때 포트 번호는 지원되지 않습니다.

    하위 도메인과 일치하려면 도메인 앞에 .을 입력합니다. 예를 들어, .y.com은 x.y.com과 일치하지만 y.com은 일치하지 않습니다. *를 사용하여 모든 대상에 대해 프록시를 바이패스합니다.

    noproxy 필드에 도메인 주소를 포함해야 하는 경우 noproxy 필드에 해당 FQDN 또는 접두사 일치 하위 도메인을 명시적으로 지정해야 합니다. 도메인을 캡슐화하는 IP 주소 또는 CIDR 범위는 사용할 수 없습니다. 이는 클러스터가 DNS가 경로 연결을 할당하기 전에 IP 주소를 반환하고 생성되는 요청에 대해 명시적으로 확인하기 위해 기다리지 않기 때문입니다. 예를 들어 noproxy 필드에 대해 10.0.0.0/24 와 같은 CIDR 블록 값이 있고 필드가 https://10.0.0.11 에 액세스하려고 하면 주소가 성공적으로 일치합니다. 그러나 A 레코드 항목이 10.0.0.11 인 https://exampleserver.externaldomain.com 에 액세스하려고 하면 실패합니다. noproxy 필드의 경우 .externaldomain.com 의 추가 값이 필요합니다.

    networking.machineNetwork[].cidr 필드에 의해 정의된 네트워크에 포함되지 않은 컴퓨팅 노드를 설치 구성에서 확장하려면 연결 문제가 발생하지 않도록 이 목록에 추가해야 합니다.

    httpProxy와 httpsProxy 필드가 모두 설정되지 않은 경우 이 필드는 무시됩니다.

    readinessEndpoints
    httpProxy 및 httpsProxy 값을 상태에 쓰기 전에 준비 검사를 수행하는 데 사용할 클러스터 외부의 URL을 하나 이상 지정합니다.
    trustedCA
    HTTPS 연결을 프록시하는 데 필요한 추가 CA 인증서가 포함된 openshift-config 네임스페이스의 구성 맵에 대한 참조를 지정합니다. 여기에서 구성 맵을 참조하기 전에 구성 맵이 이미 있어야 합니다. 프록시의 ID 인증서를 RHCOS 트러스트 번들에 있는 기관에서 서명하지 않은 경우 이 필드가 있어야 합니다.
  4. 파일을 저장하여 변경 사항을 적용합니다.

5.3. 클러스터 전체 프록시 제거

cluster 프록시 오브젝트는 삭제할 수 없습니다. OpenShift Container Platform 클러스터에서 클러스터 전체 프록시 구성을 제거하려면 oc edit 명령을 사용하여 프록시 오브젝트에서 모든 spec 필드를 제거할 수 있습니다.

사전 요구 사항

  • 클러스터 관리자 권한
  • OpenShift Container Platform oc CLI 도구 설치

프로세스

  1. 프록시를 수정하려면 oc edit 명령을 사용합니다.

    $ oc edit proxy/cluster
  2. 프록시 오브젝트에서 모든 spec 필드를 제거합니다. 예를 들면 다음과 같습니다.

    apiVersion: config.openshift.io/v1
    kind: Proxy
    metadata:
      name: cluster
    spec: {}
  3. 파일을 저장하여 변경 사항을 적용합니다.

5.4. 클러스터 전체 프록시 구성 확인

OpenShift Container Platform에서 클러스터 전체 프록시 구성이 올바르게 작동하는지 확인하려면 프록시 오브젝트 상태를 확인하고 Machine Config Operator 로그를 검토하고 시스템 구성 요소가 프록시를 통해 외부 요청을 라우팅하고 있는지 확인할 수 있습니다.

사전 요구 사항

  • 클러스터 관리자 권한이 있어야 합니다.
  • OpenShift Container Platform oc CLI 툴이 설치되어 있어야 합니다.

프로세스

  1. oc 명령을 사용하여 프록시 구성 상태를 확인합니다.

    $ oc get proxy/cluster -o yaml
  2. 출력의 프록시 필드를 확인하여 구성과 일치하는지 확인합니다. 특히 spec.httpProxy,spec.httpsProxy,spec.noProxy, spec.trustedCA 필드를 확인합니다.
  3. 프록시 오브젝트의 상태를 검사합니다.

    $ oc get proxy/cluster -o jsonpath='{.status}'

    출력 예

    {
    status:
        httpProxy: http://user:xxx@xxxx:3128
        httpsProxy: http://user:xxx@xxxx:3128
        noProxy: .cluster.local,.svc,10.0.0.0/16,10.128.0.0/14,127.0.0.1,169.254.169.254,172.30.0.0/16,localhost,test.no-proxy.com
    }

  4. MCO(Machine Config Operator)의 로그를 확인하여 구성 변경 사항이 성공적으로 적용되었는지 확인합니다.

    $ oc logs -n openshift-machine-config-operator $(oc get pods -n openshift-machine-config-operator -l k8s-app=machine-config-operator -o name)
  5. 프록시 설정이 적용되고 필요한 경우 노드가 재부팅되었음을 나타내는 메시지를 찾습니다.
  6. CVO(Cluster Version Operator)와 같은 외부 요청을 수행하는 구성 요소의 로그를 확인하여 시스템 구성 요소가 프록시를 사용하고 있는지 확인합니다.

    $ oc logs -n openshift-cluster-version $(oc get pods -n openshift-cluster-version -l k8s-app=machine-config-operator -o name)
  7. 외부 요청이 프록시를 통해 라우팅되었음을 보여주는 로그 항목을 찾습니다.
Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동