[개발 환경]

서버: Spring Boot 3.2.4

프론트: Vite + React + TypeScript

<MyController.java>

import jakarta.servlet.http.HttpServletRequest;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class MyController {

    @RequestMapping(value = "/gnbmenu")
    public String gnbMenu(@RequestBody Object request) {
        String str = "{\"message\" : \"메뉴 요청 url.\"}";
        return str;
    }

}

<MyFront.tsx>

import { useEffect } from "react";

function MyFront() {
  const dataToSend = {
    key1: "value1",
    key2: "value2",
  };
  useEffect(() => {
    fetch("/api/gnbmenu", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(dataToSend),
    }).then((response) => console.log(response.json()));
  }, []);

  return <></>;
export default MyFront;

<Server Console>

2024-04-18T20:10:29.643+09:00 ERROR 26416 --- [****] [nio-8080-exec-2] o.a.c.c.C.[.[.[/].[dispatcherServlet]    : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed: org.thymeleaf.exceptions.TemplateInputException: Error resolving template [{"message" : "메뉴 요청 url."}], template might not exist or might not be accessible by any of the configured Template Resolvers] with root cause

org.thymeleaf.exceptions.TemplateInputException: Error resolving template [{"message" : "메뉴 요청 url."}], template might not exist or might not be accessible by any of the configured Template Resolvers
	at org.thymeleaf.engine.TemplateManager.resolveTemplate(TemplateManager.java:869) ~[thymeleaf-3.1.2.RELEASE.jar:3.1.2.RELEASE]
	at org.thymeleaf.engine.TemplateManager.parseAndProcess(TemplateManager.java:607) ~[thymeleaf-3.1.2.RELEASE.jar:3.1.2.RELEASE]
	at org.thymeleaf.TemplateEngine.process(TemplateEngine.java:1103) ~[thymeleaf-3.1.2.RELEASE.jar:3.1.2.RELEASE]
	at org.thymeleaf.TemplateEngine.process(TemplateEngine.java:1077) ~[thymeleaf-3.1.2.RELEASE.jar:3.1.2.RELEASE]
	at org.thymeleaf.spring6.view.ThymeleafView.renderFragment(ThymeleafView.java:372) ~[thymeleaf-spring6-3.1.2.RELEASE.jar:3.1.2.RELEASE]
	at org.thymeleaf.spring6.view.ThymeleafView.render(ThymeleafView.java:192) ~[thymeleaf-spring6-3.1.2.RELEASE.jar:3.1.2.RELEASE]
	at org.springframework.web.servlet.DispatcherServlet.render(DispatcherServlet.java:1431) ~[spring-webmvc-6.1.5.jar:6.1.5]
	at org.springframework.web.servlet.DispatcherServlet.processDispatchResult(DispatcherServlet.java:1167) ~[spring-webmvc-6.1.5.jar:6.1.5]
	at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:1106) ~[spring-webmvc-6.1.5.jar:6.1.5]
	at org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:979) ~[spring-webmvc-6.1.5.jar:6.1.5]
	at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:1014) ~[spring-webmvc-6.1.5.jar:6.1.5]
	at org.springframework.web.servlet.FrameworkServlet.doPost(FrameworkServlet.java:914) ~[spring-webmvc-6.1.5.jar:6.1.5]
	at jakarta.servlet.http.HttpServlet.service(HttpServlet.java:590) ~[tomcat-embed-core-10.1.19.jar:6.0]
	at org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:885) ~[spring-webmvc-6.1.5.jar:6.1.5]
	at jakarta.servlet.http.HttpServlet.service(HttpServlet.java:658) ~[tomcat-embed-core-10.1.19.jar:6.0]
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:205) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:149) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:51) ~[tomcat-embed-websocket-10.1.19.jar:10.1.19]
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:174) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:149) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.springframework.web.filter.RequestContextFilter.doFilterInternal(RequestContextFilter.java:100) ~[spring-web-6.1.5.jar:6.1.5]
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:116) ~[spring-web-6.1.5.jar:6.1.5]
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:174) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:149) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.springframework.web.filter.FormContentFilter.doFilterInternal(FormContentFilter.java:93) ~[spring-web-6.1.5.jar:6.1.5]
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:116) ~[spring-web-6.1.5.jar:6.1.5]
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:174) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:149) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.springframework.web.filter.CharacterEncodingFilter.doFilterInternal(CharacterEncodingFilter.java:201) ~[spring-web-6.1.5.jar:6.1.5]
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:116) ~[spring-web-6.1.5.jar:6.1.5]
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:174) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:149) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:167) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:90) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:482) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:115) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:93) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:74) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:344) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.coyote.http11.Http11Processor.service(Http11Processor.java:391) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.coyote.AbstractProcessorLight.process(AbstractProcessorLight.java:63) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.coyote.AbstractProtocol$ConnectionHandler.process(AbstractProtocol.java:896) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1744) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.tomcat.util.net.SocketProcessorBase.run(SocketProcessorBase.java:52) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.tomcat.util.threads.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1191) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.tomcat.util.threads.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:659) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:63) ~[tomcat-embed-core-10.1.19.jar:10.1.19]
	at java.base/java.lang.Thread.run(Thread.java:842) ~[na:na]

