로그인브리핑 예약

챕터 2.28

확장 릴리스하기

플러그인이나 팩이 정상 빌드 상태에서 이를 실행하는 유닛에 도달하고, 다시 회수되기까지의 과정을 설명합니다. 버전, 릴리스 검토, 채널 및 설치, 서명, 변경 승인, 배포 ID 레코드, 마이그레이션, 롤백 및 버전 폐기를 다룹니다.

이 페이지는 AI에 의해 영어 원문에서 번역되었습니다. 불명확한 내용이 있는 경우 영어 페이지를 기준으로 삼으십시오. 이 페이지를 영어로 읽기

읽는 시간 18분

Cold chain 0.4.0은 저희 릴리스 중 처음으로 이전 릴리스보다 더 많은 것을 요청한 릴리스였습니다. 냉장 컨테이너(reefer) 알림을 위해 메일 발송 기능과 외부 주소 하나가 추가되었습니다. 빌드는 성공했고 테스트는 세 개의 합성 지점 모두에서 통과했지만, 두 사람이 요청 내용을 검토하고 세 번째 사람이 해당 주소를 승인하는 동안 이 릴리스는 이틀 동안 개발 공간에 머물렀습니다. Nexus에서의 릴리스는 원래 이렇게 진행되도록 설계되어 있습니다. 코드는 쉬운 부분이며, 증거와 승인이 곧 릴리스입니다.

이 장에서는 빌드 성공부터 모든 단위에서 버전이 실행되기까지의 모든 과정과, 그 상태에서 되돌리는 방법을 다룹니다. 개발 공간에서 스테이징, 파일럿 단위, 모든 단위로 이어지는 승격 경로 자체는 2.24장 「맞춤형 버티컬을 처음부터 끝까지 구축하기」에서 소개하므로, 여기서 그 관문을 다시 설명하지는 않습니다. 이 모든 과정을 규정하는 규칙은 하나입니다. 배포는 설치 환경의 릴리스 채널을 통해서만 이루어집니다. 긴급 수정을 위한 우회로는 없으며, 누구도 실행 중인 이미지를 수동으로 편집하지 않습니다.

버전

팩 릴리스에서는 세 가지 버전 번호가 변경되며, 이를 머릿속에서 구분해 두는 것이 좋습니다.

항목 위치 예 규칙
플러그인 nexus.manifest.json의 version 0.4.0 시맨틱 버전이며, -rc.1과 같은 사전 릴리스 접미사를 사용할 수 있습니다
팩 pack.json의 version 0.4.0 팩의 렌즈, 용어 및 클러스터와 함께 변경됩니다
지식 모델 모델 자체의 버전 1.3에서 1.4까지 그래프 변경 요청을 통해서만 변경됩니다

개발 빌드는 스테이징에 도달할 때까지 0.4.0-dev 접미사를 가집니다. 플러그인과 팩을 함께 출시할 때는 두 버전을 동일하게 유지하십시오. 그러면 모든 릴리스 검토에서 증거가 어느 번호에 해당하는지에 대한 논쟁을 피할 수 있습니다.

다른 두 버전은 선택하는 것이 아니라 고정됩니다. 팩의 템플릿 버전(Cold chain의 경우 domain-pack@1.6.0)은 팩을 만들 때 고정되며, 검토를 거친 변경으로만 바뀝니다. SDK(소프트웨어 개발 키트)는 범위가 아닌 정확한 버전으로 설치되므로, 같은 빌드는 다음 달에도 같은 결과를 냅니다.

npm install --save-exact @adverant-nexus/plugin-sdk@2.50.0

Skills Engine 스킬에도 버전이 있지만, 동작 방식이 다릅니다. 게시된 각 버전은 고정되어 있으며, live, canary, shadow는 버전에 붙는 레이블입니다. 되돌리기는 레이블을 옮기는 것이며, 이미 진행 중인 실행은 시작한 버전으로 완료됩니다.

