1. 모바일 앱에 대한 CI/CD 파이프라인 생성
  2. CI/CD 파이프라인 구성 정보

CI/CD 파이프라인 구성 정보

먼저 API를 가져옵니다. 적어도 해당 끝점을 정의하고 OMC가 자동으로 생성하는 스캐폴드를 다운로드해야 합니다. 스캐폴은 사용자정의 API에 대한 코드를 미리 작성하고 테스트하기 전에 CI/CD 프로세스가 올바르게 작동하고 있는지 확인하는 데 사용할 수 있는 최소 애플리케이션을 나타냅니다.

API가 준비되고 Developer Cloud Service 프로젝트에서 Git 저장소 변경사항을 성공적으로 푸시할 수 있으면 프로젝트에 대해 CI/CD를 설정할 수 있습니다.

Oracle Mobile Hub에서 API 설정

앱에서 접속하는 REST 끝점을 정의하여 API 스캐폴드를 생성합니다. 스캐폴드를 완료한 후 API 코드에 대한 시작점으로 사용할 해당 정의를 다운로드할 수 있습니다.

끝점에 대한 HTTP 메소드를 정의할 때 샘플 응답을 추가할 수 있습니다. 나중에 실제 응답을 제공하는 코드를 작성하므로 엄격하게 말하면 샘플 응답은 필요하지 않습니다. 하지만 사용자정의 코드가 준비되기 전에 API를 테스트하기 위해 일부 샘플 응답을 입력할 수 있습니다.

  1. Oracle Mobile Hub에 로그인하고 탐색 패널을 엽니다.
  2. 탐색 패널의 [응용 프로그램 ] 섹션에서 Api 를 누릅니다.
  3. 새 API 를 누르고 열리는 메뉴에서 API 를 누릅니다.
    [새 API ] 창이 열립니다.
  4. API 표시 이름 필드 및 API 이름 필드에 API에 적합한 이름을 입력합니다.
  5. 간단한 설명 필드에 적절한 설명을 입력합니다.
  6. API에 대한 RAML 문서가 있는 경우 여기에 업로드합니다.
  7. 생성 을 누르면 새 API의 페이지가 열립니다.
  8. HTTP 리소스를 추가합니다. RAML 문서를 업로드한 경우 이 단계를 건너뛸 수 있습니다.
    1. 끝점 을 누른 다음 새 리소스 를 눌러 첫번째 끝점을 생성하고 해당 HTTP 메소드를 정의합니다.
    2. 모든 끝점이 정의될 때까지 API에 대한 끝점 및 HTTP 메소드를 계속 정의합니다.
  9. 저장 을 누릅니다.

백엔드 설정

API가 사용할 백엔드를 생성합니다. 백엔드는 앱에서 API로 요청을 라우팅하고 인증 서비스를 제공합니다.

  1. Oracle Mobile Hub 탐색 패널에서 백엔드 를 누르면 백엔드 페이지가 열립니다.
  2. 새 백엔드 를 누르고 창에서 이름 필드에 적합한 이름을 입력한 다음 생성 을 누릅니다.
    백엔드 구성 페이지가 열립니다. 여기에는 설정 페이지에서 열리는 고유한 탐색 패널이 있습니다.
  3. 구성 페이지의 탐색 패널에서 API 를 누르고 열리는 페이지에서 API 선택 을 눌러 API 카탈로그를 엽니다.
  4. 카탈로그에서 생성한 API에 대한 카드를 찾고 해당 + 단추를 누릅니다. 이 백엔드와 API가 연관됩니다.

레코드 백엔드 및 인스턴스 세부정보

개발 툴을 구성할 때 필요한 정보를 기록하십시오.

