지점¶

전체보기¶

브랜치 보기에서는 저장소에 있는 다양한 브랜치에 대한 전체보기를 확인할 수 있습니다.

단계¶

Odoo.sh에서 브랜치에는 프로덕션, 스테이징 및 개발의 세 가지 단계가 있습니다.

브랜치의 스테이지를 섹션 제목으로 끌어다 놓으면 스테이지를 변경할 수 있습니다.

생산¶

이 브랜치는 프로덕션 데이터베이스가 실행되는 코드가 있는 브랜치입니다. 프로덕션 브랜치는 하나만 둘 수 있습니다.

이 브랜치에 새 커밋을 푸시할 경우, 프로덕션 서버에 있는 코드가 새로운 버전으로 업데이트된 다음 다시 시작됩니다.

양식 보기를 변경하는 것과 같이 모듈을 업데이트해야 하는 변경 사항이 자동으로 수행되도록 하려면 해당 모듈의 매니페스트 (__manifest__.py)에서 모듈의 버전 번호를 늘리도록 합니다. 그러면 플랫폼이 유지 관리상의 이유로 인스턴스를 일시적으로 사용할 수 없게 만들어 그 동안 업데이트를 수행합니다.

이 방법은 앱 메뉴를 통하거나 명령줄 에 있는 -u 스위치를 통해 모듈 업그레이드를 수행하는 것과 동일한 방법입니다.

커밋 변경 사항때문에 서버가 다시 시작되지 않거나 모듈 업데이트에 실패하는 경우, 서버는 자동으로 이전에 성공한 코드 수정 버전으로 되돌아가고 데이터베이스는 업데이트 전으로 롤백됩니다. 업데이트에 실패한 로그에도 계속 액세스할 수 있으므로 문제를 해결할 수 있습니다.

데모 데이터는 프로덕션 데이터베이스에서 사용되지 않으므로 로드되지 않습니다. 업데이트 중에 프로덕션 데이터베이스를 사용할 수 없는 시간이 늘어나므로 단위 테스트는 수행되지 않습니다.

파트너가 평가판 프로젝트를 사용 중인 경우, 모든 스테이징 브랜치와 함께 프로덕션 브랜치가 30일 후에는 자동으로 개발 단계로 설정이 되돌아간다는 점에 유의해야 합니다.

스테이징¶

스테이징 브랜치는 프로덕션 데이터를 사용하여 새로운 기능을 테스트하기 위한 것으로, 테스트 레코드가 있는 실제 프로덕션 데이터는 손상시키지 않습니다. 프로덕션 데이터베이스에 대해 중립화된 복사본을 데이터베이스로 생성합니다.

중립화에 포함되는 내용으로는:

• 예약된 작업을 비활성화합니다. 테스트를 해 보려면 수동으로 작업을 트리거하거나 다시 활성화할 수 있습니다. 아무도 데이터베이스를 사용 중이지 않은 경우에는 리소스를 절약하기 위해 플랫폼에서 트리거되는 빈도가 줄어든다는 점에 유의합니다.

• 메일 캐처로 이메일을 중간에 가져가서 발신 이메일을 비활성화합니다. 데이터베이스에서 발신 이메일을 볼 수 있는 인터페이스가 제공됩니다. 이렇게 하면 연락처에 테스트 이메일을 보내는 것에 대해 염려할 필요가 없습니다.

• 테스트 모드에서 결제대행업체 및 배송업체를 설정합니다.

• IAP 서비스 비활성화하기

가장 최근의 데이터베이스는 무기한 보존되며, 같은 브랜치의 오래된 데이터베이스는 새 데이터베이스를 위한 공간을 확보하기 위해 가비지 컬렉션될 수 있습니다. 이러한 데이터베이스는 3개월 동안 유효하며, 그 이후에는 브랜치를 다시 빌드해야 합니다. 이러한 데이터베이스에서 구성 또는 보기 변경을 구현하는 경우 이를 문서화하거나 XML 데이터 파일을 사용하여 브랜치의 모듈에 직접 삽입하여 기본 구성 또는 보기를 재정의하는 것이 중요합니다.