검토 요청 전 확인 사항: 매니페스트

매니페스트 및 권한 페이지는 이번 릴리스가 선언한 내용을 직전 릴리스와 비교합니다. 비교 대상은 범위, 저장소, 외부 주소, 샌드박스 프로필입니다. 검토를 요청하기 전에 이 페이지를 읽으십시오. 검토자가 무엇을 승인하도록 요청받게 될지 정확히 알려 주기 때문입니다.

매니페스트 및 권한
매니페스트 및 권한
Cold chain 0.4.0이 0.3.2와 비교해 선언한 내용입니다. 확장으로 표시된 두 줄(메일 발송과 외부 주소 하나)과, 두 명의 검토자가 이를 승인할 때까지 릴리스가 개발 공간을 벗어나지 않는다고 알리는 안내판에 주목하십시오.

이전에 매니페스트에서 선언한 것보다 더 많은 것을 요청하는 릴리스는 두 명의 검토자가 확장된 매니페스트를 승인할 때까지 MANIFEST_SCOPE_WIDENED과 함께 현재 위치에 보류됩니다. 외부 주소에는 고객사에서 외부 주소를 담당하는 사람의 승인도 필요합니다. 이 승인은 정해진 기간 동안 부여되며, 저희의 경우 12개월이었습니다. 진행 방법은 두 가지입니다. 해당 줄을 제거하거나, 검토를 요청하는 것입니다. 페이지에는 두 버튼이 모두 제공됩니다.

이 페이지의 모든 줄은 검토만 되는 것이 아니라 실행 시점에 강제 적용됩니다. 각 도구 호출은 선언된 범위와 대조하여 검사되고, 외부 주소는 목록에 없으면 차단되며, 샌드박스 프로필은 다른 네트워크를 허용하지 않습니다. 선언하지 않은 대상에 접근하려는 플러그인은 거부되며, 유일한 해결책은 이를 선언한 새 릴리스입니다.

릴리스 검토

릴리스 검토 페이지는 작성자가 아닌 검토자를 위해 한 릴리스의 증거를 하나의 표에 모아 보여 줍니다.

릴리스 검토
릴리스 검토
증거 표, 범위 차이, 댓글이 표시된 Cold chain 0.4.0의 두 번째 검토자 화면입니다. 오른쪽 안내판에 주목하십시오. 작성자는 자신의 릴리스를 승인할 수 없습니다.
증거 0.4.0에서 확인된 내용
테스트 세 개의 합성 지점에서 66개 중 66개
품질 검사 문서와 코드가 일치합니다
정책 각 렌즈는 범위를 좁히기만 하며, 개인 정보 필드는 기본적으로 해제되어 있습니다
서명 이미지와 패키지가 파이프라인에 의해 서명됨
범위 차이 메일 발송과 외부 주소 하나를 승인과 함께 추가함
호환성 테스트에 사용된 플랫폼 버전과 기본 팩 버전
모델 변경 그래프 변경 요청의 시험 실행: 링크 1,284개 이름 변경, 제거된 항목 없음

표 아래에는 변경에 대한 댓글과 출처 정보가 있습니다. 어떤 파이프라인이 어떤 변경으로부터 빌드했는지, 이미지 다이제스트와 템플릿이 표시됩니다. 검토자는 패스키로 승인합니다. 작성자가 아닌 두 명의 검토자가 승인하면 파이프라인이 릴리스를 스테이징으로 이동합니다. 작성자는 절대 검토자로 계산되지 않으며, 시도하면 NEEDS_SECOND_PERSON으로 거부됩니다. 검토 요청은 3일 후 만료됩니다.

검토자의 질문에는 채팅 창이 아닌 댓글로 답하십시오. 저희 검토 과정에서 컴플라이언스 담당자는 청구 금액이 왜 상업 정보로 분류되었는지 물었고, 두 번째 검토자는 모델 변경에 대한 롤백 계획을 요청했습니다. 두 답변은 이제 릴리스 기록의 일부가 되었으며, 다음 검토자가 확인할 곳도 바로 그 기록입니다.