이 정보는 toolsConfig.json 라는 파일에 사용되며 인증에는 필수입니다. 스크립트를 사용하여 Oracle Mobile Hub에 연결하고 코드 아티팩트를 전달할 수 있습니다.

  1. Oracle Mobile Hub 탐색 패널에서 백엔드 를 누르면 백엔드 페이지가 열립니다.
  2. 백엔드를 선택하고 열기 를 누릅니다.
  3. 탐색 패널에서 설정 을 누릅니다.
  4. 다음 정보를 기록하고 나중에 쉽게 검색할 수 있는 텍스트 파일 또는 다른 장소에 복사합니다.
    • 클라이언트 ID
    • 클라이언트 암호
    • 백엔드 ID
    • 백엔드 이름
    • 백엔드 버전
    • 익명 키
  5. 탐색 패널에서 개발 을 눌러 기본 페이지를 연 다음 인스턴스 세부 정보 를 눌러 [인스턴스 세부 정보 ] 패널을 엽니다.
  6. 다음 정보를 기록하고 이전 단계에서 기록한 백엔드 정보와 함께 유지합니다.
    • 팀 구성원 앱 클라이언트 ID
    • 팀 구성원 앱 클라이언트 암호

Oracle Developer Cloud Service 에서 프로젝트 설정

Git 저장소를 포함하는 프로젝트를 생성합니다. 나중에 저장소에 커밋을 푸시할 때마다 빌드를 실행하도록 프로젝트를 구성합니다.

프로젝트 생성

Git 저장소를 포함하는 프로젝트를 생성합니다.

  1. Oracle Developer Cloud Service 콘솔에 로그인하고 새 프로젝트 를 누릅니다.
  2. 프로젝트 세부정보 페이지에서 프로젝트 이름을 입력하고 다음 을 누릅니다.
  3. 템플리트 페이지에서 초기 저장소 를 선택하고 다음 을 누릅니다.
  4. 프로젝트 속성 페이지에서 기본값을 그대로 적용하고 완료 를 눌러 프로비전 프로세스를 시작합니다.

프로젝트가 규정된 후 화면이 다음 이미지와 유사해야 합니다.


프로젝트 요약 페이지

Git 저장소 복제 및 구성

저장소를 로컬 개발 시스템에 복제합니다.

  1. Oracle Developer Cloud Service 에 로그인하고 프로젝트 페이지로 이동합니다.
  2. Git에 대한 저장소의 필드에서 HTTP 주소를 복사합니다.
  3. 터미널 창 (Linux 또는 Mac) 또는 Git Bash 터미널 (Windows) 을 열고 하드 드라이브의 편리한 위치에 새 디렉토리를 생성합니다. 프로젝트에 적합한 디렉토리의 이름을 사용합니다.
     mkdir <your-directory-name>
  4. 디렉토리를 변경하고 저장소를 복제하여 샘플의 저장소 주소를 사용자 자신만으로 바꿉니다.
    cd <your-directory-name>
git clone <your-repo-url>

    비밀번호를 묻는 메시지가 표시되면 Oracle Developer Cloud Service 에 로그인할 때 사용하는 비밀번호를 사용합니다.

  5. 복제 프로세스에 의해 생성된 디렉토리로 변경합니다.
    cd <your-directory-name>
  6. 이 프로젝트에 대한 이름 및 전자 메일 주소를 설정하고, 인증서를 저장하도록 Git을 구성합니다.
    git config user.name "<your-name>"
git config user.email "<your-email-address>"
git config credential.helper store

새 빌드 작업 생성

프로젝트의 Git 저장소에 코드를 푸시할 때마다 실행되는 작업을 생성합니다.

  1. Oracle Developer Cloud Service 에 로그인하고 프로젝트 페이지로 이동합니다.
  2. 탐색 패널에서 작성 을 누르고 열리는 페이지에서 새 작업 을 누릅니다.
  3. 이름을 입력하고 소프트웨어 템플리트를 선택한 다음 작업 생성 을 누릅니다.
  4. 소스 제어 추가 를 누르고 Git 를 선택합니다.
  5. 저장소 드롭다운에서 사용할 Git 저장소를 선택합니다.
  6. 선택 사항: 저장소에 코드를 푸시하는 유일한 개발자인 경우 SCM 커밋에서 자동으로 빌드 수행 을 선택합니다.

    프로젝트에 여러 사람이 작업하고 코드를 저장소에 푸시하는 경우 이 옵션을 선택하지 마십시오. 대신 SCM 폴링 트리거를 설정할 수 있습니다. 이 트리거는 빌드 작업 생성을 완료한 후 수행할 수 있습니다.

  7. 저장 을 누릅니다.

