Apigee Edge 문서입니다.
Apigee X 문서로 이동 info
2023년 10월 25일에 프라이빗 클라우드용 Apigee Edge의 새 버전이 출시되었습니다.
참고: 이 버전은 2024년 10월 25일까지 지원됩니다.
업데이트 절차
이 섹션에서는 이전 버전의 Edge for Private Cloud에서 업데이트하는 경우 이 버전을 설치하는 방법을 설명합니다. 이전 버전에서 업데이트해야 하는 경우 여러 패치 버전 적용을 참고하세요.
이 버전을 업데이트하면 다음 RPM 목록의 구성요소가 업데이트됩니다.
- edge-gateway-4.52.00-0.0.60200.noarch.rpm
- edge-management-server-4.52.00-0.0.60200.noarch.rpm
- edge-message-processor-4.52.00-0.0.60200.noarch.rpm
- edge-postgres-server-4.52.00-0.0.60200.noarch.rpm
- edge-qpid-server-4.52.00-0.0.60200.noarch.rpm
- edge-router-4.52.00-0.0.60200.noarch.rpm
- apigee-sso-4.52.00-0.0.21316.noarch.rpm
- edge-analytics-4.52.00-0.0.40100.noarch.rpm
- edge-management-ui-4.52.00-0.0.20029.noarch.rpm
- edge-ui-4.52.00-0.0.20233.noarch.rpm
- apigee-service-4.52.00-0.0.1500.noarch.rpm
- apigee-mirror-4.52.00-0.0.1032.noarch.rpm
- apigee-tomcat-9.0.82-0.0.939.noarch.rpm
- apigee-configutil-4.52.00-0.0.624.noarch.rpm
다음 명령어를 입력하여 현재 설치된 RPM 버전을 확인하고 업데이트해야 하는지 확인할 수 있습니다.
apigee-all version
설치를 업데이트하려면 Edge 노드에서 다음 절차를 실행하세요.
-
모든 Edge 노드에서 다음을 실행합니다.
- Yum 저장소를 정리합니다.
sudo yum clean all
- 최신 Edge 4.52.00
bootstrap_4.52.00.sh파일을/tmp/bootstrap_4.52.00.sh에 다운로드합니다.curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
- Edge 4.52.00
apigee-service유틸리티 및 종속 항목을 설치합니다.sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
여기서 uName 및 pWord은 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.
source명령어를 사용하여 apigee-service.sh 스크립트를 실행합니다.source /etc/profile.d/apigee-service.sh
- Yum 저장소를 정리합니다.
- 모든 에지 노드에서 에지 프로세스의
update.sh스크립트를 실행합니다./opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 모든 노드에서 SSO용
update.sh스크립트를 실행합니다. - 모든 UI 노드에서 UI용
update.sh스크립트를 실행합니다./opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- 새 Edge 환경을 사용하는 경우 다음 명령어를 실행합니다.
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
보안 문제 해결
다음은 이번 출시에서 수정된 알려진 보안 문제 목록입니다. 이러한 문제를 방지하려면 최신 버전의 프라이빗 클라우드용 Edge를 설치하세요.| 문제 ID | 설명 |
|---|---|
| 279065506 | OAuth2의 리디렉션 URL에서 상태 매개변수의 엔트로피가 예측할 수 없도록 개선되어 크로스 사이트 요청 위조 (CSRF) 취약점을 방지합니다.' |
| 279065586 | 클라이언트 측 공격으로부터 사이트를 보호하기 위해 헤더에 콘텐츠 보안 정책을 추가하여 추가적인 보안 레이어를 제공했습니다. |
지원되는 소프트웨어 변경사항
다음 소프트웨어 버전이 지원됩니다.
- Red Hat Enterprise Linux (Intel 64비트): 버전 8.8
- Oracle Linux (Intel 64비트): 버전 7.9, 8.7, 8.8
- Rocky Linux 8
- Tomcat 9.0.82
지원되는 소프트웨어의 전체 목록은 프라이빗 클라우드용 Edge 지원 소프트웨어를 참고하세요.
지원 중단 및 사용 중단
이번 출시에는 새로운 지원 중단 또는 폐지가 없습니다.
새로운 기능
이번 출시에는 다음과 같은 새로운 기능이 도입되었습니다.
조직 및 환경 이름의 최대 문자 수 설정
이번 출시를 통해 새 조직 또는 환경을 만들 때 조직 및 환경 이름의 최대 문자 수를 제한할 수 있습니다. 최대 문자 수의 기본값은 255입니다. 더 낮은 최댓값을 설정하려면 각 속성 파일에서 다음 속성을 설정하세요.
- 조직 속성 파일에서
org.name.max.length를 설정합니다. - 조직 속성 파일에서
env.name.max.length를 설정합니다.
이러한 속성 중 하나가 0보다 작거나 255보다 큰 값으로 설정되면 시스템은 각각 최대값 1 또는 255를 사용합니다.
액세스 토큰 만료 설정
이번 출시에서는 conf_keymanagement_oauth_access_token_expiry_time_in_millis 속성을 원하는 만료 시간(밀리초)으로 설정하여 액세스 토큰의 만료를 설정할 수 있습니다. 이 기능은 기본적으로 사용 중지되어 있습니다. 사용 설정하려면 메시지 프로세서에서 conf_keymanagement_oauth_access_token_is_apply_limit를 true로 설정하세요.
이 기능을 사용하면 Apigee 관리자가 Apigee에서 생성된 액세스 토큰의 만료를 더 효과적으로 제어할 수 있습니다.
버그 수정
이 섹션에는 이 출시에서 수정된 프라이빗 클라우드 버그가 나열되어 있습니다.
| 문제 ID | 설명 |
|---|---|
| 290242749 |
DataMasking에서 |
| 260397807 |
이메일 템플릿의 문제로 인해 이메일에서 멀티바이트 문자가 전송되지 않았습니다. 문제가 해결되었습니다. |
| 234544436 |
새 Edge UI에서 조직을 변경할 때 왼쪽 메뉴가 사라지는 문제가 있었습니다. 문제가 해결되었습니다. |
| 293268203 |
관리 서버 노드에서 분석 종속 항목이 자동으로 업그레이드되지 않았습니다. 문제가 해결되었습니다. |
| 261616264 |
업그레이드 프로세스 중에 postgresql이 삭제되지 않도록 부트스트랩 검사 추가 |
| 279065586 |
크로스 사이트 요청 위조 (CSRF) 취약점을 방지하기 위해 OAuth2의 리디렉션 URL에서 상태 매개변수의 엔트로피가 예측할 수 없도록 개선되었습니다. |
| 283310836 |
대규모 XML을 파싱할 때 표시되는 오류 메시지가 개선되었습니다. |
| 245936798 |
조직 및 환경 이름에 문제가 있어 Postgresql <code<create< code="" dir="ltr" translate="no"> 쿼리가 실패했습니다.</code<create<> 긴 조직 및 환경 이름에 대한 postgres 색인 이름 충돌을 개선하여 이 문제가 해결되었습니다. |
| 293733533 |
Edge Gateway 구성요소의 Spring 서드 파티 라이브러리가 버전 5.3.20에서 버전 5.3.27로 업데이트되었습니다. |
| 294363158 |
회귀로 인해 Edge UI의 분석 및 모니터링 페이지 드롭다운 메뉴에 일부 추가 측정기준이 표시되었습니다. 문제가 해결되었습니다. |
| 297889765 |
이제 apigee-mirror에서 생성된 아티팩트의 소유권이 올바릅니다. |
| 294989027 |
특정 통계 API의 성능이 개선되었습니다. |
알려진 문제
알려진 문제의 전체 목록은 프라이빗 클라우드용 Edge에서 알려진 문제를 참고하세요.
여러 패치 버전 적용
이 섹션에서는 이전 패치 출시 버전보다 이전 버전의 Edge for Private Cloud에서 업데이트하는 경우 여러 패치 버전을 적용하는 방법을 설명합니다.
각 패치 출시에는 edge-management-server와 같은 Edge for Private Cloud의 특정 구성요소에 대한 업데이트가 포함됩니다.
패치 버전을 여러 개 적용하려면 현재 설치된 버전보다 늦은 패치 버전에 포함된 각 Edge 구성요소를 업데이트해야 합니다. 현재 버전보다 최신 버전의 프라이빗 클라우드용 Edge 출시 노트를 살펴보고 해당 출시의 RPM 목록을 확인하면 이러한 구성요소를 찾을 수 있습니다. 모든 프라이빗 클라우드용 Edge 출시 노트 링크는 Apigee 출시 노트를 참고하세요.
참고: 패치 버전에 포함된 최신 버전의 구성요소용 RPM을 설치하여 각 구성요소를 한 번만 업데이트하면 됩니다. 해당 버전의 출시 노트에 나온 안내에 따라 구성요소를 업데이트합니다.
참고: 구성요소를 업그레이드하면 구성요소의 최신 패치 버전이 자동으로 설치됩니다. 최신 버전이 아닌 패치 버전으로 업그레이드하려면 Apigee 미러를 사용하여 Apigee 저장소의 자체 tarball 사본을 유지하고 Apigee 설치에 이 미러를 사용해야 합니다. 자세한 내용은 로컬 Edge 저장소를 사용하여 Edge 버전 유지를 참고하세요.