변경 정책 승인

릴리스 검토는 릴리스 전체를 다룹니다. 매니페스트의 changePolicy 블록은 한 걸음 더 나아가, 플러그인의 배포 대상에 대한 어떤 변경 유형에 승인이 필요하며 몇 명의 승인이 필요한지를 지정합니다.

"changePolicy": {
  "enabled": true,
  "classes": ["website", "bff", "migration"],
  "approvals": { "website": 1, "bff": 1, "migration": 2 }
}

세 가지 유형은 website(웹 앱), bff(프런트엔드용 백엔드), migration(데이터베이스 마이그레이션)입니다. classes에 지정된 각 유형은 approvals에 1에서 10 사이의 자체 승인 수를 가져야 합니다. 제외한 유형은 관리되지 않으며, 스키마는 이를 누락으로 인한 결과가 아니라 의도적인 선택으로 작성하도록 요구합니다. 저희는 마이그레이션에 두 명의 승인을 요구하는데, 마이그레이션은 되돌리기 어려운 유일한 변경이기 때문입니다.

승인은 서로 다른 사람 수로 계산되며, 제안자는 절대 포함되지 않습니다. 이를 뒷받침하는 규칙은 알아 둘 가치가 있습니다. 각 규칙마다 거부 사유가 있기 때문입니다.

  • 변경을 제안한 사람의 승인은 TRUST_APPROVAL_SELF_APPROVAL으로 거부됩니다.
  • 해당 유형의 변경을 아예 할 수 없는 사람의 승인은 CHANGE_CLASS_NOT_PERMITTED으로 거부됩니다.
  • 변경에 포함된 커밋 중 하나라도 조직의 에이전트 ID로 서명된 경우, 정족수는 통상 최소 인원에 1명이 더해지며 에이전트 자신의 투표는 계산되지 않습니다.
  • 각 승인은 승인 시점에 확인한 diff와 head를 기록합니다. 마지막 승인 이후 변경이 바뀌면 병합이 HASH_MISMATCH으로 거부되며, 새 내용에 대해 승인을 다시 받아야 합니다.

세 번째 규칙은 2.26장 「AI 코딩 도구로 구축하기」에서 설명하는 것처럼 AI(인공지능) 코딩 도구로 개발하는 경우에 중요합니다. 에이전트가 작성한 작업에는 사람이 작성한 작업보다 사람의 승인이 한 건 더 필요합니다. 이를 미리 계획하십시오.

서명 및 검증

모든 이미지와 패키지는 이를 빌드한 파이프라인에 의해 서명되며, 서명된 이미지는 스테이징으로 가는 관문 중 하나입니다. 개발 공간은 처음부터 서명된 이미지만 실행합니다. Enterprise에서는 관리자가 각 네임스페이스를 서명되지 않은 이미지를 기록하거나 거부하도록 설정하고, 네임스페이스를 하나씩 거부 모드로 전환하여 결국 프로덕션에서는 파이프라인이 빌드하고 서명한 이미지만 실행되도록 합니다. 서명은 릴리스 전에 추가하는 것이 아니라 빌드의 일부입니다.

이 모든 과정에 일관되게 적용되는 규칙은, 실패한 서명은 경고가 아니라 항상 거부라는 것입니다. SIG_INVALID을 받은 검사는 중단됩니다. 서명되지 않은 버전으로 대체하지도 않고, 로그에 메모를 남긴 채 계속 진행하지도 않습니다. 빌드 로그의 경고는 그것을 읽지 않은 모든 사람에게 통과로 받아들여지기 때문입니다.

