악역영애의 개발일지

1. 서버 메모리 swap

AWS 프리티어 무과금러는 .. Jenkins 배포에 앞서 꼭!!! 해야하는 작업이 있다

바로 메모리 swap

프리티어로 받은 서버로는.. 배포하다가 인스턴스가 죽어버린다

그러면 ip도 다시 발급받게되고ㅠㅠ 설정을 다 바꿔야하는게 너무귀찮으므로 꼭 메모리 swap 을 해야한다고 강조한다

자세한 과정은 아래 블로그에 너무 잘 정리해두셔서 꼭!! 방문을 해서 메모리 swap 처리를 하기 바란다

https://kth990303.tistory.com/361

2. AWS 서버에 Jenkins 권한 부여

Jenkins가 실제로 배포하려면 서버에 대한 읽기/쓰기/수정/삭제 권한이 있어야 한다

AWS 서버에 접속하여 root 계정으로 전환한다

$ sudo su

sudoers.d 폴더로 이동해서 jenkins 파일을 생성한다

$ cd /etc/sudoers.d
$ touch jenkins

jenkins에게 sudo 명령 실행권한을 부여하고 실행할때 password 를 물어보지않는 설정을 추가하고 해당파일 보안설정을 해준다

$ jenkins ALL=(ALL) NOPASSWD: ALL
$ chmod 0440 jenkins

근데 나는 이 방법으로는 jenkins 배포할때 권한이 자꾸 튕겨져나가서, 아래 커맨드도 실행했다

$ echo "jenkins ALL = (root) NOPASSWD:ALL" | sudo tee /etc/sudoers.d jenkins
$ sudo chmod 0440 /etc/sudoers.d/jenkins

2. Jenkins - Github 계정 연결

이제 Jenkisn 웹페이지에 접속해보자

Jenkins 에서 github 를 사용하려면 우선 github계정을 jenkins에 등록시켜야 한다

이때 사용할 github계정은 엄밀히 말하면 내가 배포하려고 하는 repository에 접근 가능한 github 계정이기만 하면 된다

대시보드 > Jenkins 관리 > System 으로 이동해보자

Github 이라는 영역이 보일텐데 여기서 git hub 계정추가가 가능하다

gitHub server 콤보박스를 선택하면 아래와 같은 영역이 노출될것이다

고대~~~로 냅두고 Credentials 하단의 Add 를 눌러준다

Credentials 는 Jenkins 에 등록된 github 계정목록이 노출되는 부분이지만

지금은 등록된 github 계정이 없으므로 none으로 보이는것일뿐이다

각 항목의 의미는 아래와 같다

username : gihub 계정 username
password : github 계정 password
ID : 해당 정보를 대표할 name이며, 해당 계정을 구분하기위한 용도로만 사용되는 대표이름. title
Description : 안적어도 됨

username은 github의 username 이고 ID는 jenkins 에서 사용할 id이다 즉, Credentials 목록에 노출될 text이다

이렇게 입력하면 비로소 Credentials 에 내 계정이 보인다

3. Jenkins - SSH 설정

앞으로 Jenkins 에서 AWS 서버에 접속하여 배포를 진행하겠지만, 우리는 해당서버에 pem/ppk 파일로 접속하고있기때문에 Jenkins에도 해당정보를 전달해주어야한다

1) SSH 플러그인 설치

기본적으로 Jenkins 에는 SSH 플러그인이 없기때문에 따로 설치해줘야 한다

아래 경로로 이동한다

Jenkins 관리 > 플러그인관리 > 설치가능 > Publish Over SSH 설치

설치완료되고 재시작 여부를 물으면 재시작해준다

재시작이 완료되면 System 관리 > Publish Over SSH 영역이 생겨있는것을 볼 수 있다

key 영역을 입력해줘야하는데, 다운받아놓은 pem 파일을 크롬에 던지면 텍스트가 주루룩 나온다

그것을 입력해주자

하지만 이것은 pem 파일만 등록된거고, 그래서 어느 서버에 적용할건지 설정해줘야한다.

하단의 추가 버튼을 클릭하여 SSH Server 를 등록하자