<Client console>

MyFront.tsx:36 
 POST http://localhost:5173/api/gnbmenu 500 (Internal Server Error)
(anonymous)	@	MyFront.tsx:36
Show 10 more frames

[예상 문제 1]

경로 설정 문제?

"/abc"로 시작하는 경로에서 "/"을 제거하고 "abc"형태로 수정 ☞ AWS나 배포 환경에서 발생하는 문제로 해당 문제가 아님

[문제 2]

Controller Annotaion 종류의 문제

@Controller는 반환값으로 view를 찾음. view가 아닌 json형태를 반환하기 때문에 @RestController로 설정 ☞ 해결

package com.study.controller;

import org.apach.commons.io.FileUtils;
import org.springFamework.http.HttpHeaders;
import org.springFamework.http.HttpStatus;
import org.springFamework.http.MediaType;
import org.springFamework.http.ResponseEntity;


@Controller
public class AttachFileController {

	@RequestMapping("/pdfView")
    public ResponseEntity<byte[]> pdfView(HttpServletRequest request, HttpServletResponse) throws Exception{
    	request.setCharacterEncoding("utf-8");
        String fileId = new String(request.getParameter("fileId".getBytes("8859_1", "KSC5601");
        // fileId 없는 경우 예외처리
        // fileId에 해당하는 파일 없는 경우 예외처리
              
        String filePath = ${FILES_ROOT_PATH} + fileId;
        String tempFile = new File(filePath);
        byte[] pdfBytes;
        
        try {
        	pdfBytes = org.apache.commons.io.FileUtils.readFileToByteArray(tempFile);
        } catch (Exception e){
        	e.printStackTrace();
            String error = "<script tye='text/javascript'> alert('File Not Found');</script>";
            byte[] arrorBytes = error.getBytes(StandardCharsets.UTF_8);
            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(errorBytes);
            }
            
        HttpHeaders = headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_PDF);
        headers.setContentDispositionFormData("filename", "example.pdf");
        headers.setContentLength(pdfBytes.length);
        //파일이 다운로드 되지 않고 브라우저 내에 보이도록 함
        headers.set("Content-Disposition", "inline; filename=example.pdf"
        
        return new ResponseEntity<>(pdfBytes, headers, HttpStatus.OK);
    }

}

Oracle DataBase가 정상적으로 설치되었고 실행까지 확인 했다.

이제 프로젝트에 연동 할 테이블 스페이스, 사용자를 생성하고 연동하면 된다.

1. 테이블 스페이스와 사용자 생성

2. SQL Developer로 접속 확인

3. 프로젝트 내에 설정 변경

1. 테이블 스페이스와 사용자 생성

더보기

1. (root 권한으로 변경 후) 테이블 스페이스 데이터를 보관할 디렉토리 생성 ex) /home/oracle/data

# mkdir /home/oracle/data

2. 디렉토리의 권한 변경

#sudo chmod 777 /home/oracle/data

3. 오라클 데이터베이스 실행

# sqlplus

