왜 중요한가

출시일이 스트레스인 것은 한꺼번에 너무 많은 일이 일어나기 때문입니다. 새 코드가 설치되고, 새 기능이 켜지고, 사용자가 처음 접하고, 지원 팀이 첫 불만으로 그것을 알게 됩니다. 무언가 잘못되면 이 모든 것이 뒤엉키고, 되돌아갈 유일한 방법은 모든 것을 취소하는 롤백일 수 있습니다.

배포와 릴리스를 분리하는 팀은 그 대부분을 피합니다. 코드는 사용자가 보기 며칠 전에 꺼진 채로 조용히 프로덕션에 갑니다. 팀이 준비되면 플래그가 먼저 작은 그룹에, 그다음에 더 많은 사람에게 기능을 켭니다. 무언가 잘못되면 플래그가 몇 초 안에 끕니다. 기술적인 행위인 배포는 엔지니어의 일정에 따라 일어나고, 사업과 고객의 행위인 릴리스는 조직이 준비되었을 때 일어납니다.

이 주제는 두 가지 생각, 이를 뒷받침하는 기법, 사용자, 지원 직원, 감사인에게 계속 알리는 프랙티스를 설명합니다. 지속적 전달(주제 2.2 — 지속적 전달)과 변경 실현(주제 3.4 — 변경 실현)을 토대로 하며, 구성 관리(주제 4.4 — 구성 관리)와 지식 관리(주제 3.9 — 지식 관리)에 연결됩니다.

핵심 개념

배포. 소프트웨어, 구성, 기타 구성 요소를 테스트나 프로덕션 같은 환경으로 옮기는 행위입니다. Wikipedia의 소프트웨어 배포 문서가 관련된 활동을 설명합니다. 배포는 무언가를 실행될 수 있는 곳에 두는 기술적 작업입니다.

릴리스. 서비스, 기능, 버전을 사용할 수 있게 만드는 것입니다. 릴리스는 배포와 같은 순간에 일어날 수도 있고 나중에 일어날 수도 있습니다. ITIL 4는 "릴리스 관리"를 새로운 서비스와 변경된 서비스 및 기능을 사용할 수 있게 하는 프랙티스로, "배포 관리"를 구성 요소를 운영 환경으로 옮기는 것으로 설명합니다.

왜 분리하는가. 배포의 위험은 코드가 실행되고 올바르게 동작하는지에 관한 것입니다. 릴리스의 위험은 사용자, 지원, 사업이 준비되었는지에 관한 것입니다. 둘을 다른 때에 하면 각 위험을 알맞은 사람과 도구로 관리할 수 있습니다.

기능 플래그. 기능 토글이라고도 하며, 새 배포 없이 실행 시점에 기능을 켜거나 끄는 코드나 제어 시스템의 스위치입니다. Wikipedia가 기능 토글과 그 용도를 설명합니다. 플래그는 사용자별, 그룹별, 트래픽 비율별, 전체로 설정할 수 있습니다. 주의가 필요합니다. 오래된 플래그가 쌓여 숨은 복잡성이 됩니다.

단계적 롤아웃. 먼저 작은 그룹에 릴리스하고 점차 넓힙니다. 변형으로는 내부 사용자 먼저, 트래픽의 작은 비율, 하나의 지역, 시범 고객이 있습니다. 각 단계는 더 많은 사람이 노출되기 전에 피드백을 줍니다.

블루-그린과 롤링 배포. 블루-그린 배포에서는 두 개의 프로덕션 환경이 존재합니다. 하나는 사용자를 서비스하고 다른 하나는 새 버전을 받으며, 준비되면 트래픽을 전환하고 필요하면 빠르게 되돌립니다. 롤링 배포에서는 인스턴스를 몇 개씩 갱신합니다. Wikipedia가 둘 다 설명합니다. 각각 비용, 복잡성, 데이터 처리에서 절충이 있습니다.

릴리스 준비 상태. 릴리스 전에 답하는 짧은 질문 모음입니다. 테스트가 통과하는가, 모니터링이 새 동작을 다루는가, 지원 직원이 무엇이 바뀌었고 어떻게 도울지 아는가, 문서와 지식 문서가 준비되었는가, 롤백 계획이 있는가, 사업이 날짜에 합의했는가. 짧게, 실제 위험에 묶어 유지하세요.

