전체 문서

Getting Started

CICDoo란 시작하기: 온보딩 마법사 대시보드와 인프라 맵

Concepts

프로덕션, 스테이징, 개발 스테이지 도메인, 서브도메인, SSL Odoo 버전과 에디션 (Community와 Enterprise) 워크스페이스와 팀 협업

Servers

서버 추가하기 서버 도메인과 DNS 로드 밸런서 사용하기 점프 서버를 통해 연결하기 서버 작업: 배포, 로그, 차트 Deleting a server

Projects & Git

프로젝트 만들기 GitHub 연결하기 Project GitHub settings and webhook GitLab 연결하기 브랜치와 인스턴스 프로젝트에 태그 달기와 필터링 앱 노드를 이용한 고가용성 Project environments, extensions and deletion

Instances & Console

인스턴스 만들기 인스턴스 재시작, 중지, 삭제 스테이지 간 브랜치 병합 웹 IDE와 원격 접속 SSH access to instances 인스턴스 설정 설명 배포와 작업 큐

Agent Tasks

에이전트 작업이란 에이전트 작업 설정하기 작업 실행과 결과 검토 에이전트 시간과 추가 구매 Agent insights and task filters

Monitoring & Backups

인스턴스 모니터링 백업과 복원 S3 storage, uploads and bulk backup actions 경고 알림 (이메일과 SMS)

Workspaces & Permissions

워크스페이스 멤버 초대하기 멤버 권한과 리소스 접근 멤버가 리소스를 보거나 사용할 수 없습니다 Audit log and server activity

Account & Security

2단계 인증 (2FA) 프로필과 연동 설정 비밀번호와 계정 복구 Instance security score and checks The Security page: every instance and member at a glance

Billing & Plans

요금제와 가격 업그레이드와 구독 관리 프로젝트 구독이 미납된 경우 채널 파트너 프로그램 Onboarding a client as a partner

Support & Tickets

지원 티켓 열기 CICDoo 팀에 도움 요청하기

Troubleshooting

문제 해결: 서버를 연결할 수 없습니다 문제 해결: 배포가 실패했습니다 문제 해결: 저장소를 옮긴 뒤 git push가 403으로 실패합니다 문제 해결: 인스턴스가 중단되거나 느립니다 문제 해결: 도메인 또는 SSL 문제

프로젝트 및 Git

앱 노드를 이용한 고가용성

데이터베이스를 실행하는 기본 프로젝트와 이를 서비스하는 앱 노드로, 하나의 프로덕션 Odoo 데이터베이스를 여러 서버에서 실행하는 방법을 설명합니다.

작동 방식

고가용성을 사용하면 하나의 Odoo 데이터베이스의 프로덕션을 여러 서버에서 동시에 실행할 수 있습니다. 한 서버가 응답하지 않으면 방문자는 다른 서버로 보내집니다.

클러스터는 같은 코드를 실행하는 프로젝트들로 구성됩니다:

  • 기본 프로젝트: 프로덕션 인스턴스가 Odoo와 데이터베이스를 실행하는 프로젝트입니다. 이 데이터베이스는 앱 노드에만 열려 있고 그 외에는 누구에게도 열려 있지 않습니다.
  • 앱 노드: 각각 다른 프로덕션 서버에 있는 다른 프로젝트로, 프로덕션 인스턴스가 Odoo만 실행하고 기본 프로젝트의 데이터베이스를 사용합니다.
  • 복제본: 기본 프로젝트 데이터베이스의 대기 사본을 자체 서버에도 유지하여, 기본 프로젝트를 잃으면 대신 맡을 준비가 된 앱 노드입니다.

방문자는 기본 프로젝트의 주소를 사용합니다. CICDoo는 그 주소가 기본 프로젝트와 응답 중인 모든 앱 노드를 가리키도록 하고, 몇 분마다 각 노드를 확인합니다. 응답하지 않는 노드는 회복될 때까지 주소에서 제외됩니다.

데이터베이스 자체는 기본 프로젝트의 서버 한 대에서 실행됩니다. 앱 노드는 Odoo 쪽을 이중화합니다. 데이터베이스까지 보호하려면 복제본을 추가하세요. 기본 프로젝트의 서버를 잃으면 복제본을 승격하고, 사이트는 그 사본으로 계속 운영됩니다. 아래의 "복제본과 장애 조치"를 참고하세요.

