이전 글에서는 Jenkins로 배포를 제외한 부분을 완성하였다. 즉 CI/CD에서 CI까지 완성했다고 볼 수 있다.
이번 글에서는 CD 부분을 구현할 것이다.
CD의 과정
먼저 이전에 보았던 Jenkins Pipeline 스크립트를 보도록 하자.
pipeline {
agent any
tools {
maven "M3" // Jenkins에서 설정한 Maven의 이름
}
stages {
//...
stage('Deploy') {
steps {
script {
// 원격 서버에서 애플리케이션 실행
sshagent(['deploy_ssh_key']) { // 'server-ssh-credentials'는 Jenkins에서 설정한 credentials ID
sh 'ssh -o StrictHostKeyChecking=no ubuntu@[server instance public ip]'
sh 'scp /var/jenkins_home/workspace/[jar file path] ubuntu@[server instance public ip]:/home/ubuntu/project/'
sh 'ssh -tt ubuntu@[server instance ip] sh ./deploy.sh'
}
}
}
}
}
post {
success {
echo 'Deployment was successful.'
}
failure {
echo 'Deployment failed.'
}
}
}
CD는 서버가 동작할 EC2 인스턴스에 CI과정을 통해 빌드된 jar파일을 전송하고, EC2 인스턴스에서 해당 jar파일을 실행하여 서버를 띄우는 동작을 수행한다.
위의 스크립트 파일에서는 jar파일을 EC2 인스턴스에 전송하는 것 까지 수행하며 deploy.sh 파일을 실행하는 것을 통해 서버를 띄우는 동작을 수행한다.
여기에서 사용되는 것은 SSH 프로토콜이다.
배포 설정
서버 EC2 인스턴스 생성 및 설정
서버를 Jenkins가 있는 인스턴스에서 띄울 생각이 아니라면 다른 EC2 인스턴스에서 실행시켜야 한다. 다른 AWS EC2 인스턴스를 만들자.
만드는 과정은 Jenkins EC2 Instance를 만든 것과 동일하다. 대신 인스턴스를 small이 아닌 micro로 지정했다는 것에 유의하라.
만약 메모리가 부족할 것 같다면 해당 인스턴스에서도 swap memory를 설정해주도록 하자.
서버 인스턴스도 생성된 후에는 보안 관련 설정을 해주어야 한다. Jenkins EC2 와는 SSH 프로토콜을 사용하여 통신하기 때문에 SSH 포트인 22번 포트가 열려있어야 하며 api 요청을 받을 수 있어야 하므로 8080포트, http 80, https 442포트를 모두 열도록 보안 그룹을 설정하도록 하자.
지금 단계 이후로 Jenkins 인스턴스의 경우 Jenkins 인스턴스가 설치되어 있는 인스턴스로, 서버 인스턴스의 경우 우리가 배포할 곳의 인스턴스를 의미하는 것으로 가정하고 이야기할 것이다.
SSH 통신 설정
SSH 통신을 하기 위해서는 공개 키 - 개인 키로 대표되는 비대칭 키가 필요하다. Jenkins 인스턴스에 접속하자.
Jenkins는 Docker Conatiner에서 돌아가고 있으므로 Jenkins Container에 들어가야 할 필요가 있다. 그곳에서 비대칭 키를 생성할 것이다.
sudo docker exec -it jenkins bash
다음 명령어를 통해 jenkins container bash에 접속할 수 있다.
여기에서 SSH key를 만들 것이다.
ssh-keygen -t rsa -b 4096
해당 명령어를 사용하면 4096 길이의 rsa로 생성된 공개 키와 개인 키 쌍이 생성된다.
생성하기 전에 여러 조건들을 물어보는데 그냥 모두 엔터로 스킵해주면 된다.
위의 경로들에서 생성된 공개 키와 개인 키를 확인할 수 있다. 여기서 우린 공개 키가 필요하다. 공개 키를 한 번 보도록 하자.
cat ~/.ssh/id_rsa.pub
다음 명령어를 통해 공개 키를 확인할 수 있다.
이후 나온 결과를 처음부터 끝까지 모두 복사한다. 이후 서버 인스턴스로 다시 넘어간다.
sudo vi ~/.ssh/authorized_keys
서버 인스턴스에서 해당 명령어를 치면 authorized_keys가 vi 에디터로 열리게 된다. 이때 ~가 어딘지가 중요한데 EC2면 ubuntu로 지정되어 있기에 상관없지만 다른 경우 ubuntu로 이동해서 열거나 해당 디렉토리에서 넣고 이후 Jenkins Pipeline에서 스크립트를 수정해야 한다는 것을 유의하라
sudo를 넣지 않을 시 수정한 뒤에 저장할 때 권한 문제가 발생할 수 있으므로 넣어주도록 하자.
vi에서 i를 누르면 insert 모드로 들어가게 되는데 insert 모드로 들어간 후에 아까 복사했던 공개 키를 붙여넣어주자.
이후 ESC를 누르면 다시 command mode로 들어가게 되는데 이때 :wq를 누르면 저장 후 종료를 하게 된다.
이후 Jenkins instance에서 ssh 통신을 해봐 정상적으로 진행되는지를 확인한다.
