■ Jenkins 설치 된 상태
■ Github 저장소가 생성
(1) https://github.com/settings/tokens
에 접속하여 Token(classic) 을 생성한다.
GitHub: Let’s build from here
GitHub is where over 100 million developers shape the future of software, together. Contribute to the open source community, manage your Git repositories, review code like a pro, track bugs and fea...
github.com
(2) 생성할 Token 정보를 아래와 같이 입력한다.
- Token Name 입력
- 만료날짜 선택
- repo 체크
- admin:repo_hoke 체크
(3)생성된 Token Key 값 복사.
(4) Jenkins 에 접속하여 새로운 Item 을 생성한다.
(5) 소스 코드 관리에서 "Git" 을 선택
- 저장소(Repositories) URL 을 입력 : 올바른 Credentials 정보를 입력하지 않은 경우 아래와 같이 에러(붉은색) 텍스트를 표시한다.
- Credentials 생성 및 연결
(6)Credentials 연결정보 생성
주의) 나의 실패 히스토리
| 인터넷을 검색해 보면 Kind 를 Secret Text 로 선택해서 입력하라는 게시글도 있었다. 따라 했지만 나의 환경에서는 연결 실패. |
| 인터넷을 검색해 보면 Jenkins 관리 → 시스템 설정 → GitHub Server 추가 따라 했지만 나의 환경에서는 연결 실패. |
(7) 브랙치(Branche) 정보를 반드시 맞춰야 한다.
(8) 젠킨스를 실행하면 저장소에 저장된 파일이 젠킨스 workspace 폴더에 다운로드 된다.
workspace 폴더로 이동해서 asciidoctor 명령을 실행하면 workspace 폴더 아래에 Build 결과물(PDF, HTML)이 생성된다.
(9) 생성된 결과물을 웹서버로 배포하면 HTML로 매뉴얼 서비스가 가능하게 된다.