분기

인벤토리는 Git 저장소에서 구현됩니다. Git 는 변경사항을 추적하고 감사하는 데 자체적으로 충분합니다.

분기는 환경으로 사용됩니다. 기본 분기(master)는 지속적 통합 파이프라인을 통해 작성되고 업데이트됩니다. 기타 환경은 승격을 사용하여 마스터 분기에서 업데이트됩니다. 승격에 관한 자세한 정보는 승격 절을 참조하십시오.

재고 컨텐츠

인벤토리에는 배치에 참여하는 모든 아티팩트의 인벤토리 항목이 포함되어 있습니다. 하나의 인벤토리 시작점은 단일 아티팩트를 가리킵니다. 인벤토리 항목은 폴더에 구조화할 수 있는 JSON 파일이며 항목 이름을 사용하여 이름이 지정됩니다.

인벤토리 폴더는 항목 이름의 일부입니다.

/
├── auth
│   ├── service
│   └── db
├── ui
│   └── service
├── helm-charts
│   └── main_service
└ main_service

예

자산의 이미지 유형에 대한 재고 항목

{
  "repository_url": "https://github.com/test-org/compliance-app-20201211", # source code repository url of the image artifact
  "artifact": "us.icr.io/namespace/hello-compliance-app:20201217081811-master-b85e3d472e9cc35b429c39e8c3f9eb282738c20a@sha256:da36831d5154307ac9ca4b8d900df2da0c6c14754977c32479dc62994b5722d0", # image artifact name, should be in a format like <static_name>:<version>@sha256:<sha256> OR <static_name>@sha256:<sha256>
  "build_number": 21, # pipeline build number
  "commit_sha": "b85e3d472e9cc35b429c39e8c3f9eb282738c20a",  # should be a proper git commit sha
  "name": "hello-compliance-app", # name of the inventory entry file name
  "pipeline_run_id": "f21321bf-9054-4bf3-80a8-4fb34743b7d9", # pipeline run id where artifact was built
  "version": "v1",  # version of the artifact
  "app_artifacts": {}, # any additional information can be stored here
  "type": "image",
  "sha256": "sha256:da36831d5154307ac9ca4b8d900df2da0c6c14754977c32479dc62994b5722d0",
  "provenance": "us.icr.io/namespace/hello-compliance-app:20201217081811-master-b85e3d472e9cc35b429c39e8c3f9eb282738c20a@sha256:da36831d5154307ac9ca4b8d900df2da0c6c14754977c32479dc62994b5722d0", # The fully qualified URL where artifact is stored, in case of image artifact, it is same as the artifact field
  "signature": "owFNUX1IE3EY3vwAEy0VyoSJdkVWtu0+d3eTjNIIi0jETCSU3353cz+83V23myi2BlFgYiUFqSmZLciUzCJkRYJp9IEWFWXB0hAyrBQxEjIIuhFSf70vL8/7vM/zPi3JsaYEc+TnbqG8qrnTPDZ8w2WqiqwtacCghnQEgYQ5GzAkiLKO9PpoLyiwRtSsmugWNVGGIubE/D4bgpoNKXag60gCdo8oSYoVKl5VQsDAWIGqOkmcxAmSYHGO4AjC6gU+3eBxcYxICTRLijyEFOOiSR5SvMhBys2LLpIjWYqDJA6wwHYMeUG1+J8GL5CRW/TpVgFVG8VQ4vMAknE4BUA5OIoQGIKhKZwFkIeAdnECj+OCmxQADh2QoFmG5lkWUiTN8gJ0kDxPuxiWJAU8ekyvV6PegK54EcyGiqwDJItatg9Vy0D3a2IUpKg6UuS/T4KaaIC1fzuMDbfhmMGEvIY64FUxJ+Ew3PMU5SADgdNmKs5kTjBlrtsQ99iyY49nns8o6jsXWgkjPiYahClxVcrK5Flngumz2j7YdmD0ecutytsvxxNPHflKlRV2RyqD69NjC6Smji9XuukFyZ+lvM18gUr7F4NXge9YyZPik411tc1n9bKO/hDz7oGaX/ur94OnNHiwOG6n5ZsrsCsvtyvmkH4zOWlrRWuL7fzgj9zlcCTAhtu2LbeGLNfv3Ju0Jc9PZPk7Pm3Ov2CW+2xj8ReX6ooGamZ610yqRM/+8Qo2XnOeyZzbVKgs+f2+9unpJOve4Tmla+PdqftDWkHPm9Vq3nsyZ2DUkmP/nTb7qNw5l2SfWtiSemJx9nLaYOpx6amlOT18aeIwJQhHg1XOjJF9r18NXQvPuL9rH5tSQqbGhyN/AA=="  # The signature of the artifact
}

배치, helm 차트와 같은 자산의 비이미지 유형에 대한 자원 명세 항목