매체로 전달하는 모든 것에도 같은 규칙이 적용됩니다. 에어갭 환경 고객을 위한 봉인된 번들은 압축을 풀기 전에 귀하의 공개 키로 검증되며, 2.25장 「에디션별 구축」에서 해당 명령을 보여 줍니다.

배포 ID

플러그인은 각각 이름을 가진 여러 요소를 통해 전달됩니다. 저장소, 서명 키, 배포 네임스페이스, 레지스트리 접두사, 데이터베이스 스키마, 도메인 집합, 변경 정책이 그것입니다. 이 중 어느 것이든 두 플러그인이 충돌하거나 한 플러그인이 어긋날 수 있는 지점입니다. 전달 ID는 이 모두를 담은 플러그인별 서명된 레코드 하나이므로, 릴리스 경로의 모든 검사가 같은 답을 읽고 불일치 시 거부합니다.

귀하는 매니페스트를 통해서만 자신의 부분을 제공합니다. schema, db, domains, changePolicy, 그리고 저장소 URL입니다. 나머지는 플랫폼이 채워 레코드를 완성하고 서명합니다. 귀하는 자신의 네임스페이스, 레지스트리 접두사, 서명 키를 직접 지정하지 않습니다. 이들은 할당되는 것이며, 매니페스트에서 이를 선언하려 한다면 검사가 불신할 수밖에 없는 주장을 하는 셈이 됩니다.

서명된 레코드에는 11개의 필드가 있습니다. 플러그인의 슬러그, 소유 조직, 빌드하는 조직, 저장소, 서명 키 이름, 배포 네임스페이스, 레지스트리 접두사, 데이터베이스 스키마, 도메인, 변경 정책, 그리고 레지스트리 접두사가 생기기 전에 사용하던 이전 이미지 이름의 짧은 목록입니다. 마지막 목록은 줄어들 수만 있습니다. 서명되어 있으므로 새 서명으로 항목을 제거할 수는 있지만, 무엇도 몰래 항목을 추가할 수는 없습니다. 서명은 이 11개 필드의 표준 정규화 JSON 형식에 대한 Ed25519 서명이므로, "Tomás"나 "Sinéad"가 포함된 레코드도 어디서나 동일하게 검증됩니다.

릴리스가 레코드와 일치하지 않으면 가장 먼저 해당하는 거부가 적용됩니다.

코드 상황 HTTP
DELIVERY_IDENTITY_MISSING 플러그인에 대한 레코드가 없음 403
DELIVERY_PATH_REFUSED 레지스트리 접두사 밖으로의 이미지 푸시이며, 서명된 이전 이름 목록에 없음 403
NAMESPACE_MISMATCH 다른 네임스페이스를 대상으로 하는 배포 403
IMAGE_NAME_COLLISION 다른 플러그인이 이미 사용 중인 이미지 이름 409
CHANGE_CLASS_NOT_PERMITTED 정책이 관리하지 않는 변경 유형 403

IMAGE_NAME_COLLISION은 사람들이 가장 놀라는 거부입니다. 다른 이름을 선택하고, 절대 이름을 재사용하지 마십시오. 이미지 이름을 공유하면 한 플러그인의 승격이 다른 플러그인의 파드를 이동시킬 수 있습니다.

커밋 및 범위가 지정된 마이그레이션

마이그레이션은 플러그인 이미지 안에 포함되어 출시되며, 새 버전이 시작되기 전에 SDK의 유일한 마이그레이션 실행기인 nexus-migrate을 통해 실행됩니다. 직접 적용기를 작성하지 마십시오. 릴리스가 이동하기 전에 동일한 실행기가 임시 데이터베이스에 마이그레이션을 한 파일씩 적용하므로, 실패하는 마이그레이션은 그곳에서 실패합니다. 템플릿의 섀도 빌드는 파일마다 순서대로 실행기를 한 번씩 호출하고, 프로덕션과 동일한 방식으로 각 파일을 기록합니다.