Odoo에서 단위 테스트는, 현재 프로덕션 데이터베이스에 로드가 되지 않은 데모 데이터에 의존하기 때문에 실행되지 않습니다. 앞으로 Odoo가 데모 데이터 없이 단위 테스트가 실행되도록 지원한다면 Odoo.sh는 스테이징 데이터베이스에서 테스트를 실행하는 것을 고려하겠습니다.

개발¶

개발 브랜치에서는 데모 데이터로 새 데이터베이스를 생성하여 단위 테스트를 실행합니다. 설치된 모듈은 브랜치에 있는 모듈입니다. 프로젝트 설정.에서 설치할 모듈 목록을 변경할 수 있습니다.

이와 같은 브랜치 중 하나에 새 커밋을 푸시하면 처음부터 새로 생성되고 브랜치가 변경되어 새 서버가 시작됩니다. 데모 데이터를 블러와서 기본값으로 단위 테스트가 수행됩니다. 이를 통해 변경 사항 때문에 테스트한 기능이 손상되지 않았는지 확인합니다. 원하는 경우 테스트를 비활성화하거나 :ref:`브랜치 설정 <odoosh-gettingstarted-branches-tabs-settings>`에서 사용자 정의 태그를 사용하여 특정 테스트가 실행되도록 허용할 수 있습니다.

스테이징 브랜치와 마찬가지로 이메일은 전송되지 않지만 메일 수집기를 이용하여 차단되고 데이터베이스가 사용 중인 경우가 아니면 예약된 작업은 트리거되지 않습니다.

개발 브랜치용으로 생성된 데이터베이스는 약 3일 정도 사용할 수 있습니다. 그 후에는 새 데이터베이스를 위한 공간을 확보하기 위해 사전 안내 없이 자동으로 휴지통으로 이동될 수 있습니다.

브랜치 병합하기¶

브랜치를 서로 끌어다 놓는 방식으로 쉽게 병합할 수 있습니다.

프로덕션 데이터를 사용하여 개발 브랜치의 변경 사항을 테스트하려는 경우 다음 중 선택할 수 있습니다.

• 개발 브랜치를 원하는 스테이징 브랜치에 끌어다 놓고 스테이징 브랜치에 병합합니다.

• 개발 브랜치를 스테이징 섹션 제목에 끌어다 놓아서 스테이징 브랜치가 되도록 합니다.

최근 변경한 내용을 프로덕션에 적용할 준비가 끝나면, 스테이징 브랜치를 프로덕션 브랜치로 끌어다 놓아서 최신 기능을 프로덕션에 병합하고 배포할 수 있게 합니다.

과감하게 개발 브랜치를 프로덕션 브랜치에 병합할 수도 있습니다. 이는 스테이징 브랜치로 프로덕션 데이터에 대한 변경 사항 승인을 생략한다는 의미에 불과합니다.

개발 브랜치를 서로, 또한 스테이징 브랜치를 서로 병합할 수 있습니다.

물론 워크스테이션에서 직접 :code:`git merge`를 사용하여 브랜치를 병합할 수도 있습니다. 브랜치에 새로운 개정 사항이 푸시되면 Odoo.sh에서 알림을 받게 됩니다.

프로덕션 브랜치에 스테이징 브랜치를 병합하는 경우 소스 코드만 병합됩니다. 스테이징 데이터베이스에서 변경한 설정 내용은 프로덕션 데이터베이스로 이전되지 않습니다.

스테이징 브랜치에서 환경 설정에서 변경한 사항을 테스트하고 프로덕션에 적용하려면 다음 중에서 선택하여 진행해야 합니다.

• 브랜치의 기본 환경 설정이나 기본 화면을 재지정하도록 XML 데이터 파일에 설정 변경 사항을 기재한 다음 매니페스트 (__manifest__.py)에서 모듈 버전을 높여서 스테이징 브랜치를 병합할 때 모듈 업데이트가 트리거되도록 합니다. 이는 설정 변경에 Git 버전 관리 기능을 사용하여 변경 사항을 추적할 수 있으므로 개발 확장성을 향상시키는 데 가장 좋은 방법입니다.

• 스테이징에서 프로덕션 데이터베이스로 복사/붙여넣기를 통해 직접 이전합니다.

탭¶

기록¶

브랜치 이력에 대한 개요:

• 커밋 및 커밋 작성자 메시지,

