SAP Integration Suite에서 커스텀 어댑터 버전 관리를 하는 방법

https://community.sap.com/t5/technology-blogs-by-sap/integration-suite-versioning-a-custom-adapter/ba-p/13522588 사이트의 내용을 AI를 사용하여 번역 및 정리한 글임

SAP Integration Suite에서 커스텀 어댑터 버전 관리를 하는 방법에 대해 자세히 설명하겠습니다. 이는 커스텀 어댑터 개발자들이 어댑터의 버전을 관리하고 업데이트하는 데 유용한 정보를 제공합니다.

1. 커스텀 어댑터란?

커스텀 어댑터는 SAP Cloud Integration에서 다양한 시스템 간 데이터를 주고받기 위해 개발되는 소프트웨어 구성 요소입니다. 개발자는 SAP ADK(어댑터 개발 툴킷)를 사용해 이러한 어댑터를 제작할 수 있으며, 이 과정에서 Apache Camel, OSGi 등의 기술을 활용합니다.

2022년 1월 릴리즈부터는 버전 관리 기능이 추가되어, UI 변경 및 기능 확장에 맞춰 어댑터를 관리할 수 있습니다. 커스텀 어댑터의 버전 관리에서는 기존 통합 시나리오를 유지하면서 새 기능을 추가할 수 있도록 설계됩니다.

2. 버전 관리란?

버전 관리는 새로운 기능이나 UI 변경을 반영하면서도 기존 통합 시나리오가 영향을 받지 않도록 하는 것을 의미합니다. SAP Cloud Integration에서는 동시에 두 개의 어댑터를 배포할 수 없으므로, 새로운 UI 버전이 추가되면 기존 UI는 유지되고 새 통합 시나리오에서만 업데이트된 UI가 반영됩니다.

중요한 원칙은 런타임의 하위 호환성을 유지하는 것입니다. 즉, 새 기능이 추가되더라도 기존 시나리오에서 정상적으로 작동해야 합니다.

3. 버전 관리 규칙

버전 문자열은 보통 세 가지로 구분됩니다:

• 메이저 버전: 중요한 변경 사항이 있을 때 사용되지만, 현재는 지원되지 않음.
• 마이너 버전: 새 기능이 추가될 때 사용되며, 기존 시나리오에는 영향을 미치지 않습니다.
• 마이크로 버전: 툴팁, 라벨 등 UI에서의 작은 변경에 사용됩니다.

SAP Cloud Integration에서는 마이너 버전과 마이크로 버전의 증분만을 지원합니다. 각 버전 관리 규칙을 따를 때, 새 메타데이터 파일을 만들거나 기존 파일을 수정하여 변경 사항을 반영해야 합니다.

4. 커스텀 어댑터 버전 관리 실습

4.1 마이크로 버전 업데이트

작은 UI 변경 사항을 반영하기 위해 마이크로 버전을 업데이트할 수 있습니다. 예를 들어, 기존 'Greetings Message' 라벨을 'Greet Here'로 변경한다고 가정해보겠습니다.

• metadata.xml 파일 수정: 라벨을 'Greet Here'로 변경합니다.
• 버전 업데이트: 1.0.0에서 1.0.1로 업데이트합니다. 이 변경 사항은 component와 variant 레벨 모두에 적용되어야 합니다.
• config.adk 파일 수정: config.adk 파일에서도 마이크로 버전을 1.0.1로 업데이트합니다.

빌드 후 웹 UI에서 어댑터를 사용해보면, 기존 시나리오에 변경된 라벨이 반영됩니다.

4.2 마이너 버전 업데이트

새 기능을 추가할 경우, 마이너 버전 업데이트를 통해 관리합니다. 예를 들어, 새로운 필드인 'Formatter'를 추가하여 메시지를 포맷팅하는 기능을 구현한다고 가정해보겠습니다.

1. 새 메타데이터 파일 생성: metadata.xml 파일을 복사하여 metadataV1.xml로 새 파일을 생성합니다. 이 파일에는 새로운 기능에 맞춘 필드가 추가되며, 마이너 버전 1.1.0으로 업데이트됩니다.
2. Endpoint 클래스 수정: 새로운 'formatter' 필드를 추가합니다. 이를 사용자가 설정할 수 있도록 getFormatter와 setFormatter 메서드를 정의합니다.
3. Producer 클래스 수정: 사용자가 입력한 포맷팅 값을 메시지에 적용하도록 Producer 클래스에서 이를 반영합니다.

이후 새 버전을 빌드하고 배포하면, 기존 시나리오는 영향을 받지 않으며, 새로운 통합 시나리오에서만 'Formatter' 필드를 사용할 수 있습니다.

5. 결론

SAP Cloud Integration에서 커스텀 어댑터를 개발하고 관리할 때, 버전 관리는 필수적입니다. 마이크로 버전 업데이트는 작은 UI 변경에 적합하고, 마이너 버전 업데이트는 새로운 기능 추가 시 사용됩니다. 각 버전 관리의 핵심은 하위 호환성을 유지하면서 새로운 기능을 추가하는 것이며, 이를 통해 기존 통합 시나리오가 영향을 받지 않도록 해야 합니다.

SAP Integration Suite에서 이러한 버전 관리 방식을 활용하면, 어댑터의 기능을 유연하게 확장하고 효율적으로 관리할 수 있습니다.

이 내용을 블로그에 올리면 SAP Cloud Integration에서 어댑터 버전 관리에 대한 자세한 정보를 제공하는 좋은 자료가 될 것입니다.