실행기의 규칙은 관문이 검사하는 규칙을 코드로 작성한 것입니다.

  1. 실행기는 스키마의 마이그레이터 역할로 연결하며, 모든 파일을 스키마 소유자로 실행합니다. 다른 로그인, 특히 슈퍼유저는 거부됩니다. 파일 자체에서 역할을 전환하려 하면 실행 전에 거부됩니다.
  2. 0번인 테넌시 파일은 적용된 후에는 절대 편집하지 않습니다. 테넌시를 변경할 때는 별도의 개정 파일 000_tenancy_r<N>.sql을 사용하며, 이 파일은 nexus-tenancy render --revision <N>가 대신 작성합니다.
  3. 일반적으로 실행기는 각 파일의 트랜잭션을 소유하며, 그 안의 BEGIN 또는 COMMIT를 거부합니다. 자체 트랜잭션을 관리하는 파일은 문장 단위로 실행된다고 선언하며, 이 경우 파일이 여는 모든 BEGIN은 짝이 맞아야 합니다.
  4. 실행기는 파일당 한 행으로 파일의 SHA-256과 실행 방식을 기록한 원장을 유지합니다. 적용된 파일은 절대 그 자리에서 변경하지 않으며, 변경은 번호가 매겨진 새 파일로 합니다.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-tenancy render --manifest nexus.manifest.json --revision 2 --out migrations/000_tenancy_r2.sql

범위 지정이란 모든 새 테이블이 organization_id, owner_user_id, business_unit_id을 가지며, gates/demo-exempt.json가 사유와 함께 해당 테이블을 예외로 지정하지 않는 한 is_demo 표시 열도 가지고, 조직으로 시작하는 기본 키와 조직을 포함하는 외래 키를 가지며, 행 수준 보안이 강제 적용된다는 뜻입니다. migrations-are-scoped 관문은 모든 파일에 대해 이 규칙을 검사하며, migrations-commit-what-they-open은 각 파일이 연 것을 커밋하는지 셉니다. 두 번째 관문이 존재하는 이유는, 예전에 조용히 롤백된 마이그레이션이 0으로 종료되었는데 생성되어야 할 테이블이 존재하지 않았던 일이 있었기 때문입니다.

모든 릴리스에 속하는 파일이 하나 더 있습니다. scripts/ci/required-env은 서비스 부팅에 필요한 환경 변수를 구성 로더에서 가져와 JSON 배열로 출력합니다. 릴리스 경로는 이를 실행하고 배포에서 이 변수를 모두 설정하지 않은 릴리스를 거부하므로, 누락된 변수는 시작되지 않는 파드가 아니라 릴리스 전에 발견됩니다.

node scripts/ci/required-env

스킬 릴리스하기

두 종류의 스킬은 서로 다른 경로로 사용자에게 전달되므로, 릴리스 방식도 달리하십시오.

플러그인의 skills[]에 있는 형식화된 행인 매니페스트 스킬은 플러그인과 함께 출시되며 플러그인의 나머지 부분과 동일한 승격 과정을 거칩니다. 온보딩은 릴리스마다 전체 스킬 세트를 레지스트리에 동기화합니다. 세트에서 빠진 스킬은 비활성화되며, Enterprise에서는 잘못된 스킬이 하나라도 있으면 동기화가 어떤 스킬도 적용하지 않으므로, 새 버전의 절반이 아니라 이전 버전이 계속 실행됩니다.

Skills Engine 스킬은 라이브러리에서 게시됩니다. Enterprise에서는 쓰기 도구를 추가하는 스킬의 경우 지정된 두 사람이 패스키로 승인할 때까지 대기하며, 제안자는 그중 한 사람이 될 수 없습니다. 승인된 버전은 먼저 섀도 모드로 실행되고, 이어서 지정된 게이트를 거쳐 한 단위에서 카나리로, 그다음 모든 사용자에게 실행되며, 게이트를 충족하지 못하면 스스로 중지됩니다. 플러그인과 Skills Engine 스킬이 서로 의존하는 경우, 스킬을 먼저 게시하여 모든 사용자에게 배포되도록 한 다음 그 스킬을 호출하는 플러그인 릴리스가 파일럿을 벗어나도록 하십시오.