• 스테이지 변경이나 데이터베이스 가져오기, 백업 복원 등 플랫폼과 연결된 다양한 이벤트입니다.

각 이벤트의 상태는 오른쪽 상단 모서리에 표시됩니다. 데이터베이스에서 진행 중인 작업 (설치, 업데이트, 백업 가져오기 등)이나 해당 결과 (테스트 피드백, 백업 가져오기 성공 등)에 대한 정보를 확인할 수 있습니다. 작업이 성공하면 연결 버튼을 누르면 데이터베이스에 액세스할 수 있습니다.

메일¶

이 탭에는 메일 수집기가 포함되어 있습니다. 여기에서 데이터베이스에서 전송된 이메일에 대한 전반적인 내용을 확인할 수 있습니다. 메일 수집기는 개발 및 스테이징 브랜치에서 사용할 수 있으며 .프로덕션 데이터베이스의 이메일이 남겨져 있는 대신 실제로 전송될 수 있게 됩니다.

셸¶

컨테이너에 대한 셸 액세스입니다. 기본 Linux 명령어 (ls, top)로 진행하고 :code:`psql`을 입력하면 데이터베이스에서 셸을 열 수 있습니다.

탭을 여러 개 열고 드래그 앤 드롭 기능을 통해 원하는 대로 레이아웃을 정렬할 수 있습니다. 예를 들어, 나란히 배치해 보세요.

편집기¶

소스 코드를 편집할 수 있는 온라인 통합 개발 환경 (IDE)입니다. 터미널, Python 콘솔 및 Odoo 셸 콘솔까지 열 수 있습니다.

탭을 여러 개 열고 드래그 앤 드롭 기능을 통해 원하는 대로 레이아웃을 정렬할 수 있습니다. 예를 들어, 나란히 배치해 보세요.

모니터링¶

이 링크에는 현재의 빌드에 대한 다양한 모니터링 측정 항목이 있습니다.

각 그래프에서 확대/축소하거나, 시간 범위를 변경할 수 있으며, 특정한 측정 항목을 선택할 수 있습니다. 그래프에서 주석으로 빌드 변경 사항 (데이터베이스 가져오기, git push 등)과 관련된 정보를 안내할 수 있습니다.

로그¶

뷰어로 서버 로그를 살펴볼 수 있습니다.

다양한 로그를 사용할 수 있습니다.

• install.log: 데이터베이스 설치 로그입니다. 개발 브랜치에는 테스트 로그가 포함되어 있습니다.

• pip.log: Python 종속성 설치 로그입니다.

• odoo.log: 실행 중인 서버의 로그입니다.

• update.log: 데이터베이스 업데이트 로그입니다.

• pg_long_queries.log: 소요 시간이 비정상적인 psql 쿼리의 로그입니다.

로그에 새로운 줄이 추가되면 자동으로 표시됩니다. 맨 아래로 스크롤을 이동하면 새 줄이 추가될 때마다 브라우저가 자동으로 스크롤이 이동됩니다.

화면에서 오른쪽 상단에 있는 해당 버튼을 클릭하면 로그 가져오기를 일시 중지할 수 있습니다. 로그 가져오기는 5분 후에 자동으로 중지됩니다. 재생 버튼을 사용하여 다시 시작할 수 있습니다.

백업¶

다운로드 및 복원할 수 있는 백업 목록, 수동 백업 수행 및 데이터베이스 가져오기 기능입니다

Odoo.sh에서는 프로덕션 데이터베이스가 매일 백업됩니다. 매일 7회, 매주 4회, 매월 3회 백업이 진행됩니다. 백업에는 데이터베이스 덤프, 파일 저장소(첨부 파일, 바이너리 필드), 로그 및 세션을 포함하여 백업됩니다.

스테이징 및 개발 데이터베이스는 백업되지 않습니다. 다만 스테이징 브랜치에서 테스트 목적으로 프로덕션 데이터베이스의 백업을 복원하거나 프로덕션 데이터베이스에서 실수로 삭제된 데이터는 수기로 복구할 수 있습니다.

이 목록에는 프로덕션 데이터베이스가 호스팅되는 서버에 보관된 백업이 포함되어 있습니다. 서버에는 한 달 분량의 백업으로 일일 7회 백업, 주간 4회 백업만 보관됩니다.