릴리스 노트. 알아야 하는 사람들을 위해 쓰는 변경 사항에 대한 설명입니다. 독자마다 다른 노트가 필요합니다. 사용자는 새로운 것이나 달라진 것을, 지원 직원은 무엇을 예상해야 하는지를, 운영은 기술적으로 무엇이 바뀌었는지를 알고 싶어 합니다. Wikipedia의 릴리스 노트와 변경 로그 문서가 흔한 형식을 설명합니다.

버전 부여. 사람들이 버전에 대해 이야기할 수 있도록 이름을 붙이는 체계입니다. Wikipedia의 소프트웨어 버전 부여 항목에서 설명하는 인기 있는 체계인 시맨틱 버저닝은 주, 부, 패치 번호로 변경의 종류를 알립니다. 체계를 정하고 일관되게 적용하세요.

데이터 변경. 데이터베이스 구조와 데이터에 대한 변경은 코드 변경보다 되돌리기 어렵습니다. 변경을 하위 호환되게 하고, 옛 구조와 새 구조를 나란히 운영하고, 작은 단계로 이전하는 패턴이 위험을 줄입니다. Wikipedia가 스키마 마이그레이션을 설명합니다.

핫픽스와 패치. 심각한 결함이나 취약점을 바로잡기 위해 정규 주기 밖에서 하는 긴급 수정입니다. 같은 규율을 가진 신속한 경로가 필요합니다. 테스트하고, 검토하고, 파이프라인으로 배포하고, 기록합니다. 주제 3.4 — 변경 실현을 참조하세요.

환경. 테스트, 스테이징, 프로덕션 환경은 각각 목적이 있습니다. 테스트 환경이 프로덕션과 닮을수록 테스트는 더 믿을 만합니다. Wikipedia의 배포 환경 문서가 흔한 구성을 설명합니다.

소프트웨어 공급망. 릴리스에는 라이브러리와 컨테이너 이미지처럼 다른 당사자의 구성 요소가 포함됩니다. 소프트웨어 자재 명세서(SBOM)가 이를 나열하며 취약점에 대응하는 데 도움이 됩니다. 주제 4.2 — 소프트웨어 자산 관리를 참조하세요.

렌즈는 어떻게 맞물리는가. 릴리스 프랙티스는 사용자와 접하는 지점의 애자일 렌즈입니다. 피드백이 있는 작은 릴리스입니다. AI는 검토 아래 릴리스 노트의 초안을 쓰고 변경을 요약할 수 있습니다. 자동화는 파이프라인과 롤아웃을 실행합니다. 분석은 릴리스가 어떻게 동작하는지 보여 줍니다.

모범 사례

  1. 작게, 자주 배포합니다. 변경을 작은 조각으로, 유용한 곳에서는 플래그 뒤에 두어 프로덕션에 올리세요. 잦은 배포는 각각을 위험이 낮고 일상적으로 만듭니다.
  2. 의도를 가지고 릴리스합니다. 사용자가 기능을 언제 보아야 하는지 사업과 결정하고, 플래그나 단계적 롤아웃으로 통제하세요. 배포 일정이 릴리스를 좌우하게 하지 마세요.
  3. 단계적으로 롤아웃합니다. 작고 정보를 가진 그룹으로 시작하고, 지표를 지켜보고, 넓히세요. 무엇을 볼지, 무엇이 중단 사유가 될지 미리 정의하세요.
  4. 플래그를 깔끔하게 유지합니다. 각 플래그의 목적, 오너, 제거 날짜를 기록하세요. 롤아웃 후 플래그를 제거하세요. 플래그가 살아 있는 동안 두 상태를 모두 시험하세요.
  5. 되돌아가는 길을 빠르게 만듭니다. 플래그를 끄거나, 롤백하거나, 페일오버하는 방법을 알고 리허설하세요. 데이터 변경은 앞으로 호환되는 단계를 계획하세요.
  6. 릴리스 전에 지원을 준비시킵니다. 사용자가 변경을 보기 전에 서비스 데스크에 릴리스 노트, 짧은 안내서, 알려진 문제를 주세요. 그들에게 무엇이 필요한지 물으세요.
  7. 독자를 위해 릴리스 노트를 씁니다. 사용자의 용어로 무엇이 바뀌었는지, 무엇을 예상해야 하는지, 어디서 도움을 받는지 말하세요. 기술적 세부 사항은 별도의 노트에 두세요.
  8. 준비 상태를 간단히 점검합니다. 중요한 릴리스에는 짧고 일관된 점검표를 쓰세요. 파이프라인이 다루는 일상적인 릴리스에는 건너뛰세요.
  9. 릴리스를 지켜봅니다. 롤아웃 중과 후에 오류율, 성능, 사용자 지표를 모니터링하고 지켜볼 사람을 지정하세요. 본 것을 기록하세요.
  10. 무엇이 릴리스되었는지 기록합니다. 버전, 날짜, 플래그 상태의 기록을 유지하세요. 인시던트와 감사에 도움이 됩니다. 가능하면 파이프라인에서 생성하세요.

