클러스터 환경 설정
 |
이 페이지에서는 클러스터 환경 설정을 안내합니다. 이 설정은 생산 환경에 바로 사용할 수 있는 설정이 아니므로 클러스터링의 기초를 이해하는 데에만 사용해야 합니다. 아래의 예제 Compose 파일을 사용할 수 있으려면 Docker 이미지 빌더 스크립트를 사용하여 고유한 이미지를 빌드해야 합니다. 이미지 빌더 스크립트는 Codebeamer 2.2 이상 버전용 Docker 이미지 빌드에서 다운로드할 수 있습니다.
|
인프라 다이어그램
클러스터의 구성 요소에 대한 자세한 내용은 클러스터 구성 요소를 참조하십시오.
전제 조건
클러스터 환경을 설정하는 데 필요한 전제 조건은 다음과 같습니다.
부하 분산 장치
사용자 요청은 Codebeamer 실행 중에 분산되어야 합니다. 하드웨어 또는 소프트웨어 부하 분산 장치가 모두 작동할 수 있습니다. 자세한 내용은 부하 분산 장치 구성을 참조하십시오.
NFS
첨부 파일, 임시 파일 등이 네트워크 스토리지 솔루션에 저장되도록 지원하려면 실행 중인 모든 Codebeamer 인스턴스에 대해 이러한 파일이 표시되어야 합니다. 자세한 내용은 NFS를 사용하여 디렉터리 공유를 참조하십시오.
캐시
Codebeamer 서버는 Ehcache를 통해 자주 사용하는 데이터를 공유합니다.
피어 검색 솔루션
캐시 피어 검색에 대한 자세한 내용은 Ehcache의 캐시 복제 항목을 참조하십시오.
Codebeamer의 환경 변수
• CB_RMI_CACHE_HOSTNAME=codebeamer-app-server1 – 클러스터의 Codebeamer 노드 간에는 네트워크 통신에 필요합니다.
• CB_CLUSTER_ENABLED=true - 모든 Codebeamer 인스턴스에서 동일한 값으로 설정해야 합니다.
• CB_ping_testingEnabled=true - 캐시 테스트에 대해 true여야 합니다.
다음 설정이 필요합니다.
• CB_database_JDBC_Username=user - 데이터베이스 사용자 이름
• CB_database_JDBC_Password=pass - 데이터베이스 암호
• CB_database_JDBC_Driver=org.postgresql.Driver - 데이터베이스 드라이버
• CB_database_JDBC_ConnectionURL=jdbc:postgresql://codebeamer-db:5432/codebeamer - 데이터베이스 연결 URL
콜백이 올바르게 작동하려면 다음 설정을 올바르게 구성해야 합니다.
| | 변수 serverScheme, serverPort 및 localname은 다른 URL에서도 사용되므로 올바르게 구성해야 합니다. |
• CB_mail_localname=localhost - 전송된 이메일에 사용될 URL의 호스트 이름입니다. 예: example.com
• CB_mail_serverScheme=https - 전송된 이메일에 사용될 URL의 프로토콜입니다. 예: http/https
• CB_mail_serverPort=8443 - 전송된 이메일에 사용될 URL의 포트입니다. 예: 8443
다음 설정은 선택 사항이며 구체적인 요구 사항에 따라 달라집니다.
CB_mail_host=example-host.com - 이메일 서버의 호스트 이름입니다. 예: smtp.googlemail.com
| | 참고: CB_CONTEXT_PATH 매개 변수를 적용하면 컨텍스트 경로를 통해서만 인스턴스에 액세스할 수 있습니다. |
• CB_CONTEXT_PATH=cb - Codebeamer 컨텍스트 경로
• CB_REDIRECT_TO=localhost:8080/cb - Codebeamer 리디렉션 URL
• TZ=Europe/Berlin - 시간대
• WAIT_HOSTS=codebeamer-db:5432 - 대기할 데이터베이스
• WAIT_HOSTS_TIMEOUT=120 - 데이터베이스 시작에 필요한 대기 시간(초)
위의 예에서는 다음 설정이 사용되지 않습니다.
• CB_MAXHEAPSIZE - JVM의 Xmx 값입니다. 예: 2000
• JVM_MEMORY_RATIO - Jvm 메모리 비율 값입니다. 예: 0.6
• CB_MIN_AVAILABLE_MEMORY_PERCENTAGE - 사용 가능한 최소 메모리 비율입니다. 예: 90
• CB_MIN_AVAILABLE_PHYSICAL_MEMORY_PERCENTAGE - 사용 가능한 최소 물리적 메모리 비율입니다. 예: 0
• JVM_OPTIONS_OVERRIDE - Codebeamer의 기본 구성을 무시할 수 있습니다. 시작 시 기본값이 기록됩니다.
• JVM_OPTIONS - Codebeamer의 기본 구성을 확장할 수 있습니다. 시작 시 기본값이 기록됩니다.
• RESERVED_CODE_CACHE_SIZE_OVERRIDE - Codebeamer의 기본 구성을 무시할 수 있습니다. 시작 시 기본값이 기록됩니다.
• RESERVED_CODE_CACHE_SIZE - Codebeamer의 기본 구성을 확장할 수 있습니다. 시작 시 기본값이 기록됩니다.
• HEAPSIZE_OVERRIDE - Codebeamer의 기본 구성을 무시할 수 있습니다. 시작 시 기본값이 기록됩니다.
• HEAPSIZE - Codebeamer의 기본 구성을 확장할 수 있습니다. 시작 시 기본값이 기록됩니다.
• GC_OPT - Codebeamer의 기본 구성을 확장할 수 있습니다. 시작 시 기본값이 기록됩니다.
예제에 사용되는 부하 분산 장치의 환경 변수
부하 분산 장치의 기본값:
• TIMEOUT=600 - 요청 시간 초과(초)
• MAX_NUMBER_OF_CONNECTIONS=100 - 최대 연결 수
• MIN_NUMBER_OF_CONNECTION_POOL_ENTRIES=0 - 연결 풀에서 열린 상태로 유지되는 최소 연결 수
• ACQUIRE=3000 - 풀에서 연결 획득 시간 초과(밀리초)
• KEEPALIVE=On - TCP 연결을 열린 상태로 유지
• RETRY_TIMEOUT=1 - 실패 시 재시도 요청(초)
• IOBUFFERSIZE=8192 - I/O용 버퍼 크기
| | 이 예제에 사용되는 부하 분산 장치는 프로덕션 환경에서 사용할 준비가 되지 않았습니다. |
Codebeamer의 볼륨 및 공유 폴더
클러스터형 환경에서 원활한 작업과 데이터 일관성을 보장하려면 볼륨의 컨테이너 경로를 모든 Codebeamer 노드 간에 공유해야 합니다. 디렉터리 및 컨테이너 경로 목록을 보려면 NFS를 사용하여 디렉터리 공유를 참조하십시오.