전용 백업 서버는 백업을 동일하게 진행하되 월간 3회를 추가로 백업합니다. 월별 백업 중 하나를 복원하거나 다운로드하려면 `문의하기 <https://www.odoo.com/help>`_로 연락주시기 바랍니다.

하나 또는 여러 모듈 (__manifest__.py) 또는 관련 Python 종속성 (requirements.txt)의 버전을 업데이트하는 커밋을 병합하면 Odoo.sh는 자동으로 백업을 시작합니다. (목록에 업데이트 유형으로 표시) 이는 새 pip 패키지를 설치하여 컨테이너가 변경되거나 후속 모듈 업데이트를 통해 데이터베이스 자체가 변경될 수 있으므로 필요합니다. 두 가지 경우 모두 문제 발생의 잠재적 위험을 완화하기 위해 백업을 수행하는 것이 필수적입니다.

앞서 언급한 수정 없이 코드만 변경하는 커밋을 병합하는 경우, Odoo.sh는 백업을 수행하지 않습니다. 이는 컨테이너나 데이터베이스가 수정되지 않아 플랫폼이 충분히 안전하다고 판단하기 때문입니다. 추가적인 예방 조치로, 예상치 못한 문제가 발생할 경우를 대비하여 프로덕션 소스에 중요한 변경 사항을 적용하기 전에 수동으로 백업을 생성할 수 있습니다. (이러한 수동 백업은 약 1주일 동안 액세스할 수 있음) 오용을 방지하기 위해 수동 백업은 하루에 5개로 제한합니다.

데이터베이스 가져오기 기능을 통해 다음 형식으로 데이터베이스에 보관할 수 있습니다.

• 표준 Odoo 데이터베이스 관리자 (/web/database/manager 아래에 있는 Odoo 온프레미스 서버에서 사용 가능)

• Odoo 온라인 데이터베이스 관리자,

• 이 백업 탭에 있는 Odoo.sh 백업 다운로드 버튼,

• :ref:`빌드 화면 <odoosh-gettingstarted-builds>`에 있는 Odoo.sh 덤프 다운로드 버튼.

업그레이드¶

유효한 프로젝트에서 프로덕션 및 스테이징 브랜치에 사용할 수 있습니다.

설정¶

여기에는 현재 선택한 브랜치에만 적용되는 설정이 몇 가지 있습니다.

새로운 커밋에 대한 동작

개발 브랜치 및 스테이징 브랜치의 경우 새로운 커밋을 받으면 브랜치의 동작을 변경할 수 있습니다. 기본적으로, 개발 브랜치는 새 빌드를 생성하고 스테이징 브랜치는 이전 빌드를 업데이트합니다 (프로덕션 단계 참조). 이 기능은 작업 중인 기능에 특정한 설정이나 환경 설정이 필요한 경우 커밋할 때마다 직접 다시 설정할 필요가 없으므로 특히 유용합니다. 스테이징 브랜치에 새 빌드를 선택하면 커밋이 푸시될 때마다 프로덕션 빌드에서 새로 복사본이 만들어집니다. 스테이징에서 개발로 되돌려진 브랜치는 자동으로 ‘아무 것도 하지 않음’으로 설정됩니다.

모듈 설치

개발 빌드에 자동으로 설치할 모듈을 선택합니다.

• *내 모듈만 설치*는 해당하는 브랜치의 모듈만 설치합니다. 기본 선택 사항입니다. :ref:`하위 모듈 <odoosh-advanced-submodules>`은 제외됩니다.

• *전체 설치 (모든 모듈)*는 브랜치의 모듈, 하위 모듈에 포함된 모듈 및 Odoo의 모든 표준 모듈을 설치합니다. 전체 설치를 실행하면 테스트 도구 모음이 비활성화됩니다.

• *모듈 목록 설치*는 이 옵션의 바로 아래 입력란에 지정되어 있는 모듈을 설치합니다. 이름은 모듈의 기술명이며 쉼표로 구분되어야 합니다.

테스트를 활성화하게 되면 표준 Odoo 모듈 제품군의 경우 최대 1시간까지 소요될 수 있습니다. 개발 빌드에만 이 설정이 적용됩니다. 스테이징 빌드는 프로덕션 빌드와 복제되고 프로덕션 빌드는 기본으로만 설치됩니다.

