3.3. 사용자 Hermes 새 이미지 롤아웃

개요

사용자마다 AI 에이전트 작업공간(사용자마다 하나씩 만들어지는 AI 에이전트의 일터, 용어 사전)에 Hermes 가 하나씩 돕니다. Hermes 는 AI 에이전트를 실제로 움직이는 프로그램입니다. 이 프로그램을 새 버전으로 바꾸려면 작업공간을 다시 시작해야 합니다. 롤아웃은 이 일을 한꺼번에 하지 않고 차례로 합니다. 먼저 카나리(먼저 바꿔 보는 시험용 작업공간) 하나를 바꾸고, 관리자가 확인한 뒤 나머지를 몇 개씩 묶어 바꿉니다. 새 버전이 나왔을 때, 또는 작업공간이 오래된 버전으로 남았을 때 이 장을 봅니다.

권한: 롤아웃은 관리자에게만 보입니다. 서버도 관리자가 아닌 사람의 요청을 거절합니다.

관리자 일과 운영자 일

누가	하는 일
운영자(AAS 를 설치하고 서버를 관리하는 사람)	새 Hermes 버전을 만들어 서버에 올립니다. 그 버전을 가리키는 값을 관리자에게 줍니다.
관리자	받은 값을 「새 버전 롤아웃」 화면에 붙여 넣고, 카나리에서 대화해 확인하고, 계속하거나 되돌립니다.

새 버전을 만들어 서버에 올리는 일은 이 장의 범위가 아닙니다. 관리자는 그 일을 하지 않습니다.

시작하기 전에 준비할 것

운영자에게 새 버전의 이름과 「새 버전을 고르는 값」을 요청합니다. 요청 예:

새 Hermes 버전 롤아웃을 하려고 합니다. 버전 이름과 Hermes 이미지 digest(새 버전을 가리키는 저장소@sha256: 로 시작하는 긴 값)를 알려 주세요. 읽기 사이드카(작업공간의 파일을 읽는 보조 프로그램)도 바꾸는 경우에만 사이드카 이미지 digest 도 알려 주세요.

준비물	설명
버전 이름	화면에 보일 이름입니다. 예: 1.0.6-0.23.0
Hermes 이미지 digest	새 Hermes 버전을 가리키는 값입니다. 저장소@sha256: 뒤에 64자가 붙습니다. 운영자에게 받습니다.
사이드카 이미지 digest	읽기 사이드카도 바꿀 때만 필요합니다. 형식은 같습니다. Hermes 와 사이드카 중 하나 이상을 적습니다.
카나리	관리자가 직접 채팅해 볼 수 있는 작업공간입니다.
사용자 안내	사용자 연결이 잠시 끊깁니다. 5.2. 공지의 「점검」 공지로 미리 알립니다.

버전 확인

왼쪽 메뉴의 「내 AI 에이전트 › AI 에이전트 작업공간」을 엽니다. 「버전」 열이 관리자에게만 보입니다.

• 첫 줄은 버전 이름입니다. 이름이 없으면 새 버전을 고르는 값(digest)의 앞 12자가 나옵니다.
• 둘째 줄은 digest 앞 12자입니다. 전체 값은 마우스를 올리면 설명 말풍선으로 보이고, 복사 버튼(「digest 복사」)으로 복사합니다.
• 사이드카의 digest 는 작업공간 서랍(행을 누르면 오른쪽에서 열리는 상세 창)의 「사이드카」 줄에만 나옵니다.
• 멈춘 작업공간처럼 실행 중인 Hermes 가 없으면 버전 칸이 비어 있습니다.

버전 옆의 표시는 다음을 뜻합니다.

표시	뜻
오래됨	목표 버전이 아닙니다.
따로 지정됨	이 작업공간에만 다른 버전을 지정했습니다. 롤아웃에서 제외됩니다.
알 수 없음	아직 롤아웃을 한 적이 없어 비교할 목표가 없습니다.

화면 위의 「오래됨」 보기 카드는 오래된 작업공간의 수를 세고, 둘째 줄에 「목표 {버전 이름}」을 보여 줍니다. 오래된 작업공간이 없으면 「모든 AI 에이전트 작업공간이 목표 버전입니다」가 나옵니다. 첫 롤아웃 전에는 이 카드에 수가 나오지 않고, 띠에 「아직 롤아웃을 한 적이 없어 오래된 AI 에이전트 작업공간을 알 수 없습니다」가 나옵니다. 롤아웃을 한 번 하면 이 상태가 없어집니다. 처음에는 지금 쓰는 버전의 값을 운영자에게 받아 롤아웃을 만듭니다.

그림 3.3-1. 「오래됨」 카드로 거른 목록

롤아웃 시작