SCM 폴링 트리거 구성

정의한 일정에 따라 Git 저장소의 변경사항을 검사하는 폴링을 설정할 수 있습니다. 변경 사항이 감지되면 빌드가 시작됩니다.

코드를 저장소에 푸시하는 유일한 개발자인 경우 즉시 빌드가 적합합니다. 그러나 여러 사람이 코드를 푸시할 때 빌드를 시작하기 전에 주기적으로 저장소 변경 사항을 확인하는 폴링 트리거를 설정할 수 있습니다.

SCM 폴링 트리거를 설정하려면 crontab 형식을 사용하여 폴링 일정을 설정합니다. Crontab 형식에 익숙하지 않은 경우 그래픽 인터페이스를 사용하여 일정을 생성할 수 있습니다.

기본 일정은 30분마다 0/30 * * * * 로 표시됩니다. 매 시간 30분 후 실행하도록 일정을 설정하려면 30 * * * * 를 사용합니다.

  1. Oracle Developer Cloud Service 콘솔에 로그인하고 프로젝트를 엽니다.
  2. 탐색 패널에서 작성 을 누르고 매개변수를 설정할 빌드를 선택합니다.
    [빌드 설정 ] 페이지가 열립니다.
  3. 구성.을 누릅니다
    [작업 구성 ] 페이지가 열립니다.
  4. 기어 아이콘 설정 아이콘은 기어 쌍처럼 보입니다. 을 누른 다음 트리거 를 눌러 빌드 트리거 구성 패널을 엽니다.
  5. [트리거 추가 ] 드롭다운을 누르고 SCM 폴링 트리거 를 선택합니다.
  6. 일정을 설정하고 저장 을 누릅니다.

빌드 매개변수 설정

Oracle Mobile Hub 계정에 대한 사용자 이름과 비밀번호를 보유하도록 문자열 매개변수 및 비밀번호 매개변수를 설정합니다.

이러한 매개변수는 나중에 개발자 툴을 구성할 때 필요하므로 추적해야 합니다.

  1. Oracle Developer Cloud Service 콘솔에 로그인하고 프로젝트를 엽니다.
  2. 탐색 패널에서 작성 을 누르고 매개변수를 설정할 빌드를 선택합니다.
    [빌드 설정 ] 페이지가 열립니다.
  3. 구성을 누릅니다.
    [작업 구성 ] 페이지가 열립니다.
  4. 매개변수 빌드 탭을 누릅니다.
  5. 빌드 매개변수 추가 드롭다운을 누르고 문자열 매개변수 를 선택합니다.
  6. 사용자 이름 매개변수의 이름을 입력합니다. 예: devUser.
  7. 기본값 필드에 Oracle Mobile Hub 사용자 이름을 입력합니다. 예: samir.developer@example.com.
  8. 빌드 매개변수 추가 드롭다운을 누르고 비밀번호 매개변수 를 선택합니다.
  9. 비밀번호 매개변수 (예: devPassword) 의 이름을 입력합니다.
  10. 기본값 필드에 Oracle Mobile Hub 사용자 이름에 대한 비밀번호를 입력합니다.
  11. 저장 을 누릅니다.

Unix 셸 빌더 구성

셸 빌더는 빌드가 트리거될 때마다 빌드 시스템에서 실행되는 Bash 스크립트입니다. 종속성을 설치한 다음 Oracle Mobile Hub에 코드를 제공합니다.

이 스크립트는 Oracle Developer Cloud Service 에서 프로젝트를 생성할 때 설정한 Git 저장소에서 소스에 대해 실행됩니다. 스크립트가 특정 시점에 실패하면 오류와 함께 종료되고 코드가 배치되지 않습니다.

  1. Oracle Developer Cloud Service 콘솔에 로그인하고 프로젝트를 엽니다.
  2. 탐색 패널에서 작성 을 누르고 매개변수를 설정할 빌드를 선택합니다.
    [빌드 설정 ] 페이지가 열립니다.
  3. 구성을 누릅니다.
    [작업 구성 ] 페이지가 열립니다.
  4. 작성자 탭을 누릅니다.
  5. 빌더 추가 드롭다운을 누르고 Unix 쉘 빌더 를 선택합니다.
  6. 스크립트 필드에 다음 스크립트를 입력합니다.
    export NODE_PATH=node-configurations/8.9/node_modules
