Jenkins SSH 에이전트 플러그인
강준현
- information
- jenkins
이 글의 목차
0. 들어가면서
CI/CD 파이프라인을 담당한 젠킨스(jenkins)가 위치한 클러스터와 서비스들을 배포할 쿠버네티스 클러스터가 서로 달라 배포에 어려움이 있었다. 마스터 노드를 담당하는 가상 머신(virtual machine)에 직접 명령어(command)를 전달할 방법이 필요했다. 젠킨스의 SSH 에이전트(secure shell agent) 플러그인을 사용하면 명령어를 직접 전달할 수 있는 데, 이번 포스트에선 이에 대해 정리하였다.
1. Context of Practice
다음과 같은 실습 환경을 구축하였다.
- Windows 운영체제를 사용하는 호스트(host) PC 위에 가상 머신(virtual machine) 두 대를 실행시킨다.
- 운영체제 - Ubuntu 22.04.1
- Jenkins VM IP - 192.168.78.131
- Master VM IP - 192.168.78.133
- 다음과 같은 진행 과정을 통해 실습을 진행한다.
Jenkins VM에서 공개 키, 비밀 키를 생성한다.- 공개 키를
Master VM에 등록하여 비밀 키로 접속 시 재인증을 막는다. - 비밀 키를 젠킨스 시크릿으로 등록한다.
- 젠킨스 SSH 에이전트를 사용해 쉘(shell) 명령어를 실행한다.
2. Generate Public/Private Key on Jenkins VM
Jenkins VM에서 해당 작업을 수행한다. ssh-keygen 명령어를 사용해 공개 키와 비밀 키를 생성한다. 별도 옵션을 주지 않는다면 ~/.ssh 경로에 키가 생성된다.
$ ssh-keygen
Generating public/private rsa key pair.
Enter file in which to save the key (/home/jenkins/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/jenkins/.ssh/id_rsa
Your public key has been saved in /home/jenkins/.ssh/id_rsa.pub
The key fingerprint is:
SHA256:Avt/Z5kJbzvKzwRxcZPdl6IGIYpTgXOavyCrwytoD/s jenkins@jenkins-virtual-machine
The key's randomart image is:
+---[RSA 3072]----+
| .o.. .. . ooo|
| oo.. .. +.o+|
| o*. o o . .|
| o.o = |
| o . S o |
| . . o . .. |
|o.o . o o.+ |
|++o . . ..oX |
|=++E ..o*+o |
+----[SHA256]-----+
3. Copy SSH Key on Jenkins VM
Jenkins VM에서 해당 작업을 수행한다. 이전 단계에서 만든 공개 키를 MasterVM에 복사한다.
- 이 단계에서 비밀번호 한번 입력이 필요하다.
- 이 후엔 비밀 키를 사용한 접근 시에 비밀번호 입력이 필요 없다.
$ ssh-copy-id -i ~/.ssh/id_rsa.pub master@192.168.78.133
/usr/bin/ssh-copy-id: INFO: Source of key(s) to be installed: "/home/jenkins/.ssh/id_rsa.pub"
The authenticity of host '192.168.78.133 (192.168.78.133)' can't be established.
ED25519 key fingerprint is SHA256:TyujxQv+fBzfcekVqBbEGniYS2WY3sAvr5dqwbUFCs4.
This key is not known by any other names
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
/usr/bin/ssh-copy-id: INFO: attempting to log in with the new key(s), to filter out any that are already installed
/usr/bin/ssh-copy-id: INFO: 1 key(s) remain to be installed -- if you are prompted now it is to install the new keys
master@192.168.78.133's password:
Number of key(s) added: 1
Now try logging into the machine, with: "ssh 'master@192.168.78.133'"
and check to make sure that only the key(s) you wanted were added.
4. Register Private SSH Key on Jenkins VM
젠킨스에 비밀 키를 등록한다. 다음과 같은 과정을 통해 비밀 키 등록이 이뤄진다.
Manage Jenkins
- 메인 화면에서
Manager Jenkins을 누른다. - 해당 화면에서
Manage Credentials버튼을 눌러 신규 암호를 등록한다.
Credentials
- 해당 화면에서
global링크를 누른다.
Global credentials
- Add Credentials 버튼을 눌러 비밀 키를 등록한다.
New credentials
- 비밀 키 타입은
SSH Username with private key를 선택한다. - ID를 지정한다.
SSH-Agent-Key- 해당 비밀 키를 식별하기 쉬운 ID
- SSH 로그인에 필요한 사용자 이름을 등록한다.
master- 해당 호스트에 접근하기 위한 사용자 이름
- 이전 단계에서 만든 비밀 키를 직접 입력한다.
cat .ssh/id_rsa명령어 실행 결과
Check Secret Key
- 홈(home) 경로의
.ssh경로에 만들어진 비밀 키를 확인한다..pub확장자가 없는 파일이다.
$ cat .ssh/id_rsa
5. Jenkins Pipeline with SSH Agent
5.1. Install SSH Agent Plugin
- 사용 가능한 플러그인에서
SSH Agent를 검색하여 해당 플러그인을 설치한다.
5.2. Run Jenkins Pipeline
실습을 위한 프로젝트를 만들고 아래와 같은 파이프라인 스크립트(script)를 실행시킨다. 별다른 설정 없이 해당 스크립트 실행만으로 SSH 명령어 실행이 정상적으로 수행된다.
- 대상 호스트는
master@192.168.78.133이다. - 이전 단계에서 생성한
SSH-Agent-Key크레덴셜을 사용한다. ssh명령어를 통해 원격 호스트에 커맨드를 실행한다.- pwd - 쉘이 실행되는 디렉토리 위치를 확인한다.
- mkdir workspace - 해당 위치에 workspace 디렉토리를 생성한다.
pipeline {
agent any
stages {
stage('SSH Agent Command') {
steps {
sshagent (credentials: ['SSH-Agent-Key']) {
sh """
ssh -o StrictHostKeyChecking=no ${TARGET_HOST} '
pwd
mkdir workspace
'
"""
}
}
}
}
environment {
TARGET_HOST = "master@192.168.78.133"
}
}
Result of Pipeline
REFERENCE
광고
KEEP READING
함께 읽으면 좋은 글
DISCUSSION