1. 「AI 에이전트 작업공간」 화면 오른쪽 위의 「새 버전 롤아웃」을 누릅니다.
2. 「버전 이름」에 새 버전 이름을 적습니다.
3. 「Hermes 이미지 digest」에 값을 붙여 넣습니다. 형식이 맞지 않으면 「저장소@sha256:<64자> 형식이 아닙니다」가 나옵니다.
4. 사이드카도 바꾸면 「사이드카 이미지 digest」에 값을 붙여 넣습니다.
5. 「카나리」에서 먼저 바꿀 작업공간을 고릅니다. 멈춘 작업공간과 「따로 지정됨」 작업공간은 목록에 없습니다.
6. 「묶음 크기」를 1부터 5 사이에서 고릅니다. 기본값은 2입니다.
7. 「대화 중이면 뒤로 미룸」을 확인합니다. 기본값은 켜짐입니다.
8. 아래 요약 「대상 {n} · 따로 지정됨 제외 {k} · 멈춤 {j}(켜질 때 반영)」을 읽습니다.
9. 「시작」을 누르고 확인 창에서 확인합니다.

그림 3.3-2. 「새 버전 롤아웃」 서랍(시작하지 않고 닫았습니다)

시작하면 「롤아웃 {버전} 을(를) 시작했습니다」가 나오고 화면 위에 진행 띠가 생깁니다. 저장소 주소가 지금 쓰는 값과 다르면 칸 아래에 경고가 나옵니다. 경고는 시작을 막지 않습니다. 운영자에게 받은 값이 맞는지 확인합니다. 「카나리」를 「카나리 없이」로 두면 확인 단계 없이 묶음 단위로 바로 진행합니다.

진행 중인 롤아웃이 있거나 롤아웃 상태를 읽지 못하면 「새 버전 롤아웃」 버튼이 꺼지고, 이유가 설명 말풍선으로 나옵니다. 롤아웃은 한 번에 하나만 진행합니다. 크기를 적용하는 롤아웃(3.5. 작업공간 크기와 노드 여유)이 진행 중일 때도 꺼집니다.

진행 단계와 할 일

화면 위의 띠가 지금 단계를 보여 줍니다.

단계	띠 문구	버튼	지금 할 일
준비	「롤아웃 준비 중」과 버전 이름	멈춤, 자세히	기다립니다.
카나리 바꾸는 중	카나리 {이름} 을(를) 바꾸는 중 · {n}분째(제한 15분)	멈춤, 자세히	기다립니다.
카나리 확인 기다림	카나리 {이름} 이(가) {버전} 으로 떴습니다 · 준비까지 {n}분 · {n}분째 기다림	계속, 카나리 열기, 되돌리기	카나리를 열어 대화해 보고 「계속」 또는 「되돌리기」를 누릅니다.
묶음 진행	롤아웃 {버전} · 묶음 {n} · {끝난 수}/{전체 수} 끝남	멈춤, 자세히	기다립니다.
멈춤	「멈춤」, 끝난 수/전체 수, 「지금 바꾸던 묶음은 끝까지 바뀝니다」	계속, 되돌리기, 자세히	이유를 확인하고 「계속」 또는 「되돌리기」를 누릅니다.
끝남	{n}개 모두 {버전} 으로 바뀜	자세히, 닫기	「닫기」를 누릅니다.
실패	롤아웃이 실패했습니다	바뀐 {n}개 모두 이전 버전으로, 같은 목표로 다시 시작, 자세히, 닫기	「실패했을 때」를 봅니다.

「카나리 확인 기다림」「멈춤」「실패」 단계에서는 띠가 경고색입니다. 관리자가 조치해야 하는 단계입니다.

그림 3.3-3 은 위 표의 단계가 이어지는 순서와 갈래를 그린 것입니다.

그림 3.3-3. 새 버전 롤아웃의 단계

카나리 확인하고 계속하기

1. 띠가 「카나리 {이름} 이(가) {버전} 으로 떴습니다」로 바뀌면 「카나리 열기」를 누릅니다.
2. 카나리 작업공간의 서랍에서 「버전」과 상태를 확인합니다.
3. 채팅에서 그 작업공간과 대화해 새 버전이 정상으로 답하는지 확인합니다.
4. 이상이 없으면 띠의 「계속」을 누릅니다.
5. 확인 창의 「다음 묶음 {n}개({이름})를 바꿉니다. 사용자 연결이 잠시 끊깁니다.」를 읽고 확인합니다.

성공하면 띠가 「묶음 진행」으로 바뀌고 끝난 수가 늘어납니다. 이상이 있으면 「되돌리기」를 누릅니다. 바뀐 작업공간을 각자의 이전 버전으로 되돌립니다.