name : 해당 서버를 지칭할 이름. 중요하지않다 title 개념
hostname : AWS IP주소
username : 유저명 (우리의 경우는 ubuntu라고 적는다)
remote directory : 젠킨스로 생성된 배포파일의 root 경로

여기서 어려운 부분은 remote directory 인데, 우선 AWS 서버 내 배포파일이 저장될 위치를 알아서 정해보자.

나는 home 디렉토리에 ubuntu 폴더를 만들었다.

그래서 위와같이 Remote Directory 는 /home/ubuntu 가 되었다

이렇게 하면 Jenkins가 실제로 배포할때 서버에 접속할 수 있게 되었다

3. 배포 item 생성 - Free Style

자 드디어 배포를 해보자!!

Dashboard 에서 새로운 Item 을 추가해준다

다양한 선택지가 있지만, 우선 Freestyle project 를 만들어보겠다

해당 프로젝트명 혹은 구분가능한 이름을 input에 입력해주자

두가지 옵션의 간단한 차이는 아래와 같다

Freestyle project ?
-> jenkins 설정으로만 배포한다

Pipeline ? 
-> 프로젝트 소스코드에 내가 직접 커맨드를 입력한 정보를 기반으로 배포한다

item 을 생성하면 또!! 설정창이 나온다 ㅎㅎ

기존에 설정했던것이 서버에 대한 설정이라면, 지금은 repository 에 대한 설정이라고 보면된다

1) Github 설정

설명 부분에 해당 프로젝트의 설명을 간단히 입력해주고 하단의 Github project 체크박스를 선택한다

그리고 나의 repository 주소를 넣어준다. git clone 할때 입력되는 http 주소이다

밑에 내리면 소스코드관리 -> Git 을 선택한다

Repository URL 은 위에서 입력한 github 주소와 똑같이 입력해주고, Credentials도 기존에 설정된 계정을 선택한다

하지만!!!

만약 private github repository 를 사용한다면 해당 계정으로는 오류가 발생한다

원인은, 정책변경으로 인하여 user/password 방식으로 등록한 github계정으로는 해당 repository에 접근이 불가하다

토큰방식으로 등록된 github 계정이 필요하다

또한!! 해당 private repository를 생성한 계정이 필요하다.

repository 가 public 이라면 아래 과정은 넘어가주길 바란다.

만약 private 라면 Credentials 하단의 Add를 눌러서 토큰방식의 계정을 추가해보자

secret 에 github에서 발급받은 토큰을 입력해야한다

Kind → Secret Text 선택 (토큰 인증방식)
Domain : Global credentials
Secret : 깃헙에서 발급 받은 토큰 입력
ID : 해당 정보를 대표할 name이며, 해당 계정을 구분하기위한 용도로만 사용되는 대표이름. title
Description : 안적어도 됨

2) Build Step 설정

github 설정하고 내리다보면 빌드유발..빌드환경..등등 많이 있지만 

안타깝게도 AWS 프리티어는 빌드를 할때마다 data transfer fee가 청구된다 ㅠㅠ 그래서 한달에 정해진 용량이있는데..

내가봣을땐 한달에 30번정도 하면 용량에 딱 맞았던거같다. 그래서 github hook을 연결해서 빌드하는 작업은 건너뛰었다

이제 각 프로젝트에 맞는 빌드과정을 진행하면 되는데, 나는 Spring boot - java 프로젝트를 배포하였다

gradle clean build를 해준다는 의미이다

echo ">> grant permission"
chmod +x gradlew

echo ">> project clean Build Start"
./gradlew clean build

3) 빌드 후 조치

빌드가 되면 어떤 작업이 필요한지 설정한다

spring 프로젝트의 경우 실행중인 포트가 있다면 종료하고 jar 파일을 실행시키도록 하였다

나는 이미 선택해서 회색으로 되어있지만 Send build artifacts over SSH 선택한다

이제 또 버라이티하게 입력할 영역이 노출되지만 침착하게 입력해보자

나는 spring boot 멀티모듈 프로젝트였기에 경로가 좀 보잡하다

각 항목에 대한 부가설명은 아래와 같다

name :: 프로젝트 명

Transfer :: 어느경로의 배포파일을 어디로 복사할건지 정하는 영역