시작하기 전에

  • 같은 코드: 클러스터의 모든 프로젝트는 같은 저장소, 기본 브랜치, Odoo 버전, 에디션을 사용해야 합니다. Time Machine이 켜져 있다면 고정된 커밋도 일치해야 합니다.
  • 서로 다른 서버: 각 앱 노드에는 기본 프로젝트 및 다른 노드의 서버와 다른, 자체 프로덕션 서버가 있어야 합니다.
  • Cloudflare 프록시: 현재 노드 간 트래픽 분산은 Cloudflare 프록시가 활성화된 서버에서 작동합니다. 앱 노드가 제공하는 모든 페이지가 기본 프로젝트의 데이터베이스와 통신하므로 같은 리전의 서버를 사용하세요.
  • 공유 파일스토어: 클러스터의 모든 서버는 Odoo 파일스토어용으로 같은 공유 스토리지를 마운트해야 합니다. 그렇지 않으면 한 노드를 통해 업로드한 첨부 파일이 다른 노드에는 없고, 다른 노드로 연결된 방문자는 로그아웃됩니다. 설정에 도움이 필요하면 지원팀에 문의하세요.
  • 데이터베이스 연결: 각 앱 노드는 기본 프로젝트의 데이터베이스에 자체 연결을 엽니다. 노드를 추가할수록 기본 프로젝트 프로덕션 인스턴스 콘솔의 설정 탭에 있는 PostgreSQL 설정에서 max_connections를 높이세요.
  • 복제본 개수: 복제본마다 자체 프로덕션 서버가 필요합니다. PostgreSQL 기본 설정에서 기본 프로젝트 하나는 복제본 약 9개를 공급할 수 있으며, 각 복제본은 뒤처져 있는 동안 기본 프로젝트 디스크에 최대 20 GB의 변경 사항을 보관시킬 수 있습니다.

고가용성 설정은 프로젝트 설정의 고급 탭, 고가용성 카드에 있습니다. 프로젝트 설정을 변경할 권한이 필요합니다.

기본 프로젝트 설정하기

데이터베이스를 실행할 프로젝트를 열고 프로젝트 설정 > 고급으로 이동한 다음, 고가용성에서 역할을 기본 (앱 + 데이터베이스)로 설정합니다. 적용을 클릭하고 확인합니다.

프로덕션 인스턴스가 재시작됩니다. 다시 올라오면 그 데이터베이스는 클러스터의 앱 노드로부터 연결을 받습니다. 서버들이 사설 네트워크를 공유하지 않는 한 서버 간 연결은 암호화됩니다.

프로덕션 인스턴스는 자체 번들 데이터베이스를 사용해야 합니다. 프로덕션 인스턴스가 외부 데이터베이스를 가리키는 프로젝트는 기본 프로젝트가 될 수 없습니다.

앱 노드 추가하기

평소처럼 노드용 프로젝트를 만듭니다. 같은 저장소와 기본 브랜치, 같은 버전과 에디션, 그리고 자체 프로덕션 서버를 사용합니다. 그 프로젝트에 있는 스테이징 및 개발 인스턴스는 모두 제거하세요. 앱 노드는 프로덕션만 실행하며, 스테이징과 개발 브랜치는 기본 프로젝트에 둡니다.

그런 다음 노드의 프로젝트 설정 > 고급을 열고, 역할을 앱 노드 (기본 프로젝트의 데이터베이스 사용)로 설정한 뒤 데이터베이스 원본에서 기본 프로젝트를 선택하고, 적용을 클릭해 확인합니다. 같은 워크스페이스에서 같은 코드를 실행하는 기본 프로젝트만 선택지에 나타납니다.

노드는 바로 시작되지 않습니다. 먼저 기본 프로젝트의 서버가 노드를 허용해야 하며, 이는 다음 확인 때 이루어지고 보통 5분 이내입니다. 그때까지 카드에는 "기본 프로젝트가 이 노드를 허용하기를 기다리는 중입니다"가 표시되고, 허용되는 즉시 노드가 자동으로 시작됩니다. 노드가 응답하기 시작하고 몇 분 뒤부터 방문자를 받기 시작합니다.

기본 프로젝트에서는 고가용성 카드에 앱 노드 목록과 데이터베이스 서버가 현재 접근 목록을 적용했는지 여부가 표시됩니다.

복제본과 장애 조치