 4. 관리자로 로그인 (user-name : sys as sysdba | 비밀번호는 설정 적용 시 입력했던 비밀번호 ex. 12345)

Enter user-name: sys as sysdba
Enter password: 12345

4. 테이블 스페이스 생성 ex

SQL> create tablespace test datafile '/home/oracle/data/test.dbf' size 500m autoextend on next 100m maxsize unlimited default storage(initial 128k next 64k pctincrease 10);

 5. 세션 모드 변경

SQL> alter session set "_ORACLE_SCRIPT" = true;

6. 사용자 생성 및 테이블 스페이스 지정

SQL> create user testuser identified by "12345" default tablespace test temporary tablespace temp;

7. 사용자에게 권한 부여

SQL> grant resource, connect, dba to testuser;

---

2. SQL Developer로 접속 확인

더보기

 1. SQL Developer실행 후 수동으로 접속 생성 선택

2. 접속 정보 입력

- Name : 접속을 식별할 수 있는 이름

- 사용자 이름, 비밀번호  : OracleDatabase에서 생성했던 사용자 이름(ex.testuser)과 비밀번호(12345)

SQL> create user testuser identified by "12345" default tablespace test temporary tablespace temp;

- 호스트 이름 : 인스턴스의 외부(공공, public) ip

- 포트 : 오라클 실행 전 적용한 설정 파일의 내용 대로(기본 1521)

- SID : XE

 

3. 테스트 후 '상태:성공' 확인

 접속이 되지 않을 경우 인스턴스의 1521포트에 대한 인바운드 규칙을 수정해서 허용 해줘야 한다.

(보안상 이렇게 외부에서 접속은 허용하지 않는 것이 맞고 연동 시에도 내부 통신으로 해야 하지만 아직 이해 해야 할 부분이 많아서 우선 이렇게 진행 함)

이렇게 한 후 SQL Developer로 작업을 할 수 도 있고, 나의 팀 프로젝트에서는 jpa를 사용했기 때문에 프로젝트에 연동 후 정상적으로 테이블 등이 생성 되는지 확인했다.

3. 프로젝트에 연동

더보기

프로젝트의 application.properties 파일내에서 다음과 같이 수정 해 준 뒤 jar 파일을 생성 했다.

생성한 파일을 로컬 또는 클라우드 환경에서 실행 시키면 (나의 경우 aws ec2 이용)

이렇게 로그로 Hibernate의 SQL로 정상 작동되는 것을 볼 수 있고,

SQL Developer로도 테이블이 정상적으로 생성된 것을 확인 할 수 있다.

너무 감격스러워서 이렇게라도 한번 정리를 해두고 싶었다.

보안문제나 여러가지 더 알아가야 할 것이 많지만 역시 괴롭지만 재밌다..ㅎㅎ

정확하게 라이센스 부분에 대해서 어떤지 모르겠.. 는데 해보는 수준에서는 괜찮지 않을까 해서 기록으로 남김!

몇가지만 테스트 한 후에 테스트에 사용 한 인스턴스들은 모두 삭제했으니까 오라클에서 철컹철컹 하진 않겠지..?🥺

+ 사용 비용 수준 관련

더보기

이렇게 몇번 인스턴스 생성하고 삭제하고 연습하고 하는동안

사용된 크레딧은 7천원 가량이니까 남은 기간동안 더 많이 연습하고 테스트 해봐야겠다!

일부러 성능 넉넉한것으로 생성해서 사용했는데 이정도니까 AWS 보다 여러가지 시도 해보기는 더 좋은것 같다.

(AWS는 일정 성능을 넘거나 해버리면 과금이 되고 수천만원씩 청구됐다는 괴담도 들려서 쪼금 무섭기도 했음)

앞의 과정을 통해 VM 인스턴스를 생성했고 다음으로 실제 설치를 진행한다.

설치 파일을 옮긴 후 부터는 오라클 공식 홈페이지에 나온대로만 따라하면 된다.

1) FileZilla를 이용해 vm 인스턴스에 설치파일 옮기기