테스트 도구 모음

개발 브랜치의 경우 테스트 도구 모음을 사용 또는 사용하지 않도록 선택할 수 있습니다. 사용하는 것이 기본값으로 되어 있습니다. 테스트 도구 모음이 활성화된 경우 :ref:`태그 테스트<developer/reference/testing/selection>`를 지정하여 제한할 수 있습니다.

Odoo 버전

개발 브랜치에 한해, 프로덕션 데이터베이스가 최신 버전으로 업그레이드되는 동안 업그레이드된 코드를 테스트하거나 기능을 개발하려는 경우에 Odoo 버전을 변경할 수 있습니다.

또한 각 버전별로 코드 업데이트와 관련된 옵션이 두 가지 있습니다.

• 최신 버그, 보안 및 성능 수정 사항이 자동으로 적용되도록 선택할 수 있습니다. Odoo 서버의 소스는 매주 업데이트됩니다. 현재는 ‘최신’ 상태입니다.

• 날짜 목록에서 Odoo 소스를 선택하여 특정한 개정판에 핀고정하도록 선택할 수 있습니다. 개정판은 3개월 후에 만료됩니다. 만료일에 가까워지면 메일로 알림을 받게 되며 이후에도 아무 조치를 취하지 않을 경우 자동으로 최신 개정판으로 설정됩니다.

사용자 지정 도메인

여기서 선택한 브랜치에 대해 추가 도메인을 설정할 수 있습니다. 다른 <name>.odoo.com 도메인이나 사용자 지정 도메인을 추가할 수 있습니다. 후자의 경우 다음과 같은 조건에 부합해야 합니다.

• 도메인 주소를 가지고 있거나 구매해야 하며,

• 이 목록에 도메인 주소를 추가하고,

• 등록 기관의 도메인 주소 관리자에서 프로덕션 데이터베이스 도메인 주소로 설정된 CNAME 레코드를 사용하여 도메인 주소를 설정합니다.

예를 들어, www.mycompany.com 을 데이터베이스 mycompany.odoo.com 에 연결하려면:

• Odoo.sh에서 프로젝트 설정의 사용자 지정 도메인에 www.mycompany.com 을 추가하고,

• 도메인 주소 관리자 (예: godaddy.com, gandi.net, ovh.com)에서 www.mycompany.com 값을 CNAME 레코드와 함께 mycompany.odoo.com 으로 설정합니다.

기본 도메인 (예: mycompany.com)은 허용되지 않습니다.

• 환경 설정에는 A 레코드만 사용할 수 있습니다.

• A 레코드는 IP 주소 값만 사용할 수 있습니다.

• 데이터베이스의 IP 주소는 변경될 수 있으며, 업그레이드의 경우, 하드웨어 장애 또는 다른 국가나 대륙에서 데이터베이스를 호스팅하려는 경우 변경할 수 있습니다.

따라서 이와 같이 IP 주소가 변경될 경우 기본 도메인이 갑자기 더 이상 작동하지 않을 수 있습니다.

또한 데이터베이스에서 mycompany.com 와 www.mycompany.com 을 모두 작동하게 하려면 전자가 후자 쪽으로 리디렉션되도록 설정하여 주된 URL을 하나로 만드는 내용을 SEO 모범 사례 (문서에 도달하기 위해 URL을 한 버전으로 제공하기 참조) 에서도 확인할 수 있습니다. 따라서 *mycompany.com*이 *www.mycompany.com*으로 리디렉션되도록 설정하기만 하면 됩니다. 대부분의 도메인 관리자에게 이와 같은 리디렉션을 환경 설정하는 기능이 있습니다. 일반적으로 웹 리디렉션이라고 지칭합니다.

HTTPS/SSL

리디렉션이 알맞게 설정되면 플랫폼에서 한 시간 내에 ‘암호화하기 <https://letsencrypt.org/about/>`_ 를 사용하여 SSL 인증서가 자동으로 생성되어 HTTPS를 통해 도메인에 액세스할 수 있습니다.