Source files : build/libs/*.jar 로 입력

 - 만약 멀티모듈이라면 해당 모듈명/build/libs/*.jar 로 입력

Remove prefix : 배포 시 Source files 의 경로에서 제거되어야하는 경로를 입력

 - 배포파일 즉 jar 파일은 System 설정에 등록된 Remote Directory 경로 + Source files 경로로 다운로드될건데

    공란으로 둔다면 /home/ubuntu/build/libs/*.jar 경로로 다운로드될것이다. 그것이 싫다면 build/libs 를 입력하자.

    만약 멀티모듈이라면 해당모듈명/build/libs/*.jar 로 입력

Remote directory : 배포파일 위치할 폴더명

 - Remove prefix 까지 설정하면 /home/ubuntu/*.jar 경로로 다운로드 될텐데, 이러면 어떤프로젝트인지 구분이 되지 않으니

    구분하고싶은 폴더명을 입력하면 된다. 즉 /home/ubuntu/폴더명/*.jar 의 경로로 받아지게 하기 위한 폴더명이다

Source files : build/libs/hello.jar
Remove prefix : build/libs
Remote directory : helloJava

이렇게 설정된 경우, 최종적으로 배포파일은 /home/ubuntu/helloJava/hello.jar 경로로 배포될것이다

Exec command : 옮기고나서 실행할 커맨드

나는 8080포트번호를 죽이고 jar 를 실행하는 커맨드를 입력했다

pid="$(lsof -t -i :8080 -s TCP:LISTEN)";

if [ "$pid" != "" ]; then
  kill -9 $pid;
  echo "$pid process kill complete"
else
  echo "pid is empty"
fi

cd /home/ubuntu/폴더명

java -jar 배포파일.jar &

만약 멀티모듈을 사용한다면 Add server 로 다른 모듈도 추가해주면 된다

진짜끝!!

3. 배포 item 생성 - Pipeline

백단은 freestyle 로 배포구성을 마쳤다

이제 프론트를 해야하는데, 나의 경우는 react-next.js 로 구성된 프로젝트였다

때문에 해당 프로젝트를 jenkins에서 배포하기 위하여 node js 플러그인 설치가 필요하였다

1) node js 플러그인 설치

Dashboard > Jenkins 관리 > Plugins > Avaliable plugins > node js 검색하여 설치하자

2) Node Js 이름설정

설치가 완료되었으면 아래 경로로 이동하여 다운받은 nodejs 의 이름을 설정해준다

나는 nodejs 라고 설정하였다

Dashboard > Jenkins 관리 > Tools → NodeJs → name 설정

3) Jenkinsfile 추가

Pipeline으로 Jenkins 가 배포하기위해서, 프론트 프로젝트 소스코드를 수정해야한다

프로젝트 root에 Jenkinsfile 파일을 추가하고 아래의 코드를 입력한다

확장자 없고 파일명은 "Jenkinsfile" 딸랑 하나만 놓으면 된다

pipeline {
     agent any
     tools {nodejs "nodejs"}

     stages {
        stage("Build") {
            steps {
                sh "npm install"
                sh "npm run build"
            }
        }
        stage("Deploy") {
            steps {
                script {
                    sh 'chmod +x ./script/deploy.sh'
                    sh './script/deploy.sh'
                }
            }
        }
    }
}

상단의 코드에서 tools {nodejs "nodejs"} 라고 되어잇는 부분이 있는데,

"" 쌍따옴표 안에 들어가는 이름은 위에 Jenkins 에서 설정한 Node Js 의 이름을 정확히 넣어야한다

그리고 프로젝트 root에 script 폴더를 만들고 deploy.sh 파일을 추가하자

왜냐하면 상단의 코드에서 Deploy 부분에 script/deploy.sh 의 작동을 하기 때문이다

pid=$(sudo lsof -ti:3000)


echo "========= front deploy start ========="

if [ -n "$pid" ]; then
  sudo kill -9 $pid
  echo "kill ${pid} process..."
  nohup npm start &
  exit
else
  nohup npm start &
  exit
fi

echo "nginx restart..."

systemctl restart nginx

echo "========= front deploy end ========="

3000번 포트를 죽이고 nginx restart 해주는 설정이다

4) item 추가

자 이제 프론트 배포를 해보자ㅠㅠ

Pipeline 으로 아이템을추가하고 설명, github repository 주소를 입력한다

하단에 내리다보면 Pipeline 설정을 할수있다

위에 입력한 repository 와 동일한 url 을 입력해주고 만약 private repository 라면 위에서 설정한 토큰방식의 github 계정과 연결해준다

그리고 배포되어야하는 브랜치명을 입력해준다

이렇게.. 프론트/백 배포 설명을 마쳐본다

Freestyle 은 Jenkins 의 설정에 따라 배포되고 

pipelene은 프로젝트 내 세팅해놓은 설정에 따라 배포된다

이 과정을 따르면 AWS 프리티어 인스턴스에 spring boot 로 개발된 백단 프로젝트를 AWS 에 배포하고

react + next.js 로 개발된 프론트 프로젝트를 AWS 에 배포할수있다!

내가 aws 서버에 배포할 프로젝트는 총 2개이다

프론트 react+next.js
백엔드 springboot java

jenkins 설치에 앞서, 실제로 jenkins가 설치되고 실행시키기 위한 react 와 jdk를 설치해야한다

1. react 설치

아래 커맨드로 react 를 설치한다

설치하기에 앞서 업데이트 및 업그레이드를 해주는게 좋다

apt update ?
패키지 목록을 최신 상태로 업데이트

apt upgrade ?
시스템에 설치된 모든 패키지를 최신 버전으로 업그레이드

$ sudo apt update
$ sudo apt upgrade

현재는 npm이 없는 상태라서, npm을 install 받아준다

npm ?
Node.js환경에서 사용되는 패키지를 관리하고 설치하는 도구
간단히 말하면, 프론트에서 사용되는 다양한 소프트웨어를 다운받으려면 npm이 꼭 있어야 한다

$ sudo apt install npm

무사히 npm install 이 완료되었다면 react 를 설치한다

$ npm install -g create-react-app

만약 권한문제로 설치가 안된다면 아래 커맨드 입력 후 진행한다

$ sudo su
$ npm install -g create-react-app

install이 완료되었다면 아래 커맨드로 잘 설치되었는지 확인한다

$ create-react-app --version

버전명이 나온다면 설치완료된것!

2. JDK 설치

내가 설치하고 싶은 jdk 버전으로 설치한다

나는 jdk 17을 설치하였다

$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get install openjdk-17-jdk

3. AWS 인바운드 규칙 수정

본격적인 jenkins 설치에 앞서 AWS 인바운드 규칙수정을 해줘야한다

추후 해당 jenkins 에 접근하려면 http://ip주소~~/포트번호 이렇게 접근을 해야하기때문에, jenkins 용도로 사용할 포트번호를 정하고 AWS에서 접근권한을 줘야하기 때문이다

AWS 웹페이지 -> 콘솔 -> EC2 -> 보안그룹 -> 인스턴스명 선택 -> 인바운드 규칙 편집

나는 8081 이라는 포트를 사용하였다.

본인이 원하는 포트번호를 정하고 나중에 포트번호를 까먹을 수 있기 때문에 메모란에 jenkins 라고 적어주자.

4. Jenkins 설치

AWS에서 제공해주는 Jenkins 설치기능을 사용하여도 되지만... 유료다!

나는 철저한 무과금을 위하여 직접 jenkins를 설치하였다

설치하는 과정에서 jenkins 의 ssh key 변경 등의 이슈가 있었고, 아래 과정이 나중에는 안먹힐수도있지만 현재까지는 잘 작동되는것을 확인하였다

1) 서버접속

윈도우/맥 OS 에서 기존에 만들어둔 서버에 접속한다

2) Jenkins 설치

아래 커맨드를 순서대로 실행한다

$ wget -q -O - https://pkg.jenkins.io/debian/jenkins-ci.org.key | sudo apt-key add -
$ echo deb http://pkg.jenkins.io/debian-stable binary/ | sudo tee /etc/apt/sources.list.d/jenkins.list

그리고 아래 커맨드로 젠킨스를 실제로 다운로드 받는데

$ sudo apt install jenkins

오류가 발생했다

ubuntu@ip-172......:~$ sudo apt-get install jenkins
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Package jenkins is not available, but is referred to by another package.
This may mean that the package is missing, has been obsoleted, or
is only available from another source

E: Package 'jenkins' has no installation candidate

이런 오류가 발생되었다면,

https://pkg.jenkins.io/debian-stable/ jenkins 가이드를 참고하여 커맨드를 새로 입력한다

보통 커맨드랑 다르게 엔터가 들어가있을건데 그냥 그대로 복사해서 입력하면된다

$ curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee \
    /usr/share/keyrings/jenkins-keyring.asc > /dev/null

$ echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \
    https://pkg.jenkins.io/debian-stable binary/ | sudo tee \
    /etc/apt/sources.list.d/jenkins.list > /dev/null

무슨 key가 변경된거같은데 이렇게 입력해도 아무 반응이 없을것이다

긴가민가하지만, 다시 install을 시작해보자

$ sudo apt update
$ sudo apt install jenkins

잘 될것임!! 안되면 구글링 각 ㅠㅠ

설치 중 아래와 같은 문구가 나온다면 N 을 해주자

Configuration file '/etc/gnome/defaults.list'
 ==> Modified (by you or by a script) since installation.
 ==> Package distributor has shipped an updated version.
   What would you like to do about it ?  Your options are:
    Y or I  : install the package maintainer's version
    N or O  : keep your currently-installed version
      D     : show the differences between the versions
      Z     : start a shell to examine the situation
 The default action is to keep your current version.
*** defaults.list (Y/I/N/O/D/Z) [default=N] ?

설치가 잘 됐는지 확인하기위해 아래 커맨드로 jenkins 상태를 확인한다

$ sudo systemctl start jenkins
$ sudo systemctl status jenkins

하지만 상태를 보면 마지막에 httpPort = 8080으로 되어있을것이다

이것을 AWS에서 보안규칙변경한 8081로 바꿔보자

3) jenkins 포트변경

jenkins 포트변경 하려면 jenkins.service 파일을 수정해야하는데 해당 파일은 readOnly라서 수정 권한이 필요하다

권한 부여 후 수정해보자

chmod 777 ?
모든 사용자에게 읽기, 쓰기, 실행 권한을 부여

$ sudo chmod 777 /usr/lib/systemd/system/jenkins.service
$ sudo vim /usr/lib/systemd/system/jenkins.service

Environment jenkins port 설정을 추가하고 저장해준다

해당파일을 다시 readOnly로 만들어주기 위해서 권한을 변경한다

chmod 444 ?
모든 사용자에게 읽기만 가능한 권한을 부여

$ sudo chmod 444 /usr/lib/systemd/system/jenkins.service

해당 변경사항을 정상적으로 사용하기위해서 jenkins 를 재시작 해야한다

deamon-reload ?
새로운 또는 변경된 서비스 파일을 다시 읽도록 명령

$ sudo systemctl daemon-reload
$ sudo service jenkins restart
$ sudo systemctl status jenkins

jenkins의 status 를 살펴보면 정상적으로 activate 되었으며 httpPort = 8081 로 확인된다

하단에 Password 관련 안내문구가 있는데 암호화된것같은 저 문장이 jenkins 초기 password 이다

해당 password text를 복사해둔다

5. Jenkins 접속

이제 브라우저에서 Jenkins 에 접속해보자

http://ip주소:젠킨스포트번호

처음 접속하면 아래와 같은 화면이 보일것이다

서버에서 제공받았던 password를 입력해서 접속하자

혹시 password를 모른다면 아래 커맨드로 password를 확인할 수 있다

$ sudo cat /var/lib/jenkins/secrets/initialAdminPassword

1) 초기설정

Install suggested plugins 선택한다

select 는 커스텀같아서.. 무리!

2) 계정생성

앞으로 jenkins 로그인 시 사용할 계정을 생성한다

3) IP 설정

AWS IP 주소 + 포트번호를 적어주면 된다

혹시!! aws 인스턴스 ip가 탄력적 ip 설정이 되어있지 않으면 인스턴스 올렸다 내릴때마다 ip주소가 바뀌는데

추후 Jenkins에 설정된 ip주소를 바꿔야한다면 브라우저에서 아래와 같은 경로로 진입해서 바꾸면된다

Jenkins 접속 > Dashboard > Jenkins 관리 > System > Jenkins URL 변경

이렇게 Jenkins 설치 및 계정생성이 완료되었다

다음 과정으로는 github 계정연결, ssh 설정, 빌드후조치, item 생성, 메모리 swap을 해야하는데

포스팅이 너무 길어져서.. 다음 포스팅에서 다뤄야겠다 :)

1. Nginx 설치

서버에서 아래와 같이 nginx를 설치한다

$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get install nginx

apt 업데이트를 해주고 nginx 설치가 되었으면 아래 커맨드로 잘 구동되는지 확인한다

$ sudo service nginx status

그리고 서버도 들어가서 nginx 로고를 확인하면 끝!

나는 react + next.js 프로젝트를 jenkins로 배포할 예정이며
next.js와 jenkins pipeline 에서 프록시설정을 진행할것이기때문에 nginx에 별도의 proxy 설정은 하지않았다

하지만 만약 proxy 설정이 필요하다면 아래 번외를 참고!

아래는 참고용 Nginx 커맨드

$ sudo service nginx status # nginx 상태 확인
$ sudo service nginx start # nginx 실행
$ sudo service nginx restart # 중지 후 재실행
$ sudo servcie nginx reload # 수정된 파일 적용하여 연결을 끊지 않고 재실행
$ sudo service nginx stop # nginx 중지

기본적으로 Nginx는 서버가 부팅될 때 자동으로 시작된다

$ sudo service disable nginx # 자동 시작 비활성화
$ sudo service enable nginx # 자동 시작 활성화

번외

만약 nginx 에 proxy 설정을 해야한다면 아래 커맨드로 nginx 설정파일 진입

$ sudo vi /etc/nginx/sites-avaliable/default

위 이미지와 같이 location 과 root 를 설정해주고 저장

root : nginx로 실행되는 프로젝트 위치
location : ip 혹은 도메인명/~ 쳤을때 연결되어야하는 proxy 즉 포트 연결설정

1. Maria DB 설치

많고 많은 DB 중에서 Maria DB 를 선택한 이유는 실제 운영을 염두하여 비용이 들지않게 하기 위하여 선택했다.

1) APT 업데이트

Maria DB 설치에 앞서 시스템 업데이트를 해줄필요가 있다

apt ?
Advanced Package Tool의 약자, 리눅스 시스템에서 소프트웨어 패키지를 설치/업데이트/제거 하는 명령어와 관리도구

소프트웨어를 리눅스서버에 설치하기에 앞서 업데이트를 해주는게 좋다

$ sudo apt update

2) Maria DB install

이제 실제 Maria DB를 다운로드 한다

$ sudo apt-get install -y mariadb-server

$ sudo apt install -y mariadb-server

3) 비밀번호 설정

ROOT 계정의 비밀번호를 설정한다

$ sudo mysql_secure_installation

커맨드를 입력하면 아래와 같은 선택창이 나온다
차례대로 본인에게 맞는 설정을 선택한다

Switch to unix_socket authentication [Y/n]
-> 패스워드를 사용하기위해 N

Change the root password? [Y/n] Y
-> 패스워드 변경을 위해 Y

Remove anonymous users? [Y/n] Y
-> 보안을 위해 익명사용자 제거 Y

Disallow root login remotely? [Y/n] n
r-> oot 계정 원격접속 필요 시 N, 아니면 Y

Remove test database and access to it? [Y/n] Y
-> test DB를 유지하려면 N

Reload privilege tables now? [Y/n] Y
-> 지금까지 설정한 내용 적용하려면 Y

ROOT 계정설정이 완료되었다
실제로 외부에서 접근하려면 root 계정을 그대로 쓰는것보다 새로운 계정을 하나 만들고 그것을 사용하는게 좋다

2. DB 외부 접근 설정

개발툴 등 외부에서 접근하기위한 user를 생성한다

1) 외부접근 계정생성

아래 커맨드로 mysql에 접속한다

$ sudo mysql

접속되었으면 계정을 생성한다

mysql> create user '아이디'@'%' identified by '비밀번호';
mysql> grant all privileges on *.* to '아이디'@'%' with grant option;

위 커맨드를 한줄씩 입력하면되고, 아이디/비밀번호는 본인이 설정하면된다
그리고 다른 커맨드와 다르게 세미클론을 꼭 붙여준다

아래는 예시이다

아이디 : aaa
비밀번호 : aaa!!

mysql> create user 'aaa'@'%' identified by 'aaa!!!';
mysql> grant all privileges on *.* to 'aaa'@'%' with grant option;

2) 외부접근 가능포트 설정

외부접근용 계정을 생성하였으니, 외부에서 접근하기위하여 접근가능포트 설정을 해야한다

우선 아래 커맨드로 DB 접속을 해제한다

mysql> exit

해당 DB를 외부에서도 접근하기 위한 포트설정이 필요하다

$ sudo ufw allow out 3306/tcp
$ sudo ufw allow in 3306/tcp

위 2개의 커맨드를 입력했을때 Rules update 나오면 성공이다

3) 접근 가능 ip 수정

포트를 뚫었어도 접근 ip설정도 같이 수정해야한다.

아래의 커맨드로 mysqld 설정을 확인한다

$ mysqld --print-defaults

아래와 같은 화면이 보일것이다

--bind-address=127.0.0.1 라는 구문이 있는데 이것은 로컬서버에서만 접근한다는 설정이다

따라서 이것을 전체접근가능으로 변경해주어야한다

설정을 변경하기위하여 아래 커맨드로 config 파일을 편집한다

$ sudo vim /etc/mysql/mariadb.conf.d/50-server.cnf

해당 커맨드 입력하면  아래와 같이 확인될것이다

여기서 변경할것 2가지 이다

• bind-address -> 0.0.0.0
• mysqld 밑에 lower_case_table_names = 1 추가 (테이블 대소문자 구분안함 설정)

아래와 같이 변경해준다

해당 설정을 적용시키기 위하여 DB 재시작한다

$ sudo systemctl restart mysqld

그리고 설정이 잘 적용되었는지 확인한다

$ mysqld --print-defaults

4) Database 생성

만약 테스트 db 말고 별도 DB를 생성하고 싶다면 아래와 같은 과정을 따른다

$ sudo mysql
mysql> show databases;

DB에 접속하여 database 목록을 확인한다

기존 database 이름과 겹치지않도록 주의하여 새로운 database를 생성한다

mysql> create database 새로운db명;

아래 커맨드로 제대로 생성됐는지 다시 확인해본다

mysql> show databases;

아래와 같이 --bind-address 가 변경된것을 확인할 수 있다

3.  AWS 외부 접속 설정

위와 같은 과정으로 리눅스서버의 설정은 완료하였지만 실제로 외부에서 (개발툴 등)접근하려면 AWS의 인바운드 규칙도 같이 변경해야한다

1) AWS 보안 인바운드 규칙 편집

규픽 편집을 위해 아래 경로로 진입한다

AWS 웹페이지 -> 콘솔 -> EC2 -> 보안그룹 -> 인스턴스명 선택 -> 인바운드 규칙 편집

유형 : MYSQL
프로토콜 : TCP
포트범위 : 3306
소스 : 0.0.0.0 (모든 IP접근가능)
설명 : 해당 포트에 대한 설명

필요에 따라 소스는 본인의 IP를 적어도되고, 다양한 규칙이 생겼을때 구분하기위하여 설명을 추가 하였다

이 모든것이 완료되었으면, 본인의 개발툴에서 접속이 가능한지 Test Connection 해보자

잘되길 바라며.. !

시작하며

개인적으로 진행한 프로젝트이므로 틀린 정보가 있을 수 있습니다
언제든지 댓글 달아주세요 :)

1. AWS 프리티어 계정 생성

사이트 URL : https://aws.amazon.com

AWS 프리티어 계정 생성을 위하여 사이트에 방문하고 가입합니다

AWS 프리티어 계정이란?
아마존 웹 서비스에서 지원하는 무료로 서버를 사용할 수 있는 권한입니다

인스턴스란?
서버 라고 생각하면 됩니다

EC2 인스턴스란?
AWS 에서 사용하는 인스턴스를 EC2 인스턴스라고 합니다

2. EC2 인스턴스 생성

콘솔 홈 화면 하단의 위젯 ->가상머신 시작 클릭

1) 인스턴스 설정

이름 : 프로젝트명 입력
Quick Start : Ubuntu - Ubuntu Server 22.04 LTS(HVM) SSD Volume Type

프리티어 사용 가능이라고 적혀진 옵션을 선택

인스턴스 유형 : t2.micro
키페어 : 새 키페어 생성 (키페어 있을경우 콤보박스에서 기존 키페어 쓰거나 새로 생성)

키페어란 ?
putty, fileZilla 등으로 서버접속이 가능한 .ppk .pem 파일
키페어 이름은 단순 ppk/pem 파일명이므로 큰 의미를 갖지않으니 적당히 정하기

네트워크 설정 : 보안그룹생성 - ssh 트래픽허용 (기존 보안그룹이 있다면 콤보박스에서 선택)

스토리지 구성 : 20g (20g가 프리미어 최대 제공 스토리지)
IAM 생성 : 필요에 따라 생성

IAM 이란 ?
관리자 접근권한을 관리하는 서비스이며 다수의 관리자가 모든 데이터에 접근하면 위험하므로, 관리자 접근 및 행동을 제어하기위한 설정

탄력적 IP 생성 : 유료서비스. 한달에 1000원이내. 인스턴스에 특정 IP를 고정해서 사용할 수 있다.

유료서비스이므로 나는 하지않았지만, 발급방법은 아래와같다

2) 탄력적 IP 생성

1. IP 주소 할당

   2. IP 주소 생성완료

   3. 인스턴스 - IP 연결

3. 서버 접속

만들어두었던 EC2 서버에 접속한다

만약 아래의 방법으로 접속이 안된다면, aws 설정으로 22번 포트가 안뚫려있을수도있다

AWS 웹페이지 -> 콘솔 -> EC2 -> 보안그룹 -> 인스턴스명 선택 -> 인바운드 규칙 편집
여기서 22번 포트를 추가해보자

1) window 접속방법

• 접속 툴 : putty
• 접속 키 : ppk
  AWS에서 발급받은 키페어파일이 pem 파일이라면, ppk 파일로 변환해야한다
  ppk 파일변환하려면 puttygen 실행 -> key 변환해준다

1. ppk 파일연결
   putty -> Connection -> SSH -> Auth -> Credentials -> private key file for auentication 여기에 ppk 파일 첨부

      save 버튼은 따로없다 바로 session 탭으로 이동한다

    2. 서버접속
      aws콘솔 인스턴스에서 확인되는 퍼블릭 IPv4 주소 를 Host Name 에 넣고 open 하면 아래와 같이 접속된다
      login as : 라고 나올텐데 당황하지않고 ubuntu 라고 입력해주자

2. mac 접속방법

• 접속 툴 : terminal
• 접속 키 : pem
  AWS에서 발급받은 키페어파일이 ppk 파일이라면, pem 파일로 변환해야한다

1. ppk to pem
   mac에서 변환하려면 아래 커맨드로 putty 를 설치하고

$ brew install putty

        아래 커맨드로 변환한다

$ puttygen [원본.ppk] -O private-openssh -o [사본.pem]

    2. 서버접속
        pem 파일이 있는 위치에서 terminal 실행한다
        AWS 웹페이지 -> 인스턴스명 우클릭 -> 연결 -> SSH클라이언트 탭 클릭하여 예) 부분에 나와있는 명령어를 그대로 입력한다

4. 서버 time zone 세팅

새로발급받은 서버는 보통 US 미국기준으로 타임존 세팅이 되어있다.
아래 커맨드로 타임존을 확인한다

$ sudo date

타임존이 우리나라가 아니며, 우리나라로 세팅을 해야한다면 아래와 같은 커맨드를 입력한다

$ sudo timedatectl set-timezone 'Asia/Seoul'

타임존을 다시 조회해본다면 서울로 바뀌어있을것이다

서버세팅 완료~