멈추기와 되돌리기

• 「멈춤」은 확인 없이 바로 멈춥니다. 지금 바꾸던 묶음은 끝까지 바뀝니다.
• 「계속」은 다음 묶음부터 이어 갑니다.
• 「되돌리기」는 확인 창에서 바뀐 작업공간의 수와 이름을 보여 줍니다. 확인하면 이전 버전으로 되돌리는 롤아웃이 시작되고, 띠에 「되돌리는 중」이 나옵니다.

롤아웃이 작업공간을 고르는 방법

• 대화 중인 작업공간: 「대화 중이면 뒤로 미룸」이 켜져 있으면 마지막 묶음으로 미룹니다. 띠의 둘째 줄에 「대화 중이라 미룸 {n}개」가 나옵니다.
• 멈춘 작업공간: 지금 바꾸지 않습니다. 다시 켜질 때 새 버전으로 뜹니다. 띠에 「멈춤 {n}개는 켜질 때 반영」이 나옵니다.
• 따로 지정됨: 롤아웃에서 제외합니다. 띠에 「따로 지정됨 {n}개 제외」가 나옵니다.
• 작업 중인 작업공간: 실행 중인 작업이 끝날 때까지 기다린 뒤 바꿉니다.
• 롤아웃 중에 새로 만든 작업공간: 처음부터 새 버전으로 만듭니다.

실패했을 때

묶음 안의 작업공간이 제한 시간 15분 안에 준비되지 않거나 서버에 자리가 없으면 롤아웃이 멈추고 실패로 표시됩니다. 이때 그 묶음에서 준비되지 않은 작업공간만 자동으로 이전 버전으로 돌아갑니다. 이미 끝난 작업공간은 새 버전으로 남습니다.

1. 띠의 「자세히」를 눌러 작업공간별 상태와 메시지를 확인합니다. 표에는 「AI 에이전트 작업공간」「상태」「이전 → 목표」「시작」「끝」「메시지」가 나옵니다.
2. 실패 이유를 해결합니다. 서버에 자리가 없으면 띠에 「노드 자리가 부족해 뜨지 못했습니다」가 덧붙습니다. 푸는 법은 3.5. 작업공간 크기와 노드 여유의 「노드 자리가 없을 때」를 봅니다.
3. 새 버전으로 남은 작업공간까지 모두 되돌리려면 「바뀐 {n}개 모두 이전 버전으로」를 누릅니다.
4. 같은 버전으로 다시 하려면 「같은 목표로 다시 시작」을 누릅니다. 시작 서랍이 같은 값으로 채워져 열립니다.
5. 이유를 모르겠으면 운영자에게 알립니다. 「자세히」의 메시지와 실패한 작업공간 이름을 함께 전달합니다.

작업공간별 상태 표시는 다음과 같습니다.

표시	뜻
차례 기다림	아직 차례가 아닙니다.
바꾸는 중	새 버전으로 바꾸는 중입니다.
끝남	새 버전으로 바뀌었습니다.
되돌림	이전 버전으로 돌아갔습니다.
실패	바꾸지 못했습니다.

사용자에게 보이는 것

바꾸는 중인 작업공간의 주인에게는 「Hermes 를 새 버전으로 바꾸는 중입니다. 보통 1~2분, 길면 15분 걸립니다. 대화와 파일은 그대로 있습니다.」가 나옵니다. 관리자 목록에서는 그 작업공간에 「업데이트 중」이 나오고 「문제 있음」에 세지 않습니다. 제한 시간을 넘겨 실패하면 다시 「문제 있음」에 셉니다.

끝난 뒤

• 끝남 띠는 마친 뒤 24시간 동안 보입니다. 「닫기」를 누르면 이 브라우저에서 그 롤아웃의 띠가 사라집니다.
• 다른 관리자가 먼저 같은 조작을 했으면 「다른 관리자가 이미 바꿨습니다」가 나오고 화면이 다시 읽힙니다.
• 띠에 「마지막 롤아웃의 이미지가 지금 설치된 이미지와 다릅니다」와 「버전을 올릴 때는 롤아웃을 만드세요」가 나오면, 설치 때 정한 버전과 마지막 롤아웃의 버전이 다르다는 뜻입니다. 운영자에게 알립니다.
• 크기를 적용할 때도 같은 띠를 씁니다. 롤아웃은 종류와 관계없이 한 번에 하나만 진행합니다. 크기는 3.5. 작업공간 크기와 노드 여유를 봅니다.

관련 문서

• 3.1. 작업공간 목록과 개수 한도
• 3.2. 작업공간 상태와 다시 시작
• 3.5. 작업공간 크기와 노드 여유
• 5.2. 공지