채널 및 설치

릴리스가 파일럿을 통과하여 모든 단위에 배포되면 채널에서 제공되며, 각 단위는 자신의 채널을 선택합니다. 모든 이동에는 해당 단위 관리자의 동의가 필요합니다. Channels and installs 페이지에서는 어떤 단위가 어떤 버전을 실행하는지 확인할 수 있으며, 오류율은 건수로만 표시됩니다. 즉, 확장 기능이 어떻게 동작하는지는 볼 수 있지만, 누가 그것으로 무엇을 했는지는 볼 수 없습니다.

채널 및 설치
채널 및 설치
어떤 단위가 carrier-sync의 어떤 버전을 실행하는지 보여 주며, 한 단위에 대한 롤백 창이 열려 있습니다. 모달에서 무엇이 변경되고 무엇이 유지된다고 안내하는지, 그리고 두 번째 사람, 즉 해당 단위의 관리자가 필요하다는 점에 주목하십시오.

저희 carrier-sync 플러그인은 세 가지 버전을 동시에 실행하며, 이는 정상입니다. 대부분의 단위는 현재 릴리스를 사용하고, 한 단위는 명시된 날짜까지 유지되는 채널에서 이전 버전을 사용하며, 릴리스 후보는 아직 아무도 선택하지 않은 채널에 있습니다. 이를 억지로 바꾸려 하지 마십시오. 감사를 위해 안정성이 필요한 단위는 그것을 누릴 권리가 있습니다.

확장의 로그 및 메트릭

팩의 로그 및 메트릭 페이지는 조회가 허용된 단위 내에서 자신의 워크로드로만 고정됩니다. 단위와 환경별로 필터링할 수 있으며, 건수, 소요 시간 및 상태를 확인할 수 있습니다.

팩의 로그 및 메트릭
팩의 로그 및 메트릭
Rotterdam 파일럿으로 필터링된 Cold chain 자체의 로그 및 메트릭입니다. 로그 줄을 살펴보십시오. 이탈을 보고한 사람은 숨겨져 있으며, 클레임 메모의 텍스트는 아예 기록되지 않습니다.

개인 필드는 줄이 기록되기 전에 대체되며, 클레임 텍스트, 메일 또는 문서 내용과 같은 고객 콘텐츠는 로그에 절대 기록되지 않습니다. 로그는 14일간 보관됩니다. 조직은 쿼리가 아니라 게이트웨이가 설정하므로, 다른 조직을 지정하는 쿼리는 TENANT_BOUNDARY으로 거부됩니다. 도크의 어시스턴트는 동일한 로그를 함께 읽을 수 있으며, 이 로그만 읽을 수 있습니다. 어느 날 아침 이탈 기록이 늦게 들어온 이유를 묻자, 어시스턴트는 18분간의 재시도가 한 부두의 전원 공급 장치에서 발생한 중복 측정값 때문이었음을 추적해 냈습니다.

롤백하기

롤백에는 두 종류가 있으며, 둘 다 스위치가 아니라 검토를 거치는 변경입니다.

환경 롤백은 이전 버전을 사용합니다. 각 환경은 이전 버전을 30일간 보관합니다. 롤백은 릴리스에 대한 변경으로 준비되며, 수행할 작업을 미리 보여 주고 두 번째 사람이 필요합니다. 승인되면 파이프라인이 약 1분 안에 롤백합니다. 모든 롤백과 모든 훈련은 시간이 측정되므로, 필요해지기 전에 한 번 연습해 두십시오. 단일 단위 롤백은 Channels and installs 페이지를 사용합니다. 롤백 모달에는 변경되는 사항(해당 단위가 다시 이전 버전을 실행하며, 한 시간 동안 오류율이 감시됨), 유지되는 사항(다른 단위들, 그리고 해당 단위의 설정과 기록), 사유, 그리고 두 번째 사람, 즉 해당 단위의 관리자가 누구인지가 표시됩니다.