복제본은 기본 프로젝트 데이터베이스의 대기 사본도 함께 실행하는 앱 노드입니다. 기본 프로젝트가 모든 변경 사항을 스트리밍하므로 사본은 보통 몇 초 정도만 뒤처집니다. 복제본의 Odoo는 다른 앱 노드처럼 기본 프로젝트의 데이터베이스를 사용해 방문자에게 서비스합니다.

복제본을 추가하려면 앱 노드와 똑같이 프로젝트를 준비한 뒤 역할을 복제본 (앱 노드 + 데이터베이스 대기 사본)으로 설정하고, 데이터베이스 원본에서 기본 프로젝트를 선택한 다음 적용을 클릭합니다. 기본 프로젝트는 PostgreSQL 13 이상(Odoo 15부터 기본값)을 실행해야 하며, 복제본도 같은 PostgreSQL 버전을 사용해야 합니다. 합류하면 복제본 프로젝트의 자체 데이터베이스가 사본으로 대체되며, 기존 데이터는 삭제되지 않고 서버에 따로 옮겨 보관됩니다. 데이터베이스가 크면 첫 복사에 시간이 걸립니다.

복제본의 고가용성 카드에 사본의 상태가 표시됩니다.

  • 복사 중: 첫 사본을 만드는 중입니다.
  • 새 기본으로 전환 중: 다른 복제본이 승격되어 이 사본이 그쪽으로 전환하고 있습니다. 이미 가진 데이터를 유지하므로 보통 금방 끝납니다.
  • 스트리밍 중: 사본이 기본 프로젝트를 따라가고 있습니다.
  • 지연됨: 사본이 수백 MB 이상 뒤처졌거나 잠시 따라가기를 멈췄습니다.
  • 손상됨: 기본 프로젝트가 더 이상 사본에 필요한 변경 사항을 보관하지 않습니다. 새 사본을 만들려면 사본 다시 빌드를 클릭하세요.

기본 프로젝트의 서버를 잃었다면 복제본의 고가용성 카드를 열고 기본으로 승격을 클릭한 뒤 프로젝트 이름을 입력해 확인합니다. 복제본의 데이터베이스가 클러스터의 데이터베이스가 되고, 복제본이 기본 프로젝트가 되며, 다른 모든 노드는 이를 기준으로 다시 시작합니다. 사이트 주소는 그대로 유지됩니다. 이전 기본 프로젝트는 앱 노드가 됩니다. 서버가 돌아오면 자체 데이터베이스 없이 시작하며, 그렇게 다시 시작하기 전까지는 방문자를 받지 않습니다. 사본이 마지막으로 따라잡은 이후 이전 기본 프로젝트에서 생긴 변경 사항은 사라지므로, 기본 프로젝트를 복구할 수 없을 때만 승격하세요. 승격은 절대 자동으로 일어나지 않습니다. 다른 복제본은 기존 사본을 유지한 채 새 기본으로 전환합니다. 어떤 복제본이 승격된 복제본보다 앞서 있었다면 그에 맞게 되감기하며, 그것이 불가능할 때만 데이터베이스를 다시 복사합니다. 복제본 카드에 다른 복제본의 사본이 더 최신이었다고 표시되면 그 복제본을 승격하세요. 잃는 변경 사항이 줄어듭니다.

복제본은 기본 프로젝트의 PostgreSQL 설정을 사용합니다. 기본 프로젝트 프로덕션 인스턴스의 PostgreSQL 구성을 변경한 뒤에는 복제본을 다시 시작하세요.

복제본에서 읽기

Odoo 18 이상에서는 클러스터의 모든 프로젝트가 읽기 전용 작업을 복제본으로 보낼 수 있습니다. 목록 및 양식 보기, 그룹화 보기, 보고서, 내보내기가 해당됩니다. 모든 쓰기는 여전히 기본 프로젝트로 가며, 쓰기가 필요한 것으로 드러난 요청은 그곳에서 자동으로 다시 시도됩니다. 이렇게 하면 기본 프로젝트의 데이터베이스 서버 부하가 줄어듭니다.

프로젝트의 프로젝트 설정 > 고급을 열고, 고가용성 카드의 읽기 전용 쿼리에서 복제본을 선택한 뒤 적용을 클릭합니다. 복제본은 자신의 사본에서 읽을 수도 있습니다. 복제본이 허용하면 프로젝트가 다시 시작되며, 보통 5분 안에 완료됩니다.

