Atlassian Forge 설치하기

Atlassian Forge란

아틀라시안 사에서 만든 Cloud App 개발 플랫폼이다.

forge는 다른 방식에 비해 설정과 개발이 간단하고, 배포가 쉽다.
하지만 개발언어로 Node.js와 React를 사용해야 하는 제약이 있다.
현재 까지는 같은 아틀라시안 사의 Jira와 Confluence만 지원한다는 한계가 있다.

아래 그림의 과정의 실습을 통해 forge 개발을 이해하는게 목표다.

Forge 설치하기

사전 준비

• Node.js
  맥과 리눅스의 경우 nvm 으로 환경을 구성.

  nvm install --lts
  nvm use --lts

  • macOS를 사용할 경우 Forge CLI로 작업할 때 권한 오류가 발생한다.
    때문에 unsafe권한을 활성화 해야한다.

    npm config set unsafe-perm true

  윈도우는 Node.js 홈페이지에서 LTS 버전을 설치.

• Docker
  forge는 Docker 버전 17.03 이상 필요.
  

• 아틀라시안 회원가입 (로그인시 필요)
  http://go.atlassian.com/cloud-dev

Forge CLI 설치

1. npm을 사용하여 Forge CLI를 전역으로 설치.

sudo npm install -g @forge/cli

2. 설치 확인

forge --version

버전 표기 안될경우 설치 안된 것.

Atlassian API 토큰으로 로그인

1. https://id.atlassian.com/manage/api-tokens 클릭
2. API 토큰 생성 클릭
3. 토큰을 설명하는 레이블 입력 ex)forge-api-token
4. 만들기 클릭
5. 클립보드에 복사

CLI 로그인 명령어 실행

sudo forge login

Enter your email: [아틀라시안 아이디]
Enter your Atlassian API token: [발급받은 API 토큰]

로그인이 완료되면 아래와 같은 문구가 표시된다.

Logged in as [이름]

참고자료