팀과 논의할 질문

우리 조직에서 배포와 릴리스의 차이는 무엇이며, 각각을 누가 결정합니까? 많은 팀에서 둘은 같은 사건입니다. 누가 코드를 프로덕션에 올리기로 결정하고 누가 사용자가 언제 보게 될지 결정하는지 물으세요. 흐릿한 답이 예상됩니다. 더 깊이 들어가려면, 분리할 기능 하나를 고르세요.

새 기능이 해를 끼친다면 얼마나 빨리 끌 수 있습니까? 답을 시험해 보세요. 어떤 팀은 몇 초 안에 플래그를 끌 수 있고, 어떤 팀은 새 배포와 승인이 필요합니다. 마지막으로 해 본 때를 물으세요. 더 깊이 들어가려면, 위험한 기능 하나를 고르고 빠른 끄기 스위치를 계획하세요.

릴리스 전에 우리 지원 팀은 무엇을 압니까? 서비스 데스크에 물으세요. "첫 전화가 오기 전까지는 아무것도"라는 답이 예상됩니다. 더 깊이 들어가려면, 표준 정보 패키지와 48시간 전 같은 시점을 합의하세요.

우리에게는 어떤 기능 플래그가 있으며, 어떤 것은 없어져야 합니까? 플래그 목록에는 아무도 기억하지 못하는 것이 많이 나타나는 경우가 흔합니다. 각각을 누가 소유하는지 물으세요. 더 깊이 들어가려면, 가장 오래된 것의 제거를 일정에 잡고 오너 필드를 추가하세요.

데이터베이스에 영향을 주는 변경은 어떻게 릴리스하며, 되돌아가야 하면 어떻게 됩니까? 데이터 변경은 가장 나쁜 놀라움을 일으킵니다. 마지막 마이그레이션과 그 롤백 계획을 물으세요. 더 깊이 들어가려면, 하위 호환되는 변경을 두 단계로 하는 것 같은 패턴을 합의하세요.

AI는 릴리스 노트나 준비 상태에서 어디서 도울 수 있으며, 사람이 검증해야 하는 것은 무엇입니까? AI는 커밋 메시지와 티켓에서 노트의 초안을 쓸 수 있습니다. 무엇이 바뀌었는지 잘못 서술할 수 있습니다. 누가 초안을 읽고 변경과 비교하는지 물으세요. 더 깊이 들어가려면, 사람이 각각을 승인하는 가운데 내부 노트에 AI 초안을 시범 운영하세요.

실제 적용: 서비스 관리 사례

한 국립 도서관의 온라인 목록은 전 세계 연구자가 사용합니다. 팀이 재설계된 검색 페이지를 릴리스합니다. 이전에는 이런 변경이 화요일 저녁에 짧은 공지와 함께 가동되었을 것입니다. 이번에는 서비스 오너가 단계적 릴리스를 요청합니다.

팀은 새 페이지를 일주일 일찍 꺼진 채로 프로덕션에 배포합니다. 그런 다음 내부 직원에게 켜고, 이튿날에는 무작위로 고른 방문자의 5퍼센트에게 켭니다. 릴리스 리드는 검색 성공률과 오류 건수를 지켜보고, 서비스 데스크는 이틀 전에 한 쪽짜리 안내서와 알려진 문제의 짧은 목록을 받습니다. 사흘째에 시범 그룹의 연구자가 특정 비영어 문자를 쓰는 검색이 실패한다고 보고합니다. 팀은 1분 안에 모든 사용자에게서 플래그를 끄고, 이튿날 아침 문제를 고치고, 5퍼센트에서 롤아웃을 다시 시작합니다. 2주 후 새 페이지는 모두에게 제공되고 플래그는 제거가 예정됩니다.