복제본에서 읽은 데이터는 기본 프로젝트보다 잠시 늦을 수 있습니다. 복제본이 뒤처지거나 멈추거나 손상되면 CICDoo가 읽기 클라이언트에 대해 복제본을 닫고, Odoo는 다시 시작하지 않고 스스로 기본 프로젝트로 돌아갑니다. 복제본이 다시 스트리밍하면 약 30분 안에 읽기가 복제본으로 돌아갑니다.

앱 노드에서 달라지는 점

  • 프로덕션 인스턴스에 자체 데이터베이스가 없습니다. 데이터베이스 설정은 CICDoo가 관리하며 인스턴스의 Odoo 구성에서 변경할 수 없습니다.
  • 예약 작업(Odoo cron)은 기본 프로젝트에서만 실행됩니다.
  • 백업은 기본 프로젝트에서 수행됩니다. 클러스터 데이터베이스의 백업과 복원은 기본 프로젝트에서 하세요.
  • 앱 노드의 브랜치에 푸시하는 것만으로는 아무 일도 일어나지 않습니다. 클러스터는 기본 프로젝트에서 업데이트됩니다.
  • 앱 노드의 콘솔에서는 데이터베이스 셸, 백업, PostgreSQL 설정이 숨겨지며, 이들은 기본 프로젝트에 있습니다. 복제본은 데이터베이스 셸을 유지하며, 이 셸은 읽기 전용 사본을 엽니다.

업데이트 배포하기

평소처럼 기본 프로젝트의 브랜치에 푸시합니다. 그러면 CICDoo가 클러스터 전체를 순서대로 업데이트합니다:

  1. 각 앱 노드를 중지합니다.
  2. 다른 서버가 데이터베이스를 사용하지 않는 동안 모듈 업그레이드를 포함해 기본 프로젝트를 업데이트합니다.
  3. 각 앱 노드를 새 코드로 다시 시작합니다.

각 단계는 그 단계가 실행되는 인스턴스의 큐 탭에서 확인할 수 있습니다. 기본 프로젝트의 업데이트가 실패하면 앱 노드는 다시 시작되지 않으며, 해당 큐 항목에 이유가 표시됩니다. 문제를 해결하고 다시 배포하세요.

모듈 업그레이드는 데이터베이스를 단독으로 사용해야 하므로, 단일 인스턴스와 마찬가지로 기본 프로젝트가 업데이트되는 동안 사이트를 사용할 수 없습니다.

클러스터에서 나가기

앱 노드를 제거하려면 역할을 다시 독립 (자체 데이터베이스)으로 설정하고 적용을 클릭합니다. 노드 자체의 데이터베이스에는 클러스터의 데이터가 없으므로 프로덕션 인스턴스가 중지됩니다. 다시 시작하기 전에 백업을 복원하세요.

기본 프로젝트는 앱 노드가 남아 있는 동안에는 변경할 수 없습니다. 먼저 노드를 제거하세요.

문제 해결

  • 노드가 계속 허용을 기다립니다: 기본 프로젝트의 프로덕션 인스턴스가 실행 중이고 그 서버가 온라인인지 확인하세요. 기본 프로젝트가 된 뒤 한 번 재시작해야 어떤 노드든 허용됩니다.
  • 노드는 시작되지만 Odoo가 올라오지 않습니다: 노드의 로그를 여세요. 기본 프로젝트의 데이터베이스가 초기화되지 않았다는 메시지가 있다면 기본 프로젝트가 첫 시작을 아직 마치지 않은 것입니다.
  • 업로드나 로그인이 노드 간에 방문자를 따라가지 않습니다: 서버들이 파일스토어를 공유하지 않고 있습니다. 위의 "시작하기 전에"를 참고하세요.
  • 복제본이 복사 중에서 넘어가지 않음: 기본 프로젝트의 프로덕션 인스턴스가 실행 중인지 확인하세요. 기본 프로젝트가 복제본을 허용하면 복사가 시작되며, 큐 탭에 있는 복제본의 재시작 항목에서 진행 상황이나 오류를 볼 수 있습니다.

인스턴스가 브랜치에 어떻게 대응되는지는 브랜치와 인스턴스를, 별개 기능인 서버 수준의 로드 밸런서 설정은 로드 밸런서 사용하기를 참고하세요.

CICDoo로 내 서버에서 직접 실행하세요

서버를 연결하고 저장소를 연동하세요. 배포, 백업, 모니터링이 이미 설정되어 있고 Odoo 엔지니어는 메시지 한 통이면 됩니다.

여전히 해결되지 않나요? 앱에서 티켓을 열거나 엔지니어와 상담하세요.