환경 정보

환경은 API 프록시를 실행하기 위한 격리된 컨텍스트 또는 '샌드박스'를 제공합니다. 단일 조직에서 여러 개의 환경을 만들 수 있습니다. 자세한 내용은 환경 및 환경 그룹 정보를 참조하세요.

다음 코드는 여러 환경이 정의된 재정의 구성의 예시를 보여줍니다. prod 및 test 환경의 호스트 별칭은 서로 다릅니다.

namespace: my-namespace
org: my-organization
...
envs:
  - name: test
    serviceAccountPaths:
      synchronizer: "your_keypath/synchronizer-manager-service-account.json
      udca: "your_keypath/analytic-agent-service-account.json

  - name: prod
    serviceAccountPaths:
      synchronizer: "your_keypath/synchronizer-manager-service-account.json
      udca: "your_keypath/analytic-agent-service-account.json
...

routingRules를 환경에 매핑하는 virtualhosts 속성을 추가합니다.

virtualhosts:
  - name: default
    hostAliases: ["api.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: test

virtualhosts:
  - name: external
    hostAliases: ["apiprod.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: prod

기본 경로가 /foo1인 프록시가 환경 test에 배포되었다고 가정해 보겠습니다. 다음과 같이 프록시를 호출할 수 있습니다.

curl -k https://api.example.com/foo1

이 호출이 인그레스에 도달하면 인그레스는 요청을 처리하는 test 환경과 연결된 메시지 프로세서로 이를 전송합니다.

마찬가지로 foo1도 prod 환경에 배포된 경우 호스트 별칭 apiprod.mydomain.net에 다음과 같은 프록시 요청을 보낼 수 있습니다.

curl -k https://apiprod.example.com/foo1

그러면 인그레스가 이 호스트와 연결된 MP로 라우팅됩니다.

참고: API 프록시로의 요청에서 인그레스는 수신되는 요청의 Host 헤더를 호스트 별칭 목록과 비교하여 어느 가상 호스트로 요청을 처리할지 결정합니다. curl 명령어, 브라우저, 다른 여러 유틸리티는 자동으로 Host 헤더를 요청의 도메인으로 설정합니다. 어떠한 이유로든 앱이 Host 헤더를 자동으로 설정하지 않는 경우 수동으로 설정해야 합니다.

Antipattern: 모든 프록시를 하나의 하이브리드 환경에 배포합니다.

권장사항: 여러 환경을 만들고 각 환경에 제한된 수의 프록시를 배포하세요. 특정 API 프록시 기본 경로를 라우팅할 환경을 지정하는 라우팅 규칙을 만들 수 있습니다. 자세한 내용은 가상 호스트 구성을 참조하세요.

프록시 배포 수 제한

하이브리드의 경우 많은 환경이 동일한 가상 호스트를 공유할 수 있기 때문에 특정 환경에 대한 프록시 배포를 관리하는 방법을 신중하게 생각해야 합니다. 하이브리드에서 권장사항은 여러 환경을 만들고 각 환경에 제한된 수의 프록시를 배포하는 것입니다.

환경에 몇 개의 프록시를 배포해야 하나요? 이 질문에 대한 답변 집합은 없습니다. 그러나 다음 표에서 각 환경에 배포된 프록시의 수를 제한하는 것이 좋은 이유와 프록시 배포를 관리할 때 고려해야 할 사항에 대한 일반적인 안내를 제공합니다.

고려할 문제	설명
메시지 프로세서 부팅 시간	메시지 프로세서(MP)의 부팅에 소요되는 시간과 해당 MP에 배포된 프록시 수 사이에는 직접적인 상관관계가 있습니다. 자동 확장 Kubernetes 환경에서 부팅 시간이 늘어나는 것은 문제가 될 수 있습니다. MP에 배포되는 프록시가 많을수록 확장이나 다시 만들기가 필요한 경우에는 MP가 준비될 때까지 더 오랜 시간이 걸립니다.
확장 성능	환경에 배포된 프록시가 여러 개 있고 프록시 중 하나가 트래픽이 많아 빈번하게 자동 확장되는 경우, 해당 환경의 모든 프록시가 이 프록시와 함께 확장됩니다. 트래픽이 많은 단일 프록시가 포함된 복수의 프록시 확장이 성능에 미치는 영향은 문제가 될 수 있습니다.
트래픽 많은 이웃	동일한 환경에 여러 프록시가 배포되어 있고 하나의 프록시가 비정상 종료되면 MP가 다시 시작되는 동안 환경의 모든 프록시가 다운됩니다. 환경에 배포된 프록시 수를 제한하여 단일 프록시 비정상 종료의 영향을 최소화할 수 있습니다.

환경 구성 참조

환경 구성 요소의 전체 목록은 구성 속성 참조에서 envs를 참조하세요.

환경 다루기

구성에 대한 상세 내용은 다음 주제를 참조하세요.