젠킨스 설치
Last updated
Last updated
젠킨스 설치 사이트
젠킨스에서는 사용하는 플랫폼(도커, 윈도우, 맥 등)에 맞춰서 젠킨스를 설치할 수 있는 방법들을 알려주고 있습니다. 따라서 현재 플랫폼의 상태에 맞춰서 원하는 버전의 젠킨스를 설치하시기만 하면 됩니다. 저희는 수업에서 Docker를 활용하여 젠키스를 컨테이너에 설치 및 배포 해보도록 하겠습니다.
도커를 이용하여 컨테이너에 젠킨스를 설치(배포)하기 위한 이미지를 다운로드 받는 명령어 입니다. 클릭해서 복사해오도록 하겠습니다.
docker pull 도커ID/레파지토리- 도커허브에서 ID/레파지토리 경로의 이미지를 다운로드 받겠다는 명령어입니다.
다운로드가 완료되었으면 컨테이너에 젠킨스 이미지를 활용하여 젠킨스를 배포해주도록 하겠습니다. 배포방법은 도커허브 하단의 링크를 통해 공식문서에서 확인할 수 있습니다.
공식문서 URL
공식문서에서 조금만 아래로 내리면 도커이미지를 통해 젠킨스를 설치할 수 있는 다양한 방법들을 제시하고 있습니다. 이중 3번째 옵션을 복사해보도록 하겠습니다.
docker run -d -v jenkins_home:/var/jenkins_home -p 8080:8080 -p 50000:50000 --restart=on-failure jenkins/jenkins:lts-jdk17
명령어에 대한 설명
run : 컨테이너를 생성하고 실행하는 명령어입니다.
-d : 컨테이너를 현재 콘솔과 분리(detach)시켜서 백그라운드, 데몬형태로 실행하는 옵션입니다.
-v 로컬디렉토리:도커디렉토리 : 로컬디렉토리에 컨테이너의 디렉토리의 데이터를 보관하겠다는 명령어입니다. 도커는 프로세스이기때문에 프로세스 내부에 저장된 데이터는 원래라면 프로세스 종료시 함께 소면되나, 이를 유지하게끔 해주는 속성입니다.
-p 호스트port:도커port : 현재 호스트의 포트번호와 도커 컨테이너의 포트번호를 바인딩 하는 명령어입니다. 50000포트는 젠킨스의 작업을 도와주는 보조서버의 포트번호를 할당하는 구문입니다.
--restart=on-failure : 컨테이너가 실행실패할 경우 재시작 하는 설정입니다.
jenkins/jenkins:lts-jdk17 : 설치할 이미지의 경로입니다. 로컬 이미지목록에서 찾지 못하면 도커허브에서 찾아서 이미지부터 설치합니다.
젠킨스 서버가 컨테이너에 배포 완료되었다면 docker ps 명령어를 통해 실행중인 컨테이너 목록을 확인해보도록 하겠습니다.
이제 명령어를 통해 컨테이너의 고유 id, 실행한 이미지 파일의 정보, 생성시간과 ,현재상태, 접속 포트번호, 컨테이너의 이름등을 확인할 수 있습니다.
status의 상태가 UP으로 표시되고 있다면 정상적으로 실행 되고 있음을 의미하므로 컨테이버 배포가 잘 실행되었는지 확인하러 가보도록 하겠습니다.
접속시 다음과 같이 관리자 비밀번호를 입력하라는 창이 나옵니다. 해당 비밀번호는 젠킨스 서버 시작시 랜덤하게 설정되며 서버의 콘솔창에 출력해줍니다. 따라서 저희는 가동중인 컨테이너 내부로 접속하여 log파일에 접속 후 비밀번호를 복사해와야 합니다.
실행중인 컨테이너의 로그를 확인하는 방법은 다음과 같습니다.
docker logs 도커ID
다음 비밀번호를 복사하여 관리자 비밀번호에 추가하시면 접속이 가능해집니다.
비밀번호 입력 후 젠킨스에서 사용할 플러그인들을 설치하는 방법을 선택하는 창이 나오게 되는데 이때 첫번째 박스를 클릭하여 유용한 모든 플러그인들을 다운로드 받도록 하겠습니다.
설치 완료시 초기 관리자 계정을 생성할 수 있습니다.
계정 생성후 젠킨스 접속 URL을 지정하면 끝입니다. 이부분은 변경하지 않고 그대로 사용하도록 하겠습니다.
저장후 실행하시면 아래와 같이 젠킨스에 접속할 수 있습니다.
Docker에 설치하기 위해서는 우선 이 필요합니다. 도커탭을 클릭하시면 도커허브 사이트로 이동하게 됩니다.