달라진 점은 실패가 하루 동안 소수의 사용자에게만 영향을 주었고, 지원 데스크가 문의에 준비되어 있었다는 것입니다. 여전히 어려운 점은 플래그 시스템이 접근이 엄격하게 통제되지 않는 별도 도구에 있어 팀이 검토를 요청했다는 것, 릴리스 노트를 개발자가 썼고 연구자들이 혼란스러워했다는 것, 옛 검색 페이지와 새 검색 페이지의 이중 유지에 약 일주일의 노력이 들었다는 것입니다. 오너는 릴리스 노트 단계에 사용자 대상 편집자를 추가합니다.

네 가지 관점

제품 및 전달 팀

배포와 릴리스를 분리하도록 설계하세요. 플래그를 쓰고, 데이터 변경을 호환되게 하고, 되돌아갈 길을 계획하세요. 자기 릴리스를 지켜보고, 사용자와 지원이 이해할 수 있는 노트를 쓰세요.

서비스 및 운영 팀

준비 상태, 모니터링, 롤백을 정의하도록 도우세요. 릴리스 정보를 일찍 요청하고 개발자에게 필요한 것을 알리세요. 프로덕션에 무엇이 있는지에 대한 기록을 정확하게 유지하세요.

리더십과 거버넌스

릴리스 시점을 배포 일정이 아니라 사업과 함께 결정하세요. 파이프라인과 플래그 도구에 재원을 대세요. 영향이 큰 기능에는 단계적 롤아웃을 요구하고, 준비 상태와 무관하게 정해진 날짜에 릴리스하라는 압력을 피하세요.

고객과 사용자

중요한 변경에 대해 이해할 수 있는 용어로 듣고, 문제를 쉽게 보고할 수 있어야 합니다. 얼리 액세스에 참여한다면 피드백을 요청받을 것을 예상하고 보는 것을 팀에 알려 주세요.

애자일, AI, 자동화, 분석

애자일

초기 단계에 실제 사용자가 참여하는 작고 잦은 릴리스가 빠른 피드백을 줍니다. 각 릴리스를 학습 단계로 다루고 다음을 조정하세요. 주의: 파이프라인이 할 수 있다고 해서 사용자가 원하지 않는 기능을 릴리스하지 마세요. 사용자와 가치를 확인하세요.

AI

AI는 변경과 티켓에서 릴리스 노트의 초안을 쓰고, 롤아웃 후 피드백을 요약하고, 무엇을 지켜볼지 제안할 수 있습니다. 책임자를 지정하고, 게시하기 전에 사람이 초안을 변경과 비교하게 하세요. 주의: 그럴듯하지만 잘못된 릴리스 노트는 사용자와 지원을 오도하므로 실제 변경과 대조해 확인하세요. 주제 5.4 — 인시던트, 지식, 변경을 위한 생성형 AI를 참조하세요.

자동화

배포, 단계적 롤아웃, 상태 점검, 나쁜 지표에서의 자동 중단, 롤백을 로그와 수동 재정의와 함께 자동화하세요. 주의: 나쁜 지표에서 작동하는 자동 롤아웃 규칙은 오작동할 수 있으므로 시험하고 사람에게 계속 알리세요. 주제 6.4 — 파이프라인과 자동화된 변경을 참조하세요.

분석

롤아웃 중 릴리스된 그룹과 다른 그룹의 오류, 작업 성공, 불만 같은 지표를 비교하세요. 주의: 작은 그룹은 노이즈가 많은 결과를 주고 신중하지 않은 비교는 오도할 수 있으므로, 무엇을 보고 얼마나 기다릴지 합의하세요. 주제 7.3 — 측정과 보고와 서비스 관리 지표(Service Management Metrics) 책을 참조하세요.

흔한 실패 유형

  • 함께 묶인 릴리스와 배포. 모든 출시가 위험합니다. 플래그와 단계적 롤아웃으로 분리하세요.
  • 아무도 소유하지 않는 플래그. 코드가 죽은 경로로 가득 찹니다. 오너와 제거 날짜를 기록하세요.
  • 빠른 복귀 방법이 없음. 나쁜 릴리스가 몇 시간 갑니다. 롤백과 플래그 전환을 리허설하세요.
  • 지원이 첫 전화로 알게 됨. 데스크가 준비되지 않았습니다. 미리 노트와 안내서를 주세요.
  • 개발자를 위해 쓴 릴리스 노트. 사용자가 읽지 못합니다. 독자를 위해 쓰세요.
  • 계획되지 않은 데이터 변경. 롤백이 불가능합니다. 호환되는 작은 단계를 쓰세요.
  • 아무것도 지켜보지 않음. 사용자가 문제를 발견합니다. 지켜볼 사람을 지정하고 지표를 정하세요.