2) VM 인스턴스 내에서 설치 진행하기

1) FileZilla를 이용해 vm 인스턴스에 설치파일 옮기기

더보기

1. FileZilla 프로그램을 실행하고 VM 인스턴스와 연결을 설정한다.

① FileZilla 프로그램의 상단 파일 → 사이트 관리자 메뉴에 들어간다

② 새사이트 → 연결을 구분할 수 있는 이름(또는 그냥 새사이트여도 상관 X) → 연결을 위한 값 입력

②-1 일반 설정 내용 

• 프로토콜 : SFTP - SSH File Transfer Protocol
• 호스트 : <인스턴스의 public ip(external ip)>
  • 앞서 확인했던 GCP VM인스턴스의 외부 ip
• 포트 : (공란)
• 로그온 유형 : 키파일
• 사용자 : <Key comment>
  • PuTTY로 SSH키 생성 시 알아 두었던 Key comment 

②-2. 설정 후 키파일 옆의 찾아보기→ PuTTY로 SSH키 생성 시 저장해 두었던 Private key 파일 선택

③ 연결→ 확인

④ 연결이 정상적으로 되면 다음과 같이 vm instance에 접속 된 모습이 보인다.

2. Oracle Database 설치 파일을 전송한다.

앞서 다운로드 해두었던 Oracle21cXE 설치 파일을 drag&drop으로 가져다 놓으면 전송이 시작된다.

(용량이 크고 최대 속도가 있기 때문에 10분 가량 소요됐음)

전송이 완료 된 후 인스턴스에 파일이 들어간 것을 확인 할 수 있다.

2) VM 인스턴스 내에서 Oracle21cXE 설치 진행하기

2-1) SSH로 인스턴스에 접속하기

더보기

    vm 인스턴스에 접속하기 위해서 GCP에서 제공하는 SSH를 이용하거나 XShell 등 편한 방법으로 접속하면 된다.

(GCP에서 제공하는 SSH는 바로 이용할 수 있고 외부의 프로그램을 이용하면 FileZilla에서 접속했던것과 같은 방법으로 설정 후 접속 할 수 있다.)

나는 GCP에서 제공하는 SSH를 이용했다. GCP의 인스턴스 목록에서 접속 가능하다.

 SSH를 누르고 잠깐의 시간이 흐른 뒤 정상적으로 접속 되면 아래와 같이 터미널이 뜬다.

2-2) Oracle21cXE 설치 진행 

더보기

 이후 부터는 오라클 공식 홈페이지의 문서대로만 하면 된다.

https://docs.oracle.com/en/database/oracle/oracle-database/21/xeinl/installing-oracle-database-free.html#GUID-728E4F0A-DBD1-43B1-9837-C6A460432733

 

Installation Guide

You can install Oracle Database Express Edition using RPM packages.

docs.oracle.com

 간단하게 정리 해보자면

 

1. 본 프로그램 설치 전 Preinstallation RPM 설치

    1) 관리자 권한으로 변경

$ sudo -s

   2) Preinstallation RPM 구동 각 운영체제와 버전 별로 명령어가 다름

        (나는 RHEL을 가져다 만든 centOS7을 썼기 때문에 b-1의 명령어 사용)

 

      a. 운영제제가 Oracle Linux(OL)인 경우

          a-1. Oracle Linux 8 (OL 8)

# dnf -y install oracle-database-preinstall-21c

          a-2. Oracle Linux 7 (OL 7)

# yum -y install oracle-database-preinstall-21c

      b. 운영체제가 Red Hat Enterprise Linux(RHEL)인 경우

          b-1. Red Hat Enterprise Linux 7

