Atlassian Confluence 설치: 초보자를 위한 완벽한 가이드

효율적인 팀 협업과 지식 관리를 위해 Atlassian Confluence를 선택하셨나요?

이 가이드는 Confluence 설치 과정을 단계별로 안내하며, 설치 과정을 간소화하여 누구나 쉽게 따라 할 수 있도록 도와드립니다.

 

 

Confluence 주요 기능

• 문서 관리: 문서 생성, 편집, 공유를 통한 지식 중앙화
• 팀 협업 강화: 댓글, 멘션, 공유 기능을 통한 소통 촉진
• 사용자 정의: 템플릿, 매크로, 테마를 이용한 맞춤 설정
• 확장성: Jira, Bitbucket 등 다른 Atlassian 제품 및 서드파티 앱 연동

 

---

0. 설치 환경 (Environment)

본 가이드는 아래 환경을 기준으로 작성되었습니다.

• OS: Ubuntu 20.04.6 LTS
• JDK: OpenJDK 11
• Confluence: 8.5.5 LTS
• Database: PostgreSQL 14

 

1. 시스템 요구사항 확인

설치 전 서버 하드웨어 및 소프트웨어 요구사항을 확인하시기 바랍니다.

• 시스템 요구사항 (System Requirements)
• 하드웨어 요구사항 가이드
• 지원 플랫폼 (Supported Platforms)

 

2. PostgreSQL 설치 (Database)

2-1. 저장소 추가 및 설치

PostgreSQL 공식 저장소를 추가하고 14 버전을 설치합니다.

# 1. 저장소 추가
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'

# 2. 키 추가
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -

# 3. 패키지 업데이트 및 설치
sudo apt-get update
sudo apt-get install postgresql-14 -y

 

2-2. 외부 접속 허용 설정

외부에서 DB에 접근할 수 있도록 postgresql.conf를 수정합니다.

vim /etc/postgresql/14/main/postgresql.conf
---
# - Connection Settings -
listen_addresses = '*'          # localhost -> * 로 변경
---

 

2-3. 인증 방식 설정 (pg_hba.conf)

Confluence 서버 IP에서의 접근을 허용합니다.

vim /etc/postgresql/14/main/pg_hba.conf
---
# Local 접속 설정 (scram-sha-256 사용)
local   all             postgres                                peer
local   all             all                                     scram-sha-256

# IPv4/IPv6 접속 설정
host    all             all             127.0.0.1/32            scram-sha-256
host    all             all             ::1/128                 scram-sha-256

# [추가] Confluence Server 접근 허용
host    confldb         confldbadmin    192.168.31.172/24       scram-sha-256
---

 

2-4. DB 및 유저 생성

Confluence용 데이터베이스와 사용자를 생성합니다.

/* postgres 유저로 접속 */
sudo -u postgres psql

/* 유저 생성 */
CREATE USER confldbadmin PASSWORD 'confladmin';

/* DB 생성 (UTF-8) */
CREATE DATABASE confldb WITH OWNER confldbadmin ENCODING 'UTF-8';

/* 권한 부여 */
GRANT ALL PRIVILEGES ON DATABASE confldb TO confldbadmin;

/* 종료 */
\q

 

3. Confluence 설치 및 구성

3-1. Java (OpenJDK 11) 설치

Confluence 구동을 위한 JDK를 설치하고 환경 변수를 등록합니다.

# 설치
apt install openjdk-11-jdk -y

# 설치 경로 확인
dpkg -L openjdk-11-jdk

# 환경변수 등록 (.bashrc)
echo "export JAVA_HOME='/usr/lib/jvm/java-11-openjdk-amd64'" >> ~/.bashrc
source ~/.bashrc

 

3-2. 설치 파일 다운로드

Atlassian 아카이브에서 Linux용 .bin 파일을 다운로드합니다.

 

3-3. 설치 스크립트 실행

권한 부여 후 설치 스크립트를 실행합니다. (Express Install 권장)

chmod a+x atlassian-confluence-8.5.5-x64.bin
./atlassian-confluence-8.5.5-x64.bin

주요 설치 옵션 선택 과정입니다.

# 설치 유형 선택
Please choose one of the following:
Express Install ... [1], Custom Install ... [2], Upgrade ... [3]
Select: <1>

# 설치 확인
Install [i, Enter], Exit [e]
Select: 

# 서비스 시작
Start Confluence now?
Yes [y, Enter], No [n]
Select: 

 

3-4. 권한 및 홈 디렉토리 설정

# 소유권 변경
chown -R confluence:confluence /opt/atlassian/confluence/ /root/confluence/
chmod -R u=rwx,go-rwx /opt/atlassian/confluence/ /root/confluence/

# 홈 디렉토리 경로 수정
vim /opt/atlassian/confluence/confluence/WEB-INF/classes/confluence-init.properties
---
confluence.home = /root/confluence/
---

 

3-5. (선택) 포트 및 Context 변경

필요한 경우 server.xml을 수정하여 포트나 경로를 변경합니다.

vim /opt/atlassian/confluence/conf/server.xml

 

3-6. 서비스 시작

bash /opt/atlassian/confluence/bin/start-confluence.sh

 

4. 웹 초기 설정 (Web Setup)

브라우저에서 http://<Server IP>:8090으로 접속합니다.

1. 설치 유형: Production Installation 선택

 

2. 라이선스 입력: 발급받은 키 입력

 

3. 배포 유형: Non-clusterd (single node) 선택

 

4. 데이터베이스 연결: 설정한 PostgreSQL 정보 입력 후 Test Connection 진행

 

5. 콘텐츠 로드: 초보자라면 Example Site를 선택하여 구조를 익히는 것을 추천합니다.

 

6. 사용자 관리: Manage users within Confluence 선택

 

7. 관리자 계정 생성: 시스템 관리자 정보 입력

 

🎉 설치 완료

모든 설정이 완료되었습니다. 이제 팀원들을 초대하여 협업을 시작해보세요!