{
  "repository_url": "https://github.com/test-org/compliance-app-20201211",  # source code repository url of the artifact
  "artifact": "deployment.yaml", # artifact name, must be contant every build
  "build_number": 21, # pipeline build number
  "commit_sha": "b85e3d472e9cc35b429c39e8c3f9eb282738c20a", # must be a proper git commit sha
  "name": "hello-compliance-app-deployment", # name of the inventory entry file name
  "pipeline_run_id": "f21321bf-9054-4bf3-80a8-4fb34743b7d9", # pipeline run id where artifact was built
  "version": "v1", # version of the artifact
  "app_artifacts": {}, # any additional information can be stored here
  "type": "deployment", # type of the artifact
  "sha256": "sha256:da36831d5154307ac9ca4b8d900df2da0c6c14754977c32479dc62994b5722d0",  # sha256 of the artifact
  "provenance": "https://raw.github.ibm.com/org/my-app/commit-1/deployment.yaml", # The fully qualified URL where artifact is stored
  "signature": "owFNUX1IE3EY3vwAEy0VyoSJdkVWtu0+d3eTjNIIi0jETCSU3353cz+83V23myi2BlFgYiUFqSmZLciUzCJkRYJp9IEWFWXB0hAyrBQxEjIIuhFSf70vL8/7vM/zPi3JsaYEc+TnbqG8qrnTPDZ8w2WqiqwtacCghnQEgYQ5GzAkiLKO9PpoLyiwRtSsmugWNVGGIubE/D4bgpoNKXag60gCdo8oSYoVKl5VQsDAWIGqOkmcxAmSYHGO4AjC6gU+3eBxcYxICTRLijyEFOOiSR5SvMhBys2LLpIjWYqDJA6wwHYMeUG1+J8GL5CRW/TpVgFVG8VQ4vMAknE4BUA5OIoQGIKhKZwFkIeAdnECj+OCmxQADh2QoFmG5lkWUiTN8gJ0kDxPuxiWJAU8ekyvV6PegK54EcyGiqwDJItatg9Vy0D3a2IUpKg6UuS/T4KaaIC1fzuMDbfhmMGEvIY64FUxJ+Ew3PMU5SADgdNmKs5kTjBlrtsQ99iyY49nns8o6jsXWgkjPiYahClxVcrK5Flngumz2j7YdmD0ecutytsvxxNPHflKlRV2RyqD69NjC6Smji9XuukFyZ+lvM18gUr7F4NXge9YyZPik411tc1n9bKO/hDz7oGaX/ur94OnNHiwOG6n5ZsrsCsvtyvmkH4zOWlrRWuL7fzgj9zlcCTAhtu2LbeGLNfv3Ju0Jc9PZPk7Pm3Ov2CW+2xj8ReX6ooGamZ610yqRM/+8Qo2XnOeyZzbVKgs+f2+9unpJOve4Tmla+PdqftDWkHPm9Vq3nsyZ2DUkmP/nTb7qNw5l2SfWtiSemJx9nLaYOpx6amlOT18aeIwJQhHg1XOjJF9r18NXQvPuL9rH5tSQqbGhyN/AA=="  # The signature of the artifact
}

코코아 재고 추가 명령을 사용하여 재고에 쓰십시오.

CI는 인벤토리에 기록합니다.

master 분기는 지속적 통합 빌드에서 채워집니다. 대상의 마지막 커미트(이 경우에는 staging이라고 함)에는 마지막으로 종료된 배치임을 표시하는 태그가 포함되어 있습니다.

재고의 기본 분기가 다른 분기로 전환되는 경우 이전 기본 분기의 커미트를 새 기본 분기로 리베이스하여 Git 커미트 히스토리를 선형으로 만들어야 합니다.

릴리스 스크립트를 사용자 정의하여 자원 명세에 쓰기를 건너뛸 수 있습니다. 자세한 정보는 재고로 릴리스 를 참조하십시오.

승격

대상 분기로 승격하면 가져오기 요청이 작성됩니다. 가져오기 요청 컨텐츠가 변경 요청 필드를 채웁니다. 가져오기 요청을 검토한 후 병합할 수 있습니다.

델타 및 배치

승격 가져오기 요청이 병합되면 배치 파이프라인이 시작될 수 있습니다. 배치 델타는 마지막으로 종료된 배치의 컨텐츠와 현재 배치의 컨텐츠 간 차이입니다. 배치 델타는 배치되는 인벤토리 항목을 나열합니다.

재고 결론

배치가 완료되면 latest 태그를 앞으로 이동할 수 있습니다.

개발 모드 트리거 중에는 태그가 진행되지 않습니다. 개발 모드 트리거의 목적은 CD 파이프라인만 테스트하기 위한 것입니다.

추가 환경으로 승격

모든 분기에서 다른 분기로 승격하고 배치할 수 있습니다.

인벤토리 환경

