4.19.01 프라이빗 클라우드용 Edge 출시 노트

Apigee-sso 설치의 메타데이터 파일 형식

apigee-sso를 설치하고 URL 대신 metadata.xml 파일을 사용할 때 metadata.xml 파일의 끝부분에 새 줄 (CRLF)이 포함되어 있지 않으면 metadata.xml 파일을 완전히 읽을 수 없습니다.

해결 방법:

이 문제를 해결하려면 다음 중 하나를 수행하세요.

• metadata.xml 파일 끝에 CRLF 추가

  또는

• 메타데이터에 URL 기반 위치 사용

Amazon Linux 1에서 apigee-monit가 지원되지 않음

해결 방법:

메시지 프로세서 백업이 올바른 파일 세트를 백업하지 않음

해결 방법:

백업을 두 번 실행하면 올바른 파일 세트가 백업됩니다.

세션 토큰이 무효화되지 않음

사용자가 Apigee Edge 로그아웃 버튼을 클릭해도 서버에서 세션 토큰이 무효화되지 않습니다.

해결 방법:

JMX 인증이 사용 설정된 경우 Cassandra 작업이 작동하지 않음

해결 방법:

Node.js 대상에 대한 HEAD 요청이 중단됨

Node.js 대상에 대한 HEAD 요청이 중단될 수 있으며 연결이 대기 중인 상태로 남습니다.

해결 방법:

이 문제를 해결하려면 빈 응답을 명시적으로 반환하도록 HEAD 요청의 핸들러를 정의하세요.

호스트 이름이 확인되지 않음

Private Cloud용 Edge를 설치하거나 업그레이드한 후 호스트 이름이 주소로 확인되지 않을 수 있습니다.

해결 방법:

이 문제를 해결하려면 다음과 같이 Edge UI 구성요소를 다시 시작하세요.

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

여러 데이터 센터 구성의 DataAccessException

여러 데이터 센터 구성에서 하나의 Datastore를 사용할 수 없게 되면 다음 오류가 반환됩니다.

DataAccessException: Error while accessing datastore;
Please retry later

결과적으로 관리 서버가 Cassandra에 연결을 시도하기 때문에 시작되지 않을 수 있습니다. dc-1과 dc-2 모두에 DataAccessExceptions은 Cassandra 노드가 다음과 같은 경우에 발생합니다. 감소합니다. 이로 인해 API 트래픽 중단이 발생할 수도 있습니다. API 트래픽 중단은 메시지 프로세서가 DataAccessExceptions를 발생시킵니다.

예상되는 상태는 관리 서버가 데이터 저장소 구성요소에 연결되지 않는 것입니다. 여러 리전 간에 분산될 수 있습니다

해결 방법

해결 방법은 사용할 수 없는 데이터 센터에서 다음 Cassandra 노드 유형을 등록 취소하는 것입니다. Cassandra 노드를 다시 사용할 수 있게 되면 다시 등록하세요.

• kms-datastore
• dc-datastore
• keyvaluemap-datastore

이러한 Cassandra 노드 유형을 등록 취소하고 재등록하려면 다음 안내를 따르세요.

1. 다음 curl 명령어를 사용하여 Cassandra 노드의 UUID를 가져옵니다.

   curl -u ADMIN_EMAIL:ADMIN_PW \
     "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
     &type=CASSANDRA_NODE_TYPE"

   각 항목의 의미는 다음과 같습니다.

   • ADMIN_EMAIL 및 ADMIN_PW는 Apigee의 사용자 인증 정보입니다. 있습니다.
   • MS_IP 및 MS_PORT는 관리 서버의 IP 주소 및 포트입니다. 있습니다.
   • REGION은 관리 서버가 있는 데이터 센터의 이름입니다. 위치해 있습니다
   • GATEWAY_POD은 포드 이름이며 기본값은 '게이트웨이'입니다. 혹시 대신 다른 이름으로 변경했으므로 구현을 확인하세요.
   • CASSANDRA_NODE_TYPE은(는) kms-datastore, dc-datastore 중 하나입니다. 및 keyvaluemap-datastore.

   예를 들면 다음과 같습니다.

   curl -u nickdanger@google.com:myP@$$w0rD
     "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

   응답은 다음 형식을 사용합니다.

   {
     "internalIP" : "POD_IP_ADDRESS",
     "isUp" : [true|false],
     "pod" : "GATEWAY_POD",
     "reachable" : [true|false],
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
       "uUID" : "POD_UUID"
   }

   예를 들면 다음과 같습니다.

   {
     "internalIP" : "192.168.1.11",
     "isUp" : false,
     "pod" : "gateway",
     "reachable" : false,
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : "dc-datastore",
     "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
   }

   응답의 uUID 필드 값을 기록해 둡니다. 다음 작업에 사용할 수 있습니다. 취소해야 합니다

2. 각 Cassandra 노드 유형(kms-datastore)에 대해 1단계를 반복합니다. dc-datastore, keyvaluemap-datastore 다음 반환되는 UUID입니다.
3. 다음 명령어를 사용하여 노드를 등록 해제합니다.

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

   여기서 UUID는 이전 명령어의 응답에서 반환된 UUID입니다.

4. 1단계와 2단계에서 수집한 각 UUID마다 3단계를 반복합니다.
5. 다음 명령어를 사용하여 노드를 재등록합니다.

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
     "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
     Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
     region=REGION&pod=GATEWAY_POD" -H \
     'content-type: application/x-www-form-urlencoded' -X POST

이러한 작업은 주키퍼에서 노드를 등록 및 등록 취소하며, 영향을 미칠 수 있습니다 이러한 명령어에 관한 자세한 내용은 데이터 스토어 등록을 업데이트합니다.

로그 메시지에 추가 정보를 포함하는 MessageLogging 정책

MessageLogging 정책의 FormatMessage 요소는 로깅되는 메시지의 형식을 제어합니다. FormatMessage=false인 경우 로깅된 메시지에는 Apigee에서 생성한 정보가 포함되지 않아야 합니다. 그러나 FormatMessage=false를 설정해도 로그 메시지에는 다음 정보가 포함됩니다.

• 우선순위 점수
• 타임스탬프

해결 방법:

시스템 관리자 비밀번호 재설정에 실패함

특수문자가 포함된 관리 서버에 대한 시스템 관리자 비밀번호는 재설정되지 않습니다.

해결 방법:

데이터 파일에 비밀번호를 정의한 다음 Management API의 /users 엔드포인트에 전달합니다. 자세한 내용은 시스템 관리자 비밀번호 재설정을 참고하세요.