npm install
cd omce-tools
npm install
cd node-configurations/8.9
npm install
cd ../..
node omce-deploy ../toolsConfig.json -u $devUser -p $devPassword
  7. 저장 을 누릅니다.

JavaScript 스캐폴드 다운로드

API skeleton을 생성한 후 시스템은 zip 파일로 다운로드할 수 있는 API 코드에 대한 스캐폴드를 생성합니다.

스캐폴드에는 API 구현에 대한 초기 구조 및 파일이 포함되며, 이를 사용자정의 시작점으로 사용할 수 있습니다. 파일을 추출하여 작업 디렉토리에 배치해야 합니다.

  1. Oracle Mobile Hub에서 스캐폴드를 사용할 API를 엽니다.
  2. API 탐색 패널에서 구현 을 누릅니다.
  3. 스캐폴드 파일을 컴퓨터에 다운로드하는 JavaScript 스캐폴드를 누릅니다.
  4. API에 대한 package.json, toolsConfig.json 및 .js 파일을 작업 디렉토리에 추출합니다. Git 저장소를 복제할 때 생성된 것과 동일한 디렉토리이며 .git 디렉토리를 포함합니다.

개발 툴 설치 및 구성

Oracle 은 명령행에서 사용자 정의 API 구현을 Oracle Mobile Hub로 업로드하는 툴을 제공합니다. Oracle Developer Cloud Service 에서 빌드 스크립트에 사용할 수 있도록 Git 저장소에 툴을 추가합니다.

툴은 개발 시스템에서 사용자 정의 API 구현 테스트 및 디버깅에 사용할 수 있는 Oracle Mobile Hub API도 포함되어 있는 다운로드의 일부입니다. CI/CD 파이프라인을 사용하려면 API가 필요하지 않습니다. OracleMobileAPI 라고 하는 API 사용에 대한 지침은 omce-tools 디렉토리 내의 readme를 참조하십시오.

툴은 Node.js 버전 6.10.0 및 8.9.x를 지원합니다. 이 절차에서는 버전 8.9.4 이상을 사용하는 것으로 가정합니다.

툴을 설치하고 구성하려면 다음과 같이 하십시오.

  1. https://www.oracle.com/technetwork/topics/cloud/downloads/amce-downloads-4478270.html 으로 이동하여 사용자 정의 코드 테스트 툴 버전 18.3.1 이상을 다운로드합니다. 이 페이지의 파일 이름은 레거시 제품 이름을 따르지만 포함된 코드는 최신 릴리스에서 최신 상태가 됩니다. 마찬가지로 다운로드 내 툴의 이름에도 마찬가지입니다.
  2. 다운로드한 파일을 열고 omce-tools/omce-tools 디렉토리의 콘텐츠를 작업 디렉토리, 즉 .git 디렉토리가 포함된 디렉토리로 추출합니다. 예를 들어, 작업 디렉토리가 test-project 이면 omce-tools/omce-tools 의 콘텐츠를 test-project/omce-tools 로 추출합니다.
  3. 노드 구성 설치: omce-tools/node-configurations/8.9 디렉토리로 변경하고 npm install 를 실행합니다.
  4. 시스템에 omce-tools 설치: omce-tools 디렉토리로 변경하고 npm install -g 를 실행합니다.
  5. NODE_PATH 이라는 환경 변수를 생성하고 node-configurations/8.9/node_modules 로 설정합니다.
  6. 툴이 올바르게 설치되었는지 확인하십시오. omce-tools 디렉토리에서 node omce-test --version 를 실행합니다. 결과는 18.3.1이어야합니다..
  7. toolsConfig.json 을 업데이트합니다. 스캐폴드를 다운로드한 경우 toolsConfig.json 구성 파일이 포함됩니다. 백엔드에서 기록한 정보를 사용하여 toolsConfig.json 의 위치 표시자 텍스트를 바꿉니다.