설정과 기록은 롤백 후에도 유지되므로, 각 릴리스는 이전 버전이 새 버전이 기록한 데이터에서 다시 실행될 수 있다는 가정하에 계획하십시오. 이것이 롤백할 가능성이 있는 릴리스 내에서는 마이그레이션을 추가 방식으로 유지해야 하는 실질적인 이유이며, 각 마이그레이션에 두 사람의 승인을 요구하는 이유이기도 합니다. 모델 변경도 마찬가지입니다. 검토자는 그래프 변경 요청을 승인하기 전에 롤백 계획을 요청할 수 있으며, 또 요청해야 합니다.

스킬은 더 부드럽게 롤백됩니다. live 레이블을 이전 버전으로 되돌리는 것은 한 단계이며, 이미 진행 중인 실행은 시작한 버전에서 완료됩니다.

버전 폐기하기

릴리스는 한 번 만들어지면 절대 수정되지 않습니다. 더 이상 사용해서는 안 되는 버전은 철회되며, 수정 사항은 새 버전 번호로 배포됩니다. SDK 자체의 릴리스 채널도 같은 원칙을 따릅니다. 문제가 있는 SDK 버전은 회수(yank)되며, 같은 번호로 다른 내용으로 대체되지 않습니다. 이 방식을 따르십시오. 하나의 버전 번호가 서로 다른 두 빌드를 의미할 수 있다면, 그에 관한 모든 증거가 무가치해지기 때문입니다.

플러그인 또는 팩을 철회하면 새 설치가 중지됩니다. 단위는 이동하기 전까지 실행 중인 버전을 유지하므로, 철회는 끄는 스위치가 아니라 신호이자 기한입니다. 단위 관리자에게 어느 버전으로, 언제까지 이동해야 하는지 알려 주십시오.

스킬 폐기도 같은 원칙을 따르되 한 단계가 더 있습니다. Skills Engine은 대체 스킬의 케이스를 실행한 후 남은 모든 호출자를 대체 스킬로 이동시키고, 새 실행을 중지하며, 버전, 케이스 및 봉인된 실행 기록을 보관하므로 대체 스킬이 잘못된 것으로 밝혀지면 해당 스킬을 다시 복원할 수 있습니다.

릴리스 체크리스트

다음은 저희가 Cold chain 릴리스 전마다 확인하는 목록입니다. 플랫폼이 대부분을 대신 확인해 주기 때문에 목록이 짧습니다.

  1. 버전이 일치합니다: 매니페스트, pack.json, 그리고 변경된 경우 지식 모델.
  2. 모든 게이트가 클린 상태에서 로컬로 통과하며, 모든 새 테스트는 먼저 실패하는 것이 확인되었습니다.
  3. Manifest and permissions 페이지에 권한 확대가 표시되지 않거나, 확대가 의도한 것이며 검토자가 그 이유를 알고 있습니다.
  4. 모든 마이그레이션은 새로 번호가 매겨진 파일이고, 범위가 지정되어 있으며, 일회용 데이터베이스에 문제없이 적용됩니다.
  5. scripts/ci/required-env에 서비스에 필요한 모든 변수가 나열되어 있으며, 배포에서 각 변수를 설정합니다.
  6. 모델 변경을 포함하여 롤백 계획이 변경에 작성되어 있습니다.
  7. 작성자가 아닌 검토자 두 명이 이번 주에 참여할 수 있습니다.

마지막 항목은 사소해 보입니다. 하지만 이 항목이 모든 게이트를 합친 것보다 더 많이 저희 릴리스를 지연시켰습니다.