Red Hat 3scale API Management 2.12 온-프레미스 릴리스 정보
Red Hat 3scale API Management 2.12에서 사용되는 문서
초록
머리말 링크 복사링크가 클립보드에 복사되었습니다!
이 문서는 Red Hat 3scale API Management 2.12 및 관련 패치 릴리스에서 사용할 수 있도록 작성되었습니다.
1장. Red Hat 3scale API Management 2.12.2 - 패치 릴리스 링크 복사링크가 클립보드에 복사되었습니다!
이 문서는 Red Hat 3scale API Management 2.12.2 온-프레미스에서 사용하기 위한 것입니다.
1.1. 보안 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
- Red Hat 제품 권고 포털에서 3scale 2.12.2 보안 업데이트에 대한 최신 정보를 확인하십시오.
2장. Red Hat 3scale API Management 2.12.1 - 패치 릴리스 링크 복사링크가 클립보드에 복사되었습니다!
이 문서는 Red Hat 3scale API Management 2.12.1 온-프레미스에서 사용하기 위한 것입니다.
2.1. 해결된 문제 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat 3scale API Management 2.12.1에서는 다음 문제를 해결합니다.
| 문제 번호 | 설명 |
|---|---|
| 백엔드 상위 이미지를 ubi8-minimal:8.6으로 업데이트 | |
| 지원되는 상위 이미지로 업그레이드 - Porta의 ubi7/ruby-26 상위 이미지는 2022년 5월 수명 종료에 도달했습니다. |
3장. Red Hat 3scale API Management 2.12 링크 복사링크가 클립보드에 복사되었습니다!
이 문서는 Red Hat 3scale API Management 2.12 온-프레미스에서 사용하기 위한 것입니다.
3.1. 새로운 기능 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat 3scale API Management 2.12에서는 다음과 같은 새로운 기능을 제공합니다.
- IBM Z 및 LinuxONE에서 Red Hat 3scale API Management 지원 자세한 내용은 IBM Z 및 LinuxONE 지원을 참조하십시오.
- Red Hat OpenShift Dedicated (OSD), Red Hat OpenShift Service on AWS (ROSA) 및 Azure Red Hat OpenShift (ARO)에서 Red Hat 3scale API Management 지원
MySQL 8 데이터베이스(Jira 7786) 지원.
3scale 2.12와 함께 MySQL 8.0을 사용하려면 인증 플러그인을
mysql_native_password로 설정해야 합니다. MySQL 구성 파일에 다음을 추가합니다.default_authentication_plugin=mysql_native_password
default_authentication_plugin=mysql_native_passwordCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 시스템 구성 요소에 대한 외부 데이터베이스로 PostgreSQL 13 지원(Jira 7897).
- 클러스터 전체 설치 모드. 이제 모든 네임스페이스(Jira 7959 Jira 7960)에서 Operator를 사용할 수 있습니다.
- APIcast 프록시 구성을 관리하기 위한 새로운 toolbox CLI 명령(Jira 7997).
-
향상된 toolbox CLI
가져오기명령을 사용하여 OpenAPI 문서(Jira7715)에서 백엔드 API를 만듭니다. - 외부 데이터베이스 구성 요소를 별도로 구성할 수 있는 기능(Jira 6836).
- 메서드 및 메트릭(Jira 6867 및 Jira 6872)을 관리하기 위한 향상된 사용자 인터페이스(UI)입니다.
3.2. IBM Z 및 LinuxONE 지원 링크 복사링크가 클립보드에 복사되었습니다!
IBM Z 및 LinuxONE(s390x)에서 지원되는 기능입니다.
- OperatorHub의 3scale 배포
- 모든 UBI(Universal Base Images) 7 및 UBI 8 이미지
- OpenShift Container Platform (RHOCP) v4.10의 자체 관리 APIcast Operator
- APIcast v3.12용 OCP에서 자체 관리 APIcast
- 도구 상자 이미지
- Red Hat Single Sign-On(RH SSO) 7.5
IBM Z 및 LinuxONE에서는 다음 기능이 지원되지 않습니다.
- RHEL 8을 기반으로 Podman의 자체 관리 APIcast
- MSQL 8 외부
- PostgreSQL 13.x 외부
- Redis HA
- Oracle Database 19c
- S3 API 호환 파일 스토리지 - Minio
- 연결이 끊긴 (air-gapped) RHOCP 환경에서 배포
3.3. 기술 프리뷰 기능 링크 복사링크가 클립보드에 복사되었습니다!
기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다. Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 https://access.redhat.com/support/offerings/techpreview/를 참조하십시오.
Red Hat 3scale API Management 2.12는 애플리케이션 기능을 위한 3scale Operator를 기술 프리뷰 기능으로 제공합니다. 3scale Operator를 사용하면 3scale 설치에서 사용할 사용자 정의 리소스(CR)를 사용하여 3scale 테넌트, API, 애플리케이션 계획, 제한, 지표 및 기타 오브젝트를 정의할 수 있습니다 (Jira 3486). 3scale Operator를 사용하여 3scale 구성 및 프로비저닝을 참조하십시오.
3scale operator 애플리케이션 기능이 3scale 2.12에서 개선되어 테넌트 (Jira 6051), 제품 (JIRA6581 ) 및 백엔드 (Jira 6580) 사용자 정의 리소스를 삭제할 수 있습니다.
3.4. 해결된 문제 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat 3scale API Management 2.12에서는 다음 문제를 해결합니다.
- app_id 및 app_key 모드(Jira 6296)를 사용할 때 사용 규칙의 중복 기능.
- 날짜 필터가 APIcast 로깅 정책 (Jira 6594)에서 작동하지 않습니다.
- 환경 변수(AMP_VERSION)는 시스템 업그레이드(Jira 7427)에서 업데이트되지 않습니다.
- Toolbox에서 "Unexpected error"가 발생합니다. 찾을 수 없는 메트릭 ID 250에 참조하는 제한 120 (Jira 7568).
- Liquid 필터 "Split"은 결과 배열의 마지막 요소를 무시합니다(Jira 7643).
- Liquid "contains" 키워드는 배열을 구문 분석할 때 예상대로 작동하지 않습니다(Jira 7678).
- Operator에서 백엔드를 생성하지 못했습니다(Jira 7900).
- APIcast Operator는 기존 시크릿(Jira 7904)의 소유권을 사용합니다.
- 백엔드+ 제품 구성(Jira 7911)과 "oc apply"를 사용할 때 Operator에서 CRD를 동기화하지 못했습니다.
- 개발자 포털 CMS 파일/페이지의 태그 구분 기호 문제(Jira 7935).
- 제품 분석의 날짜 피커는 사라지지 않습니다(Jira 7947).
- APIcast는 개인 기본 URL(Jira 7967)으로 정의되지 않은 업스트림과 연결하는 프록시 사용을 지원하지 않습니다.
- APIcast는 TLS 종료 및 경로 라우팅 요청에서 잘못된 서비스에 대한 요청(Jira 8000 및 Jira 8007)으로 구성됩니다.
- 이메일은 제목 및/또는 본문(Jira 8009) 없이 전송할 수 있습니다.
- 3scale CRD(Jira 8031)로 제품을 정의할 때 불완전한 상태입니다.
- APIManager CR 필드가 값을 변경할 때 APIcast 배포는 롤아웃되지 않습니다(Jira 8126).
- 원래 요청 정보에 클라이언트 측 연결이 재사용될 때 잘못된 데이터가 포함됩니다(Jira 8252).
- 빈 콘텐츠가 있는 ActiveDoc를 생성할 때 Operator가 실패합니다(Jira 8287).
- UI에서 테넌트를 삭제하면 테넌트가 선언적으로 생성되었을 때 무한 루프가 발생합니다(Jira 8301).
3.5. 확인된 문제 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat 3scale API Management 2.12의 알려진 문제
- APIcast는 요청의 호스트와 일치하는 서비스에 대한 최신 버전의 프록시 구성 (JIRA 8485)을 검색할 수 없습니다.
- 3scale 온-프레미스에서는 24시간(JIRA8417)이 지난 제품, 백엔드 또는 계정에 대해 검색이 작동하지 않습니다.
테넌트에서 태그를 중복하면 마이그레이션이 실패합니다. 2.11에서 2.12로 마이그레이션하기 전에 중복 태그가 포함된 테넌트가 있는지 확인합니다. 예를 들어 MySQL 데이터베이스의 경우 다음 쿼리를 실행합니다.
SELECT tenant_id, name, count(*) from tags GROUP BY tenant_id, name HAVING count(*) > 1;
SELECT tenant_id, name, count(*) from tags GROUP BY tenant_id, name HAVING count(*) > 1;Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이 쿼리는 모든 테넌트를 테스트합니다. 결과적으로 테넌트에 중복 태그가 없음을 나타냅니다. 테넌트에 중복 태그가 포함된 경우 Jira 7986 의 절차에 따라 중복 태그를 제거하십시오.
-
NGINX Filters 정책은 콘텐츠 캐싱 정책도 추가할 때 적용되지 않습니다. 기본 동작은 콘텐츠 캐싱이 비활성화되어 있습니다. 콘텐츠 캐싱을 활성화하면 NGINX 필터 정책을 추가한 경우에도 요청 헤더를 검증할 수 없는 경우
412응답 코드를 반환합니다 (Jira 7514). 3scale의 사용자 이름은 40자 이상이어야 합니다. 사용자 이름이 40자를 초과하면 3scale은 일반적으로 이를 자릅니다. 다음 중 하나를 수행할 때 이를 고려하십시오.
- 개발자 계정을 생성합니다.
- 공급자 계정을 마스터로 생성합니다.
- 공급자 계정에 사용자를 공급자 계정으로 추가하거나 마스터로 추가합니다.
- 개발자 포털 또는 관리 포털에서 개발자 계정에 사용자를 추가합니다.
Red Hat Single Sign-On을 사용하여 관리 포털 또는 개발자 포털에 대한 액세스를 인증하는 경우 사용자 이름은 40자 이상이어야 합니다.
4장. 문서 링크 복사링크가 클립보드에 복사되었습니다!
지원되는 구성
- Red Hat 3scale API Management Supported Configurations 웹 사이트에서 3scale 2.12 지원 구성에 대한 최신 정보를 확인하십시오.
보안 업데이트
- Red Hat 제품 권고 포털에서 3scale 2.12 보안 업데이트에 대한 최신 정보를 확인하십시오.
에라타
- RPMS에 대한 권고: https://errata.engineering.redhat.com/advisory/59961
- 컨테이너 이미지에 대한 권고: https://errata.engineering.redhat.com/advisory/59962
업그레이드 가이드
다음 배포의 경우 3scale 설치를 2.11에서 2.12로 업그레이드하는 절차를 확인하십시오.
- 템플릿 기반(더 이상 사용되지 않음)
- Operator기반
- Operator 기반 배포의 APIcast
보다 포괄적 수용을 위한 오픈 소스 용어 교체 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 용어를 교체하기 위해 최선을 다하고 있습니다. 먼저 마스터(master), 슬레이브(slave), 블랙리스트(blacklist), 화이트리스트(whitelist) 등 네 가지 용어를 교체하고 있습니다. 이러한 변경 작업은 작업 범위가 크므로 향후 여러 릴리스에 걸쳐 점차 구현할 예정입니다. 자세한 내용은 CTO Chris Wright의 메시지에서 참조하십시오.