# curl -o oracle-database-preinstall-21c-1.0-1.el7.x86_64.rpm https://yum.oracle.com/repo/OracleLinux/OL7/latest/x86_64/getPackage/oracle-database-preinstall-21c-1.0-1.el7.x86_64.rpm
# yum -y localinstall oracle-database-preinstall-21c-1.0-1.el7.x86_64.rpm

          b-2. Red Hat Enterprise Linux 8

# curl -o oracle-database-preinstall-21c-1.0-1.el8.x86_64.rpm https://yum.oracle.com/repo/OracleLinux/OL8/appstream/x86_64/getPackage/oracle-database-preinstall-21c-1.0-1.el8.x86_64.rpm
# dnf -y localinstall oracle-database-preinstall-21c-1.0-1.el8.x86_64.rpm

2. 아까 전송해 둔 Oracle 21cXE 설치 파일로 설치 진행

- 전송된 파일을 복사하거나 이동 후 설치 파일이 있는 경로에서 다음 명령어 실행

   (나는 나의 계정에 oracle이라는 디렉토리를 생성하고 전송해두었던 파일을 복사해서 설치 진행)

 

    For Oracle Linux 7 또는 Red Hat Enterprise Linux 7 :

# yum -y localinstall oracle-database-xe-21c-1.0-1.ol7.x86_64.rpm

    For Oracle Linux 8 또는 Red Hat Enterprise Linux 8 :

# dnf -y localinstall oracle-database-xe-21c-1.0-1.ol8.x86_64.rpm

3.실행전 필요 설정 및 적용

OracleDatabase 실행에 필요한 설정들은 /etc/sysconfig/oracle—xe–21c.conf 파일에서 수정 할 수 있다.

나는 그냥 기본으로 되어 있는 설정 파일을 적용했다. 다음 명령어로 설정 파일을 적용한다.

(기본 설정내용은 컨테이너 DB (XE)에 XEPDB1 데이터베이스를 생성하고

  접속 포트 1521, Enterprise Manager Express의 포트 5500으로 설정 된다.)

# /etc/init.d/oracle-xe-21c configure

설정 파일이 실행되면서 다음과 같이 비밀번호를 설정하도록 하는 line이 뜨면 관리자 권한으로 접속할 때 사용하는 비밀번호를 입력하고나면 한번더 확인으로 입력한다.

그리고 시간이 좀 지난 뒤 다음과 같이 설치가 완료 된다.

2-3) 환경 변수 설정

더보기

위의 방법으로 설치를 완료했고 sqlplus 명령으로 실행하기 위해 몇가지 환경변수를 설정 해 주어야 한다.

(이 내용은 임시로 사용 가능 했는데,

자세한 내용을 다시 찾거나 정리하지 못해서 우선 내가 사용했던 방법을 써둔다.)

 

① 환경변수 설정 파일을 편집하기 위해 vim 에디터로 파일을 연다.

# vi ~/.bash_profile

② 기존 내용 하단에 다음 내용을 추가 후 저장>닫기

export ORACLE_HOME=<your_oracle_home>
export ORACLE_SID=<your_oracle_sid>
export PATH=$ORACLE_HOME/bin:$PATH
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH

---

 ※ 내가 사용한 환경변수 설정 파일(/.bash_profile)의 내용은 다음과 같다.

# .bash_profile

# Get the aliases and functions
if [ -f ~/.bashrc ]; then
        . ~/.bashrc
fi

# User specific environment and startup programs

PATH=$PATH:$HOME/.local/bin:$HOME/bin

export PATH

#Oracle env setting#Oracle env setting
export ORACLE_HOME=/opt/oracle/product/21c/dbhomeXE
export ORACLE_SID=XE
export PATH=$ORACLE_HOME/bin:$PATH
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH

export ORACLE_HOME=/opt/oracle/product/21c/dbhomeXE
export ORACLE_SID=XE
export PATH=$ORACLE_HOME/bin:$PATH
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH

---

③ 설정한 환경변수 적용 후 확인

# source ~/.bash_profile
# env

④ OracleDatabase 실행

# sqlplus

    다음과 같이 사용자명을 입력하라는 내용이 나오면 정상적으로 설정 된것이다.