현재 배치된 상태에는 환경에 배치할 컨텐츠가 포함되어 있습니다. 대상 브랜치의 모든 승격된 커밋에는 관련 파이프라인 실행 ID와 변경 요청 ID가 태그로 포함됩니다. 예를 들어, 실패한 배치를 재시도하거나 다시 배치하는 경우 일부 커미트에는 여러 개의 태그가 있을 수 있습니다. 인벤토리는 배치를 재생할 모든 정보를 보유합니다.

여러 지역이 있는 단일 대상의 설정

단일 대상 환경에 대해 여러 개의 latest 태그가 도입되어 다양한 유형의 사용 사례에 대해 여러 개의 연속 배포 파이프라인이 동일한 대상에서 작동할 수 있습니다. 예를 들어, 프로덕션 대상 환경 및 인벤토리 분기의 여러 지역에서 동일한 대상 환경(예: us-south 또는 eu-de)을 사용할 수 있습니다.

us-south-prod 및 eu-de-prod 와 같이 region 속성을 사용하여 각 지역마다 다른 지점을 설정하고 프로모션을 중복으로 실행할 필요가 없습니다. 대신 동일한 인벤토리 분기에 이러한 추가 대상을 지정한 후 Git 태그로 사용하십시오.

이 설정에서 prod 브랜치에는 us-south_prod_latest 및 eu-de_prod_latest 와 같이 동일한 브랜치에 여러 개의 latest 태그가 있습니다. 각 지역을 담당하는 각 지속적 배포 파이프라인은 이러한 태그를 사용하여 배포할 수 있습니다.

예를 들어 모든 곳에 배포하려는 일련의 변경 사항을 먼저 단일 지역에 배포한 다음 해당 지역을 대상으로 연속 배포 파이프라인을 사용하여 다른 지역에 점진적으로 배포할 수 있습니다.

CLI 명령

1. 마스터에서 스테이징의 대상 분기로 승격 가져오기 요청을 작성합니다.

   cocoa inventory promote \
     --source="master" \
     --target="staging" \
     --priority="moderate" \
     --assigned-to="assignee@ibm.com" \
     --description="Change description" \
     --purpose="Change purpose" \
     --impact="Change impact" \
     --backout-plan="Details on backout and rollback")
   

2. target_latest 태그를 pipeline-run-id 태그와 동일한 커미트로 이동하여 배치를 종료합니다.

   cocoa inventory label move \
     --to-label="${PIPELINE_RUN_ID}" \
     "target_latest"
   

Git 및 GitHub CLI

1. 마스터에서 스테이징의 대상 분기로 승격 가져오기 요청을 작성합니다.

   promote() {
   
     if [ -z $1 ] || [ -z $2 ]; then
       echo "Missing source and target"
       exit 1
     fi
   
     local source="$1"
     local target="$2"
   
     if ! git show-ref "refs/remotes/origin/$target"; then
       # Create a new target branch, from the beginning of master
       git checkout master
       git checkout -b "$target" $(git rev-list --max-parents=0 HEAD)
       git_push
     fi
   
     git checkout "$source"
     git pull --rebase
   
     # Create a promotion branch for the PR
     # this can be discarded after the Promotion PR merge
     git checkout -b "promote-$source-to-$target"
     git push --set-upstream origin "promote-$source-to-$target"
   
     # Create PR from promotion branch to target branch
     gh pr create \
       --base "$target" \
       --head "promote-$source-to-$target" \
       --title "Promote $source to $target" \
       --body "" \
       --repo "https://github.com/org/inventory-repository"
   
     # promotion branch can be deleted once the PR was merged
   }
   
   $ promote master staging
   

2. target-latest 태그를 pipeline-run-id 태그와 동일한 커미트로 이동하여 배치를 종료합니다.

   conclude () {
     local target="$1"
     local tag="$2"
   
     latest="$1-latest"
   
     # remove the latest tag
     git push origin ":refs/tags/$latest"
     # find the commit hash of the target tag
     sha=$(git rev-list -n 1 $tag)
   
     # add the latest tag to the same commit of the target tag
     git tag -fa "$latest" -m "" $sha
     git push --tags --force
   }
   
   $ conclude staging pipeline-run-fe33b05c
   

3. Git 및 GitHub CLI를 사용하여 스테이징을 이전 상태로 되돌립니다.

   revert () {
     local branch="$1"
     local commit="$2"
   
     # create a revert branch from the target branch
     git checkout "$branch"
     git pull --rebase
     git checkout -b "$branch-revert"
   
     # revert commits since the target commit, then commit and push
     git revert -n $(git rev-list --no-merges HEAD...$commit)
     git commit -m "revert $branch to $commit"
     git push --set-upstream origin "$branch-revert"
   
     # create PR from revert branch to the target branch
     gh pr create \
       --base "$branch" \
       --head "$branch-revert" \
       --title "Revert $branch to $commit" \
       --body "" \
       --repo "$REPO"
   
     # revert branch can be deleted once the PR was merged
   }
   
   $ revert staging ba3b8e5ed3320e6b4981077e1a1627f08de4f511