Edge 구성 방법

Private Cloud용 Edge v. 4.16.05

설치 후 Edge를 구성하려면 .properties 파일과 Edge 유틸리티를 함께 사용합니다. 대상 예를 들어 Edge UI에서 TLS/SSL을 구성하려면 .properties 파일을 수정하여 필요한 속성 .properties 파일을 변경하려면 영향을 받는 Edge 구성요소를 확인할 수 있습니다

Apigee에서는 .properties 파일을 구성을 참조하세요. 기본적으로 config이 있는 코드는 .properties 파일. 코드에서 구성에서는 이 키를 토큰이라고 합니다. 따라서 Edge를 구성하려면 이 속성은 .properties 파일에 포함됩니다.

구성이 포함된 코드를 사용하면 Edge 구성요소가 제품을 배포하면 설치팀이 설치 토폴로지에 따라 해당 설정을 재정의할 수 있습니다. 고객이 선택한 속성을 재정의할 수 있습니다.

계층 구조로 생각하면 설정은 다음과 같이 고객에 맞춰 정렬됩니다. 우선순위가 가장 높은 설정을 선택하여 설치 기사팀의 설정보다 우선 적용되도록 할 수 있습니다. Apigee:

1. 고객
2. 설치 프로그램
3. Apigee

.properties 파일 사용 방법

고객은 .properties 파일만 수정할 수 있습니다. /<inst_root>/apigee/customer/application 를 참조하세요. 각 구성요소는 해당 디렉터리에 자체 .properties 파일을 갖습니다. 예: router.properties 및 management-server.properties가 포함됩니다.

</ph>
1. 편집기에서 원하는 사용자로 파일을 만듭니다.
2. 파일 소유자를 apigee:apigee로 변경하거나 사용자를 변경한 경우 Apigee 사용자의 Edge 서비스를 실행하고, 에지 서비스를 실행하고 있는지 확인합니다

구성요소의 속성을 설정하려면 해당하는 .properties 파일을 수정하여 토큰을 설정합니다. 구성요소를 다시 시작합니다.

> /<inst_root>/apigee/apigee-service/bin/apigee-service component restart

예를 들어 router.properties를 수정한 후 라우터를 다시 시작합니다.

> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart

Edge를 업그레이드하면 .properties 파일이 /&lt;inst_root&gt;/apigee/customer/application 읽을 수 있습니다 즉, 업그레이드 시 구성요소를 사용합니다.

.properties 파일의 위치

Edge용 .properties 파일의 최상위 디렉터리는 3개임 구성요소인 설치 소유자와 고객입니다. 기본 위치는 다음 위치에 나와 있습니다. 표:

경고: Edge 고객은 다음 위치에서 .properties 파일만 수정할 수 있습니다. /&lt;inst_root&gt;/apigee/customer. 구성요소 및 설치 디렉토리 아래의 파일을 볼 수는 있지만 할 수 있습니다.

토큰의 현재 값 확인

구성요소의 .properties 파일에 토큰을 설정하기 전에 먼저 다음 명령어를 사용하여 현재 값을 확인할 수 있습니다.

> /<inst_dir>/apigee/apigee-service/bin/apigee-service comp configure -search token

여기서 comp는 구성요소의 이름입니다. token은 검사할 토큰입니다.

이 명령어는 .properties 파일의 계층 구조를 검색하여 토큰의 현재 값입니다.

예를 들어 conf_router_HTTP.request.line.limit 토큰의 현재 값을 라우터:

> /<inst_dir>/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_router_HTTP.request.line.limit

다음과 같은 형식으로 출력이 표시됩니다.

Found key conf_router_HTTP.request.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties

.properties 파일에서 토큰 설정

토큰의 값을 재정의하는 방법은 다음과 같습니다.

1. 속성별 .properties 파일을 구성요소를 사용하여 토큰 값을 설정합니다. 파일이 없으면 새로 만듭니다.
2. 구성요소를 다시 시작합니다.
3. 토큰 값을 확인합니다.

예를 들어 Edge Router에 요청 줄 한도를 설정하려면 다음 안내를 따르세요.