이제부터는 이전에 했던것과 같이 테이블 스페이스를 생성하고 사용자를 생성하면 된다.

데이터베이스를 클라우드 환경에서 운영하는 여러가지 방법이 있다.

AWS의 RDS가 가장 편한 방법이었지만 OracleDB의 경우 라이센스 비용 문제로 일단 고려하지 않았다.

(삽질 너무 하다가 지쳐서 그냥 돈내고 쓸려고 하다가 이 방법으로 성공해서 사용하지 않음)

다른 방법으로는 현재 사용한 방법처럼 AWS의 EC2를 사용하는 방법, 그리고 여러 운영체제에서 다양한 방법이 있었지만 최종적으로 EC2에서 프리티어에 제공하는 t2.micro는 메모리가 1GB로 Oracle21cXE 설치가 불가 했다.

GCP(Google Cloud Platform)에서는 신규 사용자에게 일정 크레딧을 제공하고 그 크레딧 만큼 무료로 사용할 수 있었다.

(오라클 리눅스를 이용한 설치가 간편했지만 오라클 클라우드 회원가입에 실패ㅜㅜ)

GCP에 회원가입 하는 방법은 이미 흔해서 필요한 VM instance 생성과 설정하는 내용만 정리 했다.

여기서 해야 할것 

1) VM instance 생성

2) 생성한 instance의 외부 ip 주소 알기

3) SSH 키 설정 (Public key 등록)

1) VM instance 생성

(회원 가입 후 프로젝트 생성, VPC 생성 후 VM instance 생성이 가능 했던 것 같다.)

더보기

1. GCP 서비스 중에 Compute Engine의 VM instance에 들어가면

2. 상단의 CREATE INSTANCE 메뉴를 통해 VM instance를 생성할 수 있다.

 

3. 다음과 같은 기준으로 설정하고 인스턴스를 생성 한다.

• Name : 인스턴스를 구별할 수 있는 이름
  • (영소문자, 숫자, 하이픈만 사용 가능 | 영소문자로 시작해야함 | 하이픈으로 끝나면 안됨)
• Region : asia-northeast3 (Seoul)
  • 가까운 곳으로 설정
• Zone : 아무거나
  • 설정한 리전 중에 어디를 쓸거냐를 선택하는 건데 인스턴스 생성 후에는 변경이 되지 않는다고 함

 

• Machine configuration : 
  • 여러지 타입중에 크게 상관 없는 것 같다. 특별하게 고려해야 하는 사항이 있다면 조건을 충족하는 머신으로 선택
• Machine type : 2G 이상의 메모리를 가지는 걸로 프리셋 또는 커스텀 중에 선택

 

• Boot disk → CHANGE
  • PUBLIC IMAGES 중에 다음으로 선택
    • Operating system : CentOS
    • Version : CentOS 7
    • Boot disk type : SSD persistent disk
      • 이건 내마음대로 그냥 선택 SSD가 빠를거 같으니까..?ㅎㅎ
    • Size (GB) : 20
      • 사용할 데이터 양에 따라서 조정해서 설정
    ⇒ select  누르면 부팅 디스크 설정 완료

 

이렇게 설정 한 대로 CREATE 를 누르면 인스턴스가 생성된다.

 

---

CREATE INSTANCE를 했던 페이지로 들어가면

이렇게 생성한 인스턴스를 확인 할 수 있다.

(설정에 따라 다르겠지만 나는 금방 생겼고 1분 이내로 정상적으로 구동 되는 것이 보였다.)

2) 생성한 VM instance의 외부 ip 주소 알기

더보기

인스턴스 목록에서 보이는 External IP가 인스턴스의 pubilc ip 이다.

※ 유동ip 이고, 인스턴스를 껐다 켜면 변경된다는 점 주의

    고정ip로 사용하는것은 비용 소요되는 것으로 안다.(aws, naver cloud는 확실하게 비용 소요됨)

3) SSH 키 설정

더보기

앞선 글에서 준비한 public key를 등록해줘야 한다.

 

