정액제 구독을 사용하여 레거시 클라우드 인프라에서 실행되는 Oracle Content Management 인스턴스가 있는 경우 오라클은 해당 인스턴스를 새로운 고유 OCI(Oracle Cloud Infrastructure) 환경인 2세대 OCI(즉, Infrastructure 콘솔을 사용하여 서비스 인스턴스 관리)로 이전할 것을 권장합니다. 그러면 향후 Oracle Cloud 플랫폼의 이점과 발전을 누릴 수 있습니다.
이전을 시작하려면 이전하기 전에 몇 가지 단계를 수행하고 오라클 고객지원센터와 협력하여 이전 일정을 잡아야 합니다.
이 표는 Oracle Content Management 권한 그룹과 OCI 애플리케이션 롤의 매핑을 설명합니다.
Oracle Content Management 권한 그룹 | OCI 애플리케이션 롤 |
---|---|
DocumentsServiceUser | CECStandardUser |
DocumentsServiceAdmin | CECServiceAdministrator |
SitesServiceVisitor | CECSitesVisitor |
SitesServiceAdmin | CECSitesAdministrator |
ContentAdministratorRole | CECContentAdministrator |
CECSStandardUser | CECStandardUser |
CECSEnterpriseUser | CECEnterpriseUser |
주:
대상 IDCS 도메인에 이미 동일한 사용자 이름을 가진 사용자가 있는 경우 사용자의 Oracle Content Management 권한 그룹에 해당하는 OCI 애플리케이션 롤이 지정됩니다.이전 준비가 되면 이전 요청을 제출하여 프로세스를 시작해야 합니다.
오라클 고객지원센터가 이전 서비스 요청을 접수한 후 요청한 날짜에 준하여 이전 일정을 잡으면 이전을 시작할 날짜 및 시간으로 서비스 요청이 업데이트됩니다.
이전 진행 상황을 표시하도록 서비스 요청이 업데이트됩니다. 데이터 이전은 백엔드로 진행됩니다. 즉, 서비스 요청 업데이트를 유지하고 이전이 완료된 후 검증하는 것 외에 귀하가 수행할 작업은 없습니다.
이전 중에 다음 상황이 발생합니다.
중요사항:
이 시점에는 기존(소스) 인스턴스를 변경하지 않아야 합니다. 이전을 시작한 이후 변경사항은 새 인스턴스로 이전되지 않습니다.기존 인스턴스가 직접 또는 REST API 호출을 통해 다른 서비스나 애플리케이션과 통합되거나 통신한 경우 이전 후 작업을 수행해야 할 수도 있습니다.
다음 항목은 서비스 전체에 적용됩니다.
기존 URL은 다음 패턴을 사용했습니다.
https://<service-name>-<account-name>.<region>.oraclecloud.com/documents
새 URL은 다음 패턴을 사용했습니다.
https://<service-name>-<account-name>.<service-type>.ocp.oraclecloud.com/documents
통합 | 이전 후 수행할 사항 |
---|---|
Oracle Integration |
|
Oracle Commerce Cloud |
|
Oracle Process Cloud Service |
|
Oracle Eloqua Cloud Service |
|
Oracle Intelligent Advisor |
|
Oracle Cobrowse Cloud Service |
|
Responsys |
|
VBCS(Visual Builder Cloud Service) |
|
CDN/Akamai |
|
REST API 호출 |
|
클라이언트 SDK/CLI 사용법 |
|
커넥터 |
|
주:
새 인스턴스의 URL이 변경되었으므로 기존 인스턴스에 있는 콘텐츠의 책갈피는 더 이상 작동하지 않습니다.자산이 포함되지 않은 사이트는 자동으로 이전되지만, 자산이 포함된 사이트는 새 Oracle Content Management 인스턴스에서 작동하도록 몇 가지 추가 단계가 필요합니다.
"cec migrate-site" 명령이 새로 추가되었으므로 이전에 OCE Toolkit을 다운로드 및 설치했더라도 웹 클라이언트 git 저장소에서 툴킷을 설치해야 합니다.
Sites Toolkit 페이지의 지침에 따라 OCE Toolkit을 다운로드 및 설치합니다.
대상 서버(사이트 이전 대상이 될 서버):에 대한 접속 세부정보를 등록합니다
> cec register-server <target_server_name> -e http://<target_server>:<target_port> -u <target_username> -p <target_password> -t pod_ec
사이트를 이전하려면 다음 단계를 수행하십시오.
<site_name>
을 대상 서버에 배치할 사이트 이름으로 바꿉니다.
> cec migrate-site <site_name> --template <template_path_and_name> --destination <registered_target_server_name> --repository <repository_name>
사이트를 이전한 후 Content REST v1.1 호출을 사용하여 사이트가 실행됩니다. 이로 인해 사이트가 올바로 실행되기 전에 해결해야 하는 문제가 생길 수 있습니다. 다음을 살펴보고 수행할 작업을 결정하십시오.
사이트가 올바르게 실행 중이면 MLS 호환 사이트로 설정해야 합니다. 외부 컴퓨트 서버에 엔터프라이즈 사이트를 생성하려면 기본 언어 및 지역화 정책이 필요합니다. 사이트가 상호 복사된 비MLS 사이트이므로 향후 기능을 지원할 수 있도록 MLS 사이트로 업그레이드해야 합니다.
다음 표는 MLS 사이트와 비MLS 사이트 간의 차이점을 보여줍니다.
사이트 객체 | MLS 사이트 | 비MLS 사이트 |
---|---|---|
콘텐츠 항목 | 페이지 위에 놓인 콘텐츠 항목이 아닌, 콘텐츠 항목 언어 변형이 표시됩니다. 사이트를 렌더링할 때 요청된 언어에 따라 언어가 변경될 수 있습니다. | 페이지 위에 놓인 콘텐츠 항목이 항상 표시됩니다. |
콘텐츠 레이아웃 | 콘텐츠 레이아웃이 v1.1 API를 지원해야 합니다. 콘텐츠 항목이 표시되지 않을 경우 경고가 표시됩니다. 모든 v1.1 API 호출에는 v1.0 API에서 지원되지 않는 "locale"이 추가되기 때문입니다. | 콘텐츠 레이아웃은 v1.0 또는 v1.1일 수 있습니다. 콘텐츠 레이아웃이 v1.0만 지원하면 ContentSDK는 응답에 "data" 항목을 추가하여 "fields" 항목과 일치시킵니다. 여전히 다른 문제가 생길 수 있으므로 콘텐츠 레이아웃을 업그레이드하지 않는 경우 "지원되는 기능"으로 간주해서는 안됩니다. |
콘텐츠 목록 | 요청된 언어 변형으로 제공되는 콘텐츠 항목만 표시됩니다. | 언어에 관계없이 모든 콘텐츠 항목이 표시됩니다. 사용자가 콘텐츠 목록에 특정 언어로 결과를 고정할 수 있는 옵션이 있으므로 페이지에 두 개의 콘텐츠 목록이 서로 다른 언어로 결과를 표시할 수 있습니다. 이 설정 패널의 언어 선택 옵션은 MLS 사이트에서 사용할 수 없습니다. |
defaultLocale | MLS 사이트에는 기본 사이트 로케일이 있습니다. 즉, 모든 콘텐츠 질의는 해당 로케일로 된 콘텐츠 항목만 반환합니다(또는 번역 불가능). | 비MLS 사이트에는 기본 로케일이 없으므로 사용된 콘텐츠 질의는 언어에 관계없이 모든 콘텐츠 항목을 반환합니다. |
지역화 정책 |
사이트에서 사용 가능한 언어 목록을 정의합니다. 작성기에 해당 드롭다운이 있습니다. 또한 관리 UI에는 언어 드롭다운이 있어서 요청된 언어로 열거나 미리 볼 수 있습니다. |
지역화 정책이 없으므로 언어를 전환하는 드롭다운이 작성기에서 제거됩니다. 관리 UI에는 "기본" 언어를 비롯하여 나열된 언어가 없습니다. 이 방법으로 관리 UI에서 비MLS 대 MLS 사이트를 인식할 수 있습니다. |
번역/번역 가능 | 관리 UI의 컨텍스트 메뉴에 "번역" 옵션이 있습니다. 번역 작업을 생성하여 사이트를 번역할 수 있습니다. |
관리 UI의 컨텍스트 메뉴에 "번역 가능" 옵션이 있습니다. 사실상 비MLS는 번역 불가능하므로 사이트를 번역하기 전에 먼저 번역 가능(MLS) 사이트로 설정해야 합니다. 이것은 비MLS에서 MLS로 사이트를 "업그레이드"하는 방법이기도 합니다. 주: 단방향만 가능합니다. 번역 불가능으로 다운그레이드할 수 없습니다. |
MLS 사이트로 전환하기 전에 다음을 수행해야 합니다.
그런 다음 Content REST 호출을 실행하는 사용자정의 구성요소 코드가 있으면 이것도 v1.1 호출로 업그레이드해야 합니다. 대부분의 콘텐츠 호출은 콘텐츠 레이아웃에서 실행되므로 흔한 일은 아닙니다.
콘텐츠 레이아웃 업그레이드
지원되는 Content REST API 버전 지정
콘텐츠 레이아웃이 지원하는 Content REST API 버전을 지정해야 합니다. 이는 적절한 Content REST 호출을 실행하여 예상한 응답 데이터가 레이아웃에 반환되도록 하는 것입니다.
버전 지원을 지정하지 않으면 콘텐츠 레이아웃이 v1.0만 지원한다고 가정합니다.
콘솔은 여전히 v1.0 콘텐츠 레이아웃을 나열합니다.
콘텐츠 레이아웃이 다른 버전을 지원하도록 하려면 콘텐츠 레이아웃 객체에 "contentVersion" 속성을 추가합니다.
이 예제에서는 v1.0과 2.0 미만 사이의 모든 버전을 지원합니다. (주: 2.0은 존재하지 않지만 주 버전 변경은 호환성이 손상되는 변경을 일으킬 수 있습니다.)
// Content Layout definition.ContentLayout.prototype = { // Specify the versions of the Content REST API that are supported by the this Content Layout. // The value for contentVersion follows Semantic Versioning syntax. // This allows applications that use the content layout to pass the data through in the expected format. contentVersion: ">=1.0.0 <2.0.0", // Main rendering function: // - Updates the data to handle any required additional requests and support both v1.0 and v1.1 Content REST APIs // - Expand the Mustache template with the updated data // - Appends the expanded template HTML to the parentObj DOM element render: function (parentObj) {
v1.1 응답 변경사항 처리
최소한 수행할 작업은 "data"에서 "fields"로 Content REST API 응답 변경을 처리하는 것입니다. 이를 위한 가장 간단한 방법은 "data" 속성을 다시 추가하여 새 "fields" 속성을 가리키는 것입니다.
render: function (parentObj) { ... if(!content.data) { content.data = content.fields; }
더 좋은 방법은 콘텐츠 레이아웃 전체에서 v1.1 "fields" 값을 사용하도록 변경하는 것입니다. 여기에는 JavaScript 및 템플리트 코드 업데이트가 포함됩니다.
v1.1을 완전히 지원하려면 v1.0과 v1.1 사이의 다음 Content REST API 변경사항을 처리해야 합니다.
Content REST API 변경 | v1.1 | v1.0 |
---|---|---|
"fields" 대 "data" |
"items": [{ "type": "Starter-Blog-Author", "name": "Alex Read", "id": "COREB62DBAB5CEDA4915A9C9F6050E554F63", "fields": { "starter-blog-author_bio": "Alex's bio", "starter-blog-author_name": "Alex Read" } }, |
"items": [{ "type": "Starter-Blog-Author", "name": "Alex Read", "id": "COREB62DBAB5CEDA4915A9C9F6050E554F63", "data": { "starter-blog-author_bio": "Alex's bio", "starter-blog-author_name": "Alex Read" } }, |
camelCase 속성 이름 | "updatedDate" | "updateddate" |
질의 형식 | /items?q=(type eq "Starter-Blog-Author") | /items?fields.type.equals="Starter-Blog-Author" |
API 버전 | /content/management/api/v1.1/items | /content/management/api/v1/items |
언어별 질의 | /content/management/api/v1.1/items?q=((type eq "Promo") and (language eq "en-US" or translatable eq "false")) |
지원되지 않음. "language" 옵션을 포함하도록 모든 사용자정의 v1 호출을 이전해야 합니다. 그러면 특정 언어로 봤을 때 MLS 사이트에 반환된 것과 결과가 일치합니다. |
콘텐츠 질의 문자열 업그레이드
사용자정의 코드로 Content API 호출을 실행할 수 있습니다. 이때 Content REST API 호출을 실행하는 사이트에서 사용된 모든 사용자정의 코드를 검증해야 합니다.
비MLS 사이트를 MLS로 변환
v1.1 Content REST API를 완전히 지원하도록 사이트를 변환한 후에 MLS 사이트로 변경하여 언어 지원을 추가할 수 있습니다.
사이트 관리 UI에서 사이트를 선택하면 "번역 가능" 콘텐츠 메뉴 옵션이 표시됩니다. 이 옵션을 선택하면 지역화 정책의 필수 언어 목록에서 지역화 정책 및 사이트의 기본 언어를 선택하라는 대화상자가 표시됩니다. 지역화 정책이 없으면 이 단계를 완료할 수 없습니다. 먼저 콘텐츠 관리 화면으로 이동하여 하나 이상의 필수 언어로 지역화 정책을 생성해야 합니다.
이 단계를 완료하면 이제 사이트가 기본 로케일로 렌더링됩니다. 또한 지역화 정책에 지정된 다른 로케일로 전환할 수 있습니다.
사이트가 기본 로케일에서 예상대로 렌더링되는지 검증해야 합니다.
사이트와 연관된 자산은 사이트를 이전할 때 이전되지만, 사이트와 연관되지 않은 자산은 별도로 이전해야 합니다.
이전을 시작하기 전에 다음 사항을 고려하십시오.
자산을 이전하려면 다음 단계를 수행하십시오.
소스 및 대상 서버에 대한 접속 세부정보를 등록합니다.
소스 서버(자산 이전 출처가 될 서버)를 등록합니다.
> cec register-server <source_server_name> -e http://<source_server>:<source_port> -u <source_username> -p <source_password> -t pod_ic
대상 서버(자산 이전 대상이 될 서버)를 등록합니다.
> cec-install % cec register-server <target_server_name> -e http://<source_server>:<source_port> -u <target_username> -p <target_password> -t pod_ec
다음 명령을 실행하여 자산 모음을 이전합니다.
> cec migrate-content <source_collection_name> --server <source_server_name> --destination <target_server_name> --repository <target_repository_name> --collection <target_collection_name> --channel <target_channel_name>
대상 서버의 지정된 저장소에 자산이 생성되고 모음 및 채널과 연관됩니다. 필요한 경우 모음 및 채널이 자동으로 생성됩니다. 모든 이전된 자산의 기본 언어는 지정된 저장소에 설정된 기본 언어가 됩니다.