1. /&lt;inst_root&gt;/apigee/customer/application/router.properties를 편집합니다. 파일을 사용하여 conf_router_HTTP.request.line.limit를 설정합니다. 토큰:
   <ph type="x-smartling-placeholder">
   </ph> conf_router_HTTP.request.line.limit=8k
2. 다음과 같이 Edge Router를 다시 시작합니다.
   
   &gt; /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router 재시작
3. 토큰의 값을 확인합니다.
   
   &gt; /<inst_dir>/apigee/apigee-service/bin/apigee-service Edge-router 구성 -검색 conf_router_HTTP.request.line.limit

여러 값을 사용하는 토큰 설정

일부 토큰은 쉼표로 구분된 값 목록을 사용합니다. 예: conf_security_rbac.restricted.resources 토큰 시스템 관리자만 호출할 수 있도록 제한된 URI 목록을 사용합니다. 이 conf_security_rbac.restricted.resources 값:

> cd /<inst_root>/apigee/edge-management-server
> grep -ri "conf_security_rbac.restricted.resources" *

출력에는 다음이 포함됩니다.

token/default.properties:conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status

값 목록을 가져오는 토큰을 설정하려면 새 값을 .properties 파일의 토큰)을 가져옵니다. 따라서 URI /myuri/*를 conf_security_rbac.restricted.resources에 추가하려면 /&lt;inst_root&gt;/apigee/customer/application/management-server.properties를 수정하세요. 파일을 수정합니다.

conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*

토큰 찾기

대부분의 경우 설정해야 하는 토큰은 이 가이드에 명시되어 있습니다. 하지만 속성을 재정의하는 데 사용되는 토큰을 확인하려면 구성요소의 source 폴더에서 grep을 수행합니다.

예를 들어 이전 버전의 Edge에서 session.maxAge 속성을 설정했다는 것을 알고 있고 토큰 값을 설정한 후 /<inst_root>/apigee/edge-ui/source에서 속성에 대해 grep을 입력합니다. 디렉터리:

> grep -ri "session.maxAge" /<inst_root>/apigee/edge-ui/source

다음과 같은 형식으로 결과가 표시됩니다.

/<inst_root>/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}

{T}{/T} 태그 사이의 문자열은 .properties 파일.

현재 댓글이 있는 토큰 설정 중

일부 토큰은 Edge 구성 파일에서 주석 처리됩니다. 특정 키-값 쌍에 대해 주석 처리되면 설정이 무시됩니다.

주석 처리된 토큰을 설정하려면 다음과 같은 형식의 특수 구문을 사용합니다.

conf/file.extension+propertyName=propertyValue

예를 들어 메시지에 HTTPClient.proxy.host라는 속성을 설정하려고 합니다. 프로세서. 그런 다음 grep로 속성을 사용하여 토큰을 결정합니다.

> cd /opt/apigee/edge-message-processor
> grep -ri "HTTPClient.proxy.host" *

grep 명령어는 다음을 반환합니다. 토큰 값을 포함하는 형식으로 생성됩니다. 속성 이름이 주석 처리된 것을 볼 수 있습니다. 속성 이름에서 # 접두사로 표시됩니다.

source/conf/http.properties:#HTTPClient.proxy.host={T}conf_http_HTTPClient.proxy.host{/T}
token/default.properties:conf_http_HTTPClient.proxy.host=
conf/http.properties:#HTTPClient.proxy.host=

속성을 설정하려면 /opt/apigee/customer/application/message-processor.properties를 수정하세요. 속성을 다음과 같이 설정합니다.

conf/http.properties+HTTPClient.proxy.host=myhost.name.com

속성 이름에 어떻게 conf/http.properties+, 위치 및 이름이 접두사로 붙는지 알 수 있습니다. 구성 파일에 '+'를 추가합니다.

메시지 프로세서를 다시 시작한 후 /opt/apigee/edge-message-processor/conf/http.properties 파일을 검사합니다.

> cat /opt/apigee/edge-message-processor/conf/http.properties

파일 끝에 다음 형식으로 속성 집합이 표시됩니다.

conf/http.properties:HTTPClient.proxy.host=yhost.name.com