1. 사이드 메뉴중 밑으로 내려가면 Metadata라는 메뉴가 있다. 여기로 들어간다.

2. Metadata 메뉴 내의 상단 탭에서 SSH KEYS에 들어간 뒤 ADD SSH KEY를 누른다.

3.앞서 PuTTYgen으로 생성 후 따로 복사해 두었던 public key를 입력후 저장한다.

이렇게 한 후 SSH로 VM 인스턴스에 접속하고 설치하는 과정을 진행 할 수 있다.

Oracle을 이용했던 팀 프로젝트를 클라우드 환경에 배포해 보기 위해

클라우드 환경에 OracleDatabase 설치를 시도했다.

여러가지 방법을 시도 했지만 전반적으로 부족한 지식 등등의 문제로

2~3일은 삽질 한 끝에 설치와 연동에 성공했다.

보안적 이슈, 그외 여러가지 문제점들이 있는 방법이지만

성공해 본 것 만으로도 아주 벅차고 신나기 때문에 기록해 두고

나중에 부분부분 개선 하려고 한다.

지식이 아주 짧은 내 기준의 방법 (2023. 8. 기준)

클라우드 환경에 Oracle 21c XE를 설치하고 연동하는 것은 크게 3단계로 나누어 볼 수 있다.

1. GCP(Google Cloud Platform)에 VM instance 생성 
2. Oracle21c XE 설치
3. DB 접속 및 프로젝트 연동

그리고 이과정들을 순조롭게 진행하기 위해 미리 준비 해야 할 것들이 있다.

• SSH 키
• Oracle 21cXE 설치 파일(.rpm)
• FileZilla : Oracle 21c XE 설치 파일을 VM instance에 전송하기 위한 용도

이 글은 사전 준비 사항들에 대한 내용이다.

1) SSH 키 - PuTTYgen 이용

더보기

https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

 

Download PuTTY: latest release (0.78)

This page contains download links for the latest released version of PuTTY. Currently this is 0.78, released on 2022-10-29. When new releases come out, this page will update to contain the latest, so this is a good page to bookmark or link to. Alternativel

www.chiark.greenend.org.uk

1. 위의 홈페이지 에서 패키지(다운로드 후 설치)

또는 PuTTYgen 단일 파일을 다운로드 받은 뒤 PuTTYgen.exe 파일 실행

2.Generate를 눌러서 키 생성 (처음엔 빠른것 같지만 꽤 오랜 시간이 걸림)

 

3. 키가 생성되면 다음과 같은 화면이 나오고 여기서 3가지가 필요하다.

    - Public key, Key Comment, Private key file

---

① Public key : 해당 부분을 내용을 모두 복사해서 메모장에 따로 저장 해 둔다.

② Key comment : 마찬가지로 따로 적어두거나 알고 있는다.( 또는 Public key 마지막 부분에 있음)

③ Private key file : Save private key를 눌러 나중에 찾을 수 있는 경로에 알아 볼 수 있는 이름으로 저장해 둔다.

    (ex. gcp-private-key )

2) Oracle 21cXE 설치 파일(.rpm)

더보기

https://www.oracle.com/database/technologies/xe-downloads.html

 

Oracle Database Express Edition (XE) Downloads

Support Oracle Database Express Edition (XE) is a community supported edition of the Oracle Database family. Please go to the Oracle Database XE Community Support Forum for help, feedback, and enhancement requests. Note: Oracle Support Services only provid

www.oracle.com

오라클 홈페이지에서 .rpm형식의 설치 파일을 다운로드한다.

나는 centOS7을 사용할 것이라서 Oracle Database 21c Express Edition for Linux x64 ( OL7 ) 를 다운받음

용량이 크기 때문에 이것도 시간이 좀 걸림.

3) FileZilla 프로그램

더보기

위에서 준비한 Oracle21cXE 설치 파일을 클라우드환경으로 전송하기 위한 프로그램. 다른 것들도 많지만 FileZilla를 보통 많이 쓰는것 같다.

