Private Cloud용 Edge v. 4.17.09
설치 후 Edge를 구성하려면 .properties 파일과 Edge 유틸리티를 함께 사용합니다. 대상 예를 들어 Edge UI에서 TLS/SSL을 구성하려면 .properties 파일을 수정하여 필요한 속성 .properties 파일을 변경하려면 영향을 받는 Edge 구성요소를 확인할 수 있습니다
Apigee에서는 .properties 파일을 구성을 참조하세요. 기본적으로 config이 있는 코드는 .properties 파일. 코드에서 구성에서는 이 키를 토큰이라고 합니다. 따라서 Edge를 구성하려면 이 속성은 .properties 파일에 포함됩니다.
구성이 포함된 코드를 사용하면 Edge 구성요소가 제품을 배포하면 설치팀이 설치 토폴로지에 따라 해당 설정을 재정의할 수 있습니다. 고객이 선택한 속성을 재정의할 수 있습니다.
계층 구조로 생각하면 설정은 다음과 같이 고객에 맞춰 정렬됩니다. 우선순위가 가장 높은 설정을 선택하여 설치 기사팀의 설정보다 우선 적용되도록 할 수 있습니다. Apigee:
- 고객
- 설치 프로그램
- Apigee
.properties 파일 사용 방법
고객은 .properties 파일만 수정할 수 있습니다. /opt/apigee/customer/application 를 참조하세요. 각 구성요소는 해당 디렉터리에 자체 .properties 파일을 갖습니다. 예: router.properties 및 management-server.properties가 포함됩니다.
예를 들어 .properties 파일을 만드는 방법은 다음과 같습니다.
- 편집기에서 원하는 사용자로 파일을 만듭니다.
- 파일 소유자를 apigee:apigee로 변경하거나 사용자를 변경한 경우 Apigee 사용자의 Edge 서비스를 실행하고, 에지 서비스를 실행하고 있는지 확인합니다
구성요소의 속성을 설정하려면 해당하는 .properties 파일을 수정하여 토큰을 설정합니다. 구성요소를 다시 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service component restart
예를 들어 router.properties를 수정한 후 라우터를 다시 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
Edge를 업그레이드하면 .properties 파일이 /opt/apigee/customer/application 읽을 수 있습니다 즉, 업그레이드 시 구성요소를 사용합니다.
.properties 파일의 위치
Edge용 .properties 파일의 최상위 디렉터리는 3개임 구성요소인 설치 소유자와 고객입니다. 기본 위치는 다음 위치에 나와 있습니다. 표:
경고: Edge 고객은 다음 위치에서 .properties 파일만 수정할 수 있습니다. /opt/apigee/customer. 하는 동안 구성 요소 및 설치 디렉토리 아래의 파일을 볼 수 있지만, 파일은 수정하지 않습니다.
|
소유자 |
기본 토큰 루트 디렉터리 |
|---|---|
|
구성요소 |
/opt/apigee/<prefix>-<component>/conf 각 항목의 의미는 다음과 같습니다. /<prefix>-<component> 는 Edge-router 또는 apigee-cassandra와 같은 구성요소를 식별합니다. |
|
설치 |
/opt/apigee/token |
|
고객 |
/opt/apigee/customer |
토큰의 현재 값 확인
구성요소의 .properties 파일에 토큰을 설정하기 전에 먼저 다음 명령어를 사용하여 현재 값을 확인할 수 있습니다.
> /opt/apigee/apigee-service/bin/apigee-service comp configure -search token
여기서 comp는 구성요소의 이름입니다. token은 검사할 토큰입니다.
이 명령어는 .properties 파일의 계층 구조를 검색하여 토큰의 현재 값입니다.
예를 들어 conf_http_HTTPRequest.line.limit 토큰의 현재 값을 라우터:
> /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit
다음과 같은 형식으로 출력이 표시됩니다.
Found key conf_http_HTTPRequest.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties
.properties 파일에서 토큰 설정
토큰의 값을 재정의하는 방법은 다음과 같습니다.
- 속성별 .properties 파일을 구성요소를 사용하여 토큰 값을 설정합니다. 파일이 없으면 새로 만듭니다.
- 구성요소를 다시 시작합니다.
- 토큰 값을 확인합니다.
예를 들어 Edge Router에 요청 줄 한도를 설정하려면 다음 안내를 따르세요.
- /opt/apigee/customer/application/router.properties를 수정합니다.
파일을 업로드하여 conf_http_HTTPRequest.line.limit 토큰을 설정합니다.
<ph type="x-smartling-placeholder">
</ph> conf_http_HTTPRequest.line.limit=8k - 다음과 같이 Edge Router를 다시 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service Edge-router 재시작 - 토큰의 값을 확인합니다.
> /opt/apigee/apigee-service/bin/apigee-service Edge-router 구성 -검색 conf_http_HTTPRequest.line.limit
여러 값을 사용하는 토큰 설정
일부 토큰은 쉼표로 구분된 값 목록을 사용합니다. 예: conf_security_rbac.restricted.resources 토큰 시스템 관리자만 호출할 수 있도록 제한된 URI 목록을 사용합니다. 이 conf_security_rbac.restricted.resources 값:
> cd /opt/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에 추가하려면 /opt/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 속성을 설정했다는 것을 알고 있고 토큰 값을 설정한 후 /opt/apigee/edge-ui/source 디렉터리에서 속성에 대해 grep을 가져옵니다.
> grep -ri "session.maxAge" /opt/apigee/edge-ui/source
다음과 같은 형식으로 결과가 표시됩니다.
/opt/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=myhost.name.com