성숙도 모델

영역 시작 발전 표준화 관리 오케스트레이션
배포와 릴리스의 분리 같은 사건 일부 플래그를 쓴다 중요한 기능에 플래그와 단계적 롤아웃 롤아웃 결정을 데이터에 근거한다 서비스 전반에 가드레일과 함께 롤아웃을 자동화한다
롤백 느리고 수동 문서화되어 있다 리허설한 빠른 경로 복구 시간을 측정한다 자동화되어 있고 정기적으로 시험한다
소통 출시 때 공지 일부 릴리스에 노트 독자별 노트, 지원 팀에 사전 브리핑 노트를 독자와 시험한다 소통이 파이프라인 및 채널과 통합된다
기록 기억과 이메일 스프레드시트 파이프라인에서 생성한다 검토와 감사에 쓰인다 버전, 플래그, 인시던트 전반에 연결된다

체크리스트

  • 중요한 변경에서 배포와 릴리스를 분리한다.
  • 기능 플래그에 오너와 제거 날짜가 있다.
  • 정의된 지표와 중단 기준과 함께 단계적으로 롤아웃한다.
  • 빠르게 끄거나 롤백하는 방법을 알고 리허설했다.
  • 지원이 사용자보다 먼저 릴리스 정보를 받는다.
  • 릴리스 노트를 독자를 위해 쓴다.
  • 데이터 변경은 호환되고 되돌릴 수 있는 단계로 한다.
  • 무엇이 릴리스되었는지에 대한 기록을 파이프라인에서 생성한다.

AI 프롬프트

검토용 릴리스 노트의 초안을 작성합니다.

Here are the changes in this release: [paste list of changes with ticket titles]. The audience is [users, support staff, or operations].
Draft release notes of under 200 words in plain language, grouped by what users will notice, and list items you could not describe without guessing. Do not add features or dates that are not in the list.
List what you are unsure of.

릴리스 준비 상태 점검표를 준비합니다.

Our release: [describe]. Risks we know of: [list]. Our usual checks: [list].
Draft a checklist of up to ten yes/no questions to answer before release, with who answers each. Keep it short and tied to the listed risks.
List what you are unsure of.

단계적 롤아웃을 계획합니다.

Our feature: [describe]. Our users: [groups and sizes]. Indicators we can measure: [list].
Propose three stages with the audience, what to watch, how long, and what would make us stop. Note what the indicators cannot tell us. Do not claim any stage is safe.
List what you are unsure of.

AI 스킬

  • release-notes: 독자별로 릴리스 노트를 쓸 때 사용합니다.
  • changelog: 변경의 명확한 이력을 유지할 때 사용합니다.
  • shift-left-testing: 파이프라인의 더 이른 단계에서 테스트할 때 사용합니다.
  • runbook: 롤아웃과 롤백 단계를 문서화할 때 사용합니다.

주요 출처

  • Jez Humble and David Farley, Continuous Delivery (2010): 배포 파이프라인과 릴리스 기법의 토대.
  • PeopleCert, ITIL certification pages: 릴리스 및 배포 관리 프랙티스에 대한 소유자의 설명.
  • Wikipedia, "Software deployment" and "Feature toggle": 주요 생각의 개관.
  • Wikipedia, "Release management": 이 분야의 배경.

참고 문헌

  1. Release management — Wikipedia — https://en.wikipedia.org/wiki/Release_management
  2. Software deployment — Wikipedia — https://en.wikipedia.org/wiki/Software_deployment
  3. Software release life cycle — Wikipedia — https://en.wikipedia.org/wiki/Software_release_life_cycle
  4. Feature toggle — Wikipedia — https://en.wikipedia.org/wiki/Feature_toggle
  5. Blue–green deployment — Wikipedia — https://en.wikipedia.org/wiki/Blue%E2%80%93green_deployment
  6. Release notes — Wikipedia — https://en.wikipedia.org/wiki/Release_notes
  7. Changelog — Wikipedia — https://en.wikipedia.org/wiki/Changelog
  8. Software versioning — Wikipedia — https://en.wikipedia.org/wiki/Software_versioning
  9. Schema migration — Wikipedia — https://en.wikipedia.org/wiki/Schema_migration
  10. Deployment environment — Wikipedia — https://en.wikipedia.org/wiki/Deployment_environment
  11. Continuous delivery — Wikipedia — https://en.wikipedia.org/wiki/Continuous_delivery