현재 Odoo.sh 플랫폼에서 자체 SSL 인증서 구성 기능은 지원되지 않고 있으나 충분한 수요가 있을 경우 해당 기능을 지원하는 것을 고려하고 있습니다.

SPF 및 DKIM 준수

사용자 이메일 주소의 도메인에서 SPF (Sender Policy Framework) 또는 DKIM (DomainKeys Identified Mail)를 사용하는 경우, 발신 이메일의 도달률을 높이기 위해 도메인 주소 설정에서 반드시 Odoo를 전송 호스트로 승인하도록 합니다. 설정 단계는 SPF 및 DKIM 에 대한 문서에 설명되어 있습니다.

셸 명령어¶

보기의 오른쪽 상단에서 다양한 셸 명령어를 사용할 수 있습니다.

각 명령어를 클립보드에 복사한 후 터미널에서 사용할 수 있으며, 일부는 실행 버튼을 클릭하여 Odoo.sh에서 직접 사용할 수 있습니다. 이 경우 사용자에게 팝업 창으로 <URL>, <PATH>, …와 같은 최종 자리 표시자를 정의하라는 안내가 표시됩니다.

복제하기¶

Git 저장소를 다운로드합니다.

$ git clone --recurse-submodules --branch master git@github.com:odoo/odoo.git

odoo/odoo 저장소를 복제합니다.

• --recurse-submodules: 저장소의 하위 모듈을 다운로드합니다. 하위 모듈에 있는 하위 모듈도 다운로드됩니다.

• --branch: 저장소의 특정 브랜치를 체크아웃하며, 이 경우에는 master 가 해당됩니다.

run 버튼은 컴퓨터에서 사용되는 것으로, 이 명령에는 사용할 수 없습니다.

Fork¶

현재 브랜치를 기준으로 새로운 브랜치를 만듭니다.

$ git checkout -b feature-1 master

master 브랜치를 기반으로 feature-1 이라는 새 브랜치를 생성한 다음 체크아웃합니다.

$ git push -u origin feature-1

원격 저장소에 새 브랜치 feature-1 을 업로드합니다.

병합¶

현재 브랜치를 다른 브랜치에 병합합니다.

$ git merge staging-1

현재 브랜치에 staging-1 브랜치를 병합합니다.

$ git push -u origin master

원격 저장소의 master 브랜치에 방금 추가한 변경 사항을 업로드합니다.

SSH¶

설정¶

SSH를 사용하려면 프로필 SSH 공개 키를 설정해야 합니다 (아직 설정하지 않은 경우). 설정하려면 다음 단계에 따라 진행하세요.

1. 새 SSH 키 생성하기

2. SSH 키를 클립보드에 복사합니다 (1단계에만 적용)

3. 복사한 콘텐츠를 프로필 SSH 키에 붙여넣은 후 “추가” 를 클릭합니다.

   

4. 키가 아래에 표시됩니다.

   

접속¶

SSH를 사용하여 빌드에 연결하려면 터미널에서 다음 명령어를 사용합니다:

$ ssh <build_id>@<domain>

이 명령어에 대한 단축키는 오른쪽 상단에 있는 SSH 탭에서 확인할 수 있습니다.

프로젝트에 알맞은 액세스 권한 이 있는 경우에는 빌드에 대한 SSH 액세스 권한이 부여됩니다.

하위 모듈¶

다른 저장소의 브랜치를 현재 브랜치에 하위 모듈 로 추가합니다.

하위 모듈 을 통하여 프로젝트의 다른 저장소에 있는 모듈을 사용할 수 있습니다.

하위 모듈 기능은 이 문서의 하위 모듈 챕터에 자세히 설명되어 있습니다.

$ git submodule add -b master <URL> <PATH>

저장소의 master 브랜치 <URL> 을 현재 브랜치의 <PATH> 경로 아래의 하위 모듈로 추가합니다.

$ git commit -a

현재 변경 사항을 모두 커밋합니다.

$ git push -u origin master

원격 저장소의 master 브랜치에 방금 추가한 변경 사항을 업로드합니다.

삭제¶

저장소에서 브랜치를 삭제합니다.

$ git push origin :master

원격 저장소에서 브랜치를 삭제합니다.

$ git branch -D master

저장소의 로컬 복사본에서 브랜치를 삭제합니다.