https://filezilla-project.org/

위의 홈페이지에서 Cilent를 다운 받아서 설치한다.

설치에는 별다른 설정 필요 없이 그냥 다음 계속 눌러서 설치.

이렇게 준비를 해놓고 이제 본격적으로 시작한다.

프로젝트를 클라우드 환경에 배포하는 과정 중에 모르는것, 문제들에 대해서 다시 찾아보는 시간을 줄이기 위해 작성

groupId,  artiactedId, version 각 프로젝트별로 있고 의존성주입을 한 프로젝트들에도 모두 있다는 것을 알 수 있다.

최상단의 내용은 내가 작성한 프로젝트에 대한 groupId,  artiactedId, version을 의미한다.

[공식 문서의 설명 + 찾아본 정보]

groupId: 모든 프로젝트에서 각 프로젝트를 고유하게 식별하는 것

- Java의 패키지 이름 규칙을 따라야 한다.

(강제 규칙은 아니지만 역도메인이름(즉, Java 패키지 이름)을 사용하지 않고 단어하나로 쓰면

  Maven Central 저장소에서 프로젝트의 ID로 승인 받기 어려울 것)

- Java 패키지 이름 규칙을 따라서 하위그룹을 생성할 수 도 있음

artifactId: 버전 없이 jar 파일의 이름

- 소문자로 된 문자만 사용해야 함

- 다른 사람이 만든 jar 파일인 경우 배포되는 이름을 그대로 사용해야 함
예: maven, commons-math

- 웹 프로젝트의 Context root로 자동 설정된다. → 이 Context root는 배포할때 url 설정과 관련 있..는거 같음

pom.xml에  artifactId가 controller로 되어있어서 Context root도 /controller 로 되어 있음.

왜 저렇게 해놨는지는 당연히 모름... 그냥 프로젝트에 대한 setting을 복사해서 써서 그런것 같음. 그래서 artifactId와 함께 바꿈

version: 말그대로 배포하는 프로젝트의 버전

- 일반적인 형태 (1.0, 1.1, 1.0.1 등)를 사용할수 있지만,

날짜는 보통 SNAPSHOT 빌드와 연관되기 때문에 사용하지 않도록 함.

- 다른사람의 artifact인 경우 버전 번호 원래 적힌 그대로 사용해야 함.

출처 : https://maven.apache.org/guides/mini/guide-naming-conventions.html

Guide to naming conventions on groupId, artifactId, and version

• groupId uniquely identifies your project across all projects. A group ID should follow Java's package name rules. This means it starts with a reversed domain name you control. For example,org.apache.maven, org.apache.commonsYou can create as many subgroups as you want. A good way to determine the granularity of the groupId is to use the project structure. That is, if the current project is a multiple module project, it should append a new identifier to the parent's groupId. For example,
• org.apache.maven, org.apache.maven.plugins, org.apache.maven.reporting
• Maven does not enforce this rule. There are many legacy projects that do not follow this convention and instead use single word group IDs. However, it will be difficult to get a new single word group ID approved for inclusion in the Maven Central repository.
• artifactId is the name of the jar without version. If you created it, then you can choose whatever name you want with lowercase letters and no strange symbols. If it's a third party jar, you have to take the name of the jar as it's distributed.eg. maven, commons-math
• version if you distribute it, then you can choose any typical version with numbers and dots (1.0, 1.1, 1.0.1, ...). Don't use dates as they are usually associated with SNAPSHOT (nightly) builds. If it's a third party artifact, you have to use their version number whatever it is, and as strange as it can look. For example,2.0, 2.0.1, 1.3.1

+ 위의 정보들을 통해서 아래와 같이 여러 프로젝트들이 트리 형태를 만든다고 함.

    ⇒다른 프로젝트에서 나의 프로젝트를 사용할때 사용하는 식별자라고 생각하면될 것 같음

packaging : 패키징 할 형식

빌드 후 프로젝트 파일의 이름과 형식이 이렇게 생성된다.

출처 : https://youtu.be/KNGQ9JBQWhQ