Spring Batch를 활용하여 오라클 클라우드 가상머신 (인스턴스) 자동 생성 스케쥴러를 만들어보자!

개요

퍼블릭 클라우드에서 제공하는 프리티어 혜택이 가장 큰 곳은 Oracle Cloud 입니다!

 

다만, 프리티어 혜택이 좋은 만큼 해당 리전에 대한 가용량이 꽉 차면 인스턴스 생성이 되지 않습니다.

 

언제 가용량이 확보될 지도 모르기 때문에 인스턴스를 자동으로 생성하는 스케쥴러를 개발하였고 이를 공유하고자 포스트를 작성하게 되었습니다.

 

이미 클리앙의 theb1ue 님이 php로 만든 자동 스크립트가 있기 때문에 php에 익숙하신 분은 아래 링크를 참고해주세요!
https://svrforum.com/cloud/319909

 

---

개발 환경

• Spring Boot 2.7.15
• Spring Batch
• JDK 11
• IntelliJ Ulimate
• FileZilla
• Putty, Mobaxterm

👉  Spring Boot 3 버전이 아닌 2 버전으로 진행하였습니다.

 

👉  이는 Oracle Cloud SDK 라이브러리에서 사용하는 일부 의존성 라이브러리들이 javax 패키지를 사용하기 때문입니다.

 

---

API Key 추가 및 Key 다운로드

👉  오라클 클라우드 접속하여 로그인한 다음 우상단의 프로필 이미지 클릭 후 내 프로파일 메뉴로 들어가주세요!

 

https://www.oracle.com/kr/cloud/

 

 

👉  좌하단의 API 키 메뉴를 누른 다음 API 키 추가 버튼을 클릭해주세요.

 

👉  다음으로 프라이빗 키 및 퍼블릭 키 모두 다운로드한 다음 추가 버튼을 눌러주세요!

 

Private 키는 API 호출에 필요한 인증 키로 사용되기 때문에 유실되지 않도록 유의해야 합니다!

 

 

👉  추가 버튼을 누르게 되면 다음과 같은 창이 뜨게 됩니다.

 

👉  해당 내용을 모두 복사하여 메모장 or 노트패드에 붙여넣기 해줍니다!

 

---

API 호출에 필요한 파라미터 추출

인스턴스를 생성하는 API를 호출하기 위해서는 해당 인스턴스의 이미지, 서브넷 등의 파라미터가 필요합니다!

 

따라서, F12 개발자 도구를 활용하여 오라클 클라우드에서 인스턴스 생성 버튼을 눌러 API 요청이 어떠한 형태로 나가는 지 확인해봅시다!

 

 

 

👉  SSH 키 추가에서 "공용 키 저장"은 추후 API 호출에서 사용하므로 꼭 저장해주세요.

 

 

👉  여기까지 모두 설정하였다면 F12 개발자 도구를 열고 생성 버튼을 눌러주세요! 

 

 

👉  위 그림처럼 빨간색 instances 항목에서 우클릭 후 Copy as cuRL (bash) 버튼을 눌러줍니다!

 

curl 'https://iaas.ap-singapore-1.oraclecloud.com/20160918/instances/' \
  -H 'Accept: */*' \
  -H 'Connection: keep-alive' \
  -H 'Content-Type: application/json' \
  -H 'Origin: https://cloud.oracle.com' \
  -H 'Referer: https://cloud.oracle.com/' \
  -H 'Sec-Fetch-Dest: empty' \
  -H 'Sec-Fetch-Mode: cors' \
  -H 'Sec-Fetch-Site: cross-site' \
  -H 'User-Agent: xxxxxx' \
  -H 'accept-language: ko' \
  -H 'authorization: Signature keyId="xxxxxxxxxxxxxxxxxx"' \
  -H 'opc-request-id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'sec-ch-ua: "Google Chrome";v="125", "Chromium";v="125", "Not.A/Brand";v="24"' \
  -H 'sec-ch-ua-mobile: ?0' \
  -H 'sec-ch-ua-platform: "Windows"' \
  -H 'x-content-sha256: /xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'x-date: Tue, 18 Jun 2024 17:17:43 GMT' \
  --data-raw 
  {
  "metadata": {
    "ssh_authorized_keys": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  },
  "shape": "VM.Standard.A1.Flex",
  "compartmentId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "displayName": "SRV1",
  "availabilityDomain": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "sourceDetails": {
    "sourceType": "image",
    "imageId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "bootVolumeSizeInGBs": 50,
    "bootVolumeVpusPerGB": 10
  },
  "isPvEncryptionInTransitEnabled": true,
  "createVnicDetails": {
    "assignPublicIp": true,
    "subnetId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "assignPrivateDnsRecord": true,
    "assignIpv6Ip": false
  },
  "agentConfig": {
    "pluginsConfig": [
      { "name": "Vulnerability Scanning", "desiredState": "DISABLED" },
      { "name": "Oracle Java Management Service", "desiredState": "DISABLED" },
      { "name": "OS Management Service Agent", "desiredState": "DISABLED" },
      { "name": "OS Management Hub Agent", "desiredState": "DISABLED" },
      { "name": "Management Agent", "desiredState": "DISABLED" },
      { "name": "Custom Logs Monitoring", "desiredState": "ENABLED" },
      { "name": "Compute RDMA GPU Monitoring", "desiredState": "DISABLED" },
      { "name": "Compute Instance Run Command", "desiredState": "ENABLED" },
      { "name": "Compute Instance Monitoring", "desiredState": "ENABLED" },
      { "name": "Compute HPC RDMA Auto-Configuration", "desiredState": "DISABLED" },
      { "name": "Compute HPC RDMA Authentication", "desiredState": "DISABLED" },
      { "name": "Cloud Guard Workload Protection", "desiredState": "ENABLED" },
      { "name": "Block Volume Management", "desiredState": "DISABLED" },
      { "name": "Bastion", "desiredState": "DISABLED" }
    ],
    "isMonitoringDisabled": false,
    "isManagementDisabled": false
  },
  "definedTags": {},
  "freeformTags": {},
  "instanceOptions": {
    "areLegacyImdsEndpointsDisabled": false
  },
  "availabilityConfig": {
    "recoveryAction": "RESTORE_INSTANCE"
  },
  "shapeConfig": {
    "ocpus": 4,
    "memoryInGBs": 24
  }
}

 

