Java에서 다음 Cumulocity 마이크로서비스 프로젝트를 시작하세요.

소개

Microservice SDK 프로젝트를 사용하여 Cumulocity용 마이크로서비스를 설정하는 것은 쉽습니다.

그러나 Cumulocity 인스턴스에 로컬로 구성된 마이크로 서비스를 성공적으로 실행하기 전에 몇 가지 수동 단계를 수행해야 합니다. 이 프로세스의 속도를 높이려면 maven 원형을 대신 사용하십시오. cumulocity-microservice-archetype

이 오픈 소스 maven 원형은 5분 이내에 maven 프로젝트를 설정하는 데 도움이 됩니다!!!

단순히 빠르기만 한 것이 아닙니다. 모범 사례를 기반으로 하는 좋은 템플릿이기도 합니다.

이 블로그 게시물에서는 이 cumulocity-microservice-archetype을 사용하여 첫 번째 프로젝트 "hello"를 설정하는 방법을 단계별로 보여줍니다.

전제 조건

Java 설치 >= 11

Maven 설치 >= 3.6

Cumulocity IoT 테넌트 >= 1010.0.0

Cumulocity IoT 사용자 자격 증명(Base64 인코딩)

따라야 할 단계

1단계: GitHub - SoftwareAG/cumulocity-microservice-archetype: Maven archetype for cumulocity microservice. Developed by Global Competency Center IoT으로 이동하여 리포지토리 복제

2단계: 로컬 maven 리포지토리에 cumulocity-microservice-archetype 빌드 및 설치

$ cd cumulocity-microservice-archetype
$ mvn install

3단계: 원형을 사용하여 프로젝트 생성

mvn archetyp:generate 명령을 실행하기 전에 다음을 알아야 합니다.

마이크로서비스 이름

Cumulocity 개발 환경 URL:

Base64의 Cumulocity 개발 환경 사용자 자격 증명

개발자 도구, 네트워크 탭을 통해 수집할 수 있는 Base64 사용자 자격 증명. 요청 헤더에는 Authorization 옵션이 포함되어 있습니다.

모든 매개변수가 있는 경우 다음 스크립트를 실행할 수 있습니다(Basic XXXXX를 Base64 자격 증명으로 대체).

$ mvn archetype:generate -DarchetypeGroupId=cumulocity.microservice -DarchetypeArtifactId=cumulocity-microservice-archetype -DinteractiveMode=false -DmicroserviceName=hello -DdevC8yBaseURL=https://ms-template.eu-latest.cumulocity.com -DdevC8yUserCredentialsBASE64="Basic XXXXX"`

대화식 모드를 실행하면 각 매개변수에 대해 입력 프롬프트가 표시됩니다. 자세한 내용은 GitHub - SoftwareAG/cumulocity-microservice-archetype: Maven archetype for cumulocity microservice. Developed by Global Competency Center IoT을 참조하십시오.

maven이 "BUILD SUCCESS"라고 말하면 4단계를 계속 진행할 수 있습니다.

4단계: 처음으로 새로 생성된 마이크로서비스 실행

$ cd cumulocity-microservice-hello
$ mvn clean install
$ cd target
$ java -jar cumulocity-microservice-hello-1.0.0-SNAPSHOT.jar

5단계: 브라우저를 열어 마이크로서비스가 성공적으로 실행되고 있는지 확인합니다.
http://localhost:8080/api/hello/devices
브라우저에서 사용자/암호 대화 상자가 열립니다. {tenant}/{user name} 방식으로 사용자를 삽입합니다.

이 REST 끝점이 모든 장치의 배열을 반환하는 경우. 훌륭합니다. 이미 마이크로서비스 프로젝트를 성공적으로 설정했습니다!!

6단계: 추가 개발 및 몇 가지 좋은 예 사용

이제 고유한 기능 개발을 시작할 수 있습니다. 프로젝트에는 간단한 컨트롤러와 서비스가 포함되어 있습니다. 이러한 클래스는 제거되어야 하며 컨트롤러 및 서비스에 대한 자리 표시자입니다.

특별한 비기능적 요구 사항이 있는 경우 microservice templates 을 확인하십시오. 여기에는 일반적인 문제를 해결하는 방법에 대한 좋은 예가 포함되어 있습니다.

유용한 링크 | 관련 리소스

https://cumulocity.com/guides/microservice-sdk/java/
https://github.com/SoftwareAG/cumulocity-microservice-archetype
https://github.com/SoftwareAG/cumulocity-microservice-templates
https://maven.apache.org/guides/introduction/introduction-to-archetypes.html

Visit the original post