Atlassian application tunnel 로 On-Prem 과 Cloud 연결하기

App tunnel 이란?

Atlassian Cloud를 사용하거나 사용할 계획이지만 migration 기간동안 On-Premise 환경에서 Confluence 와 Jira 를 사용할 경우가 있습니다.

이런 경우 서로 다른 네트워크에 존재하여 각각의 데이터를 참고하기 어려워지는 문제가 있습니다.

즉 Cloud 에 새로 만든 Confluence 에서 On-premise 환경에 있는 Confluence Page나 JIRa Issue 참조하지 못하고 On-Premise 에 있는 Jira 에서도 Cloud 에 있는 Jira 이슈나나 Confluence 페이지를 연결할 수 없습니다.

App tunnel 은 이런 문제를 해결하기 위해 개발된 plugin 으로 Server 나 Data Center 에 설치하면 Cloud 에 있는 제품과 Application Link 로 연결할 수 있으므로 같은 네트워크에 있는 제품처럼 양방향으로 서로의 데이터를 참조할 수 있습니다.

App tunnel 의 전체 구성도는 위와 같으며 다음과 같은 구성을 갖고 있습니다.

Tunnel server: 사용하는 Cloud 제품이 tunnel server 역할을 수행하며 설정은 관리자 페이지인admin.atlassian.com 에서 할 수 있습니다.
Tunnel client: On-premise 에 있는 Confluence 나 Jira 제품이 Tunnel client 입니다.
Application link (cloud): You create a tunneled application link in each of your cloud products and point it at an existing tunnel. You can link multiple cloud products to a single tunnel. The application link must always be created on the cloud side.
Application link (self-managed): The reciprocal link will be automatically created in your self-managed instance. Only incoming connections to your network use the tunnel, the outgoing ones will reach your cloud products directly.

제약 사항

각 on-premise instance 는 하나의 cloud instance 와 tunnel 구성이 가능합니다. 여러 개의 instance 가 있을 경우 개별 instance 마다 tunnel 을 구성해야 합니다.

사전준비

나가는 방화벽 포트 오픈

Application tunnel 은 https://tunnel.services.atlassian.com 에 연결할 수 있어야 제대로 동작하므로 On-premise 에 있는 Confluence/Jira/Bamboo 에서 저 서버의 443 포트로 연결할 수 있도록 방화벽 정책을 수정합니다.
On-premise 에 있는 제품이 Atlassian Cloud 에 연결할 수 있도록 나가는 방화벽 정책을 수정합니다. Cloud IP 는 여기에서 확인할 수 있습니다.
Cloud 에서 On-premise 에 연결할 수 있도록 Cloud IP 의 In Bound rules 을 수정합니다.

HTTP connector 와 upstream port 설정

연결하려는 instance 를 중지하고 conf/server.xml 을 열고 다음 커넥터를 추가합니다.

Confluence

<Connector port="8093" connectionTimeout="20000" maxThreads="200" minSpareThreads="10" 
                   enableLookups="false" acceptCount="10" URIEncoding="UTF-8" />

bin/setenv.sh 를 에디터로 열고 다음 내용을 추가합니다.

## export CATALINA_OPS 앞에 와야 합니다.
CATALINA_OPTS="-Dsecure.tunnel.upstream.port=8093"

export CATALINA_OPTS

이제 bin/startup.sh 를 실행해서 Confluence 를 재구동합니다.

Jira

<Connector port="8081" connectionTimeout="20000" maxThreads="200" minSpareThreads="10" 
                   enableLookups="false" acceptCount="10" URIEncoding="UTF-8"
                   relaxedPathChars="[]|" relaxedQueryChars="[]|{}^&#x5c;&#x60;&quot;&lt;&gt;"/>

bin/setenv.sh 를 열고 JVM_SUPPORT_RECOMMENDED_ARGS 에 다음 내용을 추가합니다.

JVM_SUPPORT_RECOMMENDED_ARGS="-Dsecure.tunnel.upstream.port=8081"

Jira 를 재구동합니다.

Bamboo

<Connector port="8093" connectionTimeout="20000" maxThreads="200" minSpareThreads="10" 
                   enableLookups="false" acceptCount="10" URIEncoding="UTF-8" />