👉  붙여넣기 하게 되면 위와 같은 내용이 보일텐데 여기서 필요한 파라미터만을 추출해야 합니다!

 

👉  imageId, compartmentId, subnetId, availabilityDomain 이 4가지 파라미터의 값을 뽑아서 메모장에 복사해주세요!

 

---

GitHub 프로젝트 Clone

아래 URL로 들어가 프로젝트를 Clone 해주세요!

 

https://github.com/dev-toyproject/oracle-cloud-auto-create-vm

 

---

Application.yml 수정

 

oracle:
  cloud:
    apiKey:
      profile: DEFAULT
      user: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
      fingerprint: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
      tenancy: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
      region: ap-singapore-1
      privKey:
        path: /root/test123@gmail.com_2024-05-24T13_12_12.293Z.pem
      pubKey:
        path: /root/ssh-key-2024-05-24.key.pub

    instance:
      x86:
        # x86 인스턴스 생성하지 않음      --> displayName : null
        # x86 인스턴스 1개 생성          --> displayName : srv1
        # x86 인스턴스 2개 생성          --> displayName : srv1,srv2     (콤마로 구분)
        displayName: null
        imageId: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
        shape: VM.Standard.E2.1.Micro
        volume: 50
        availabilityDomain: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
        compartmentId: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
        subnetId: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

      arm:
        # arm 인스턴스 생성하지 않음      --> displayName : null
        # arm 인스턴스 1개 생성          --> displayName : srv1
        # arm 인스턴스 2개 생성          --> displayName : srv1,srv2     (콤마로 구분)
        # 추가적으로 arm 인스턴스는 1개 생성할 때는 vcpu: 4, memory: 24, volume: 100 (프리티어 최대 한도) 로 변경해주세요.
        displayName: srv3,srv4
        imageId: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
        shape: VM.Standard.A1.Flex
        vcpu: 2
        memory: 12
        volume: 50
        availabilityDomain: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
        compartmentId: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
        subnetId: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

 

👉  oracle.cloud.apiKey 하위 항목들 중 user, fingerprint, tenancy 항목은 "API 키 추가 및 Key 다운로드" 부분에서 복사해뒀던 값으로 바꿔줍니다!

 

👉  oracle.cloud.apiKey.privKey.path 항목은 "API 키 추가 및 Key 다운로드" 부분에서 저장했던 Private Key 파일의 절대 경로를 입력해주세요!

 

👉  oracle.cloud.apiKey.pubKey.path 항목은 인스턴스 생성할 때 SSH 키 추가 부분에서 저장했던 공용 키 파일의 절대 경로를 입력해주세요!

 

👉  oracle.cloud.instance 하위 항목들 중 imageId, subnetId, .. 등은 "API 호출에 필요한 파라미터 부분"에서 추출했던 값들로 바꿔줍니다!

 

👉  oracle.cloud.instance.x86 or arm.displayName 항목 값이 "null" 문자열이면 생성하지 않고 예시는 주석에 달아놨으니 참고해주세요!

 

x86 인스턴스의 경우에 vcpu, memory 값을 설정하지 않은 이유는 프리티어 인스턴스는 vcpu, memory가 고정되어 있기 때문입니다.

 

---

프로젝트 빌드 및 배포

프로젝트 빌드하기에 앞서, 배포하고자 하는 서버에 미리 PrivKey, PubKey를 업로드한 다음 해당 Key 파일들의 절대 경로를 복사한 다음 꼭 application.yml에 반영해주어야 합니다!!

 

또한, 헷갈릴 소지가 있어 말씀드리지만 PrivKey는 "API 키 추가 및 다운로드" 부분에서 다운로드 했던 프라이빗 키이고 PubKey는 인스턴스 생성할 때, 다운로드 했던 공용 키 입니다!

 

"API 키 추가 및 다운로드" 부분에서 다운로드 했던 퍼블릭 키가 아닙니다!!

 

# [로컬] 프로젝트 빌드
./gradlew build -x test

# [서버] 패키지 설치
dnf install -y java-11-openjdk

# [서버] 배포
nohup java -jar oci-vm-0.0.1-SNAPSHOT.jar

 

👉  콘솔 로그는 별도의 로깅 파일로 생성되며 날짜별로 분리되도록 설정해놓았습니다!

 

---

 

추가적으로 궁금하신 사항이나 잘못된 부분이 있다면 댓글로 남겨주시면 감사하겠습니다!