Vagrant Cloud에서 레지스트리 되찾기

Vagrant Cloud에서 레지스트리 되찾기

이 문서는 HashiCorp가 자동으로 마이그레이션한 Vagrant Cloud 레지스트리를 HashiCorp Cloud Platform(HCP) Vagrant Registry에서 되찾는(claim) 방법을 설명해요. 조직 소유자는 정해진 절차를 따라 자신의 레지스트리를 소유권을 인정받아 계속 관리하고 릴리스할 수 있어요.

출처: 문서

본문

참고

HCP Vagrant는 폐기 예정이에요. HCP Vagrant 레지스트리에 박스를 호스팅하는 고객은 새로운 공급자를 찾아 박스를 다시 호스팅해야 해요. 2026년 10월 1일부터는 새 박스를 더 이상 만들 수 없고, 기존 박스 배포는 2026년 12월 31일까지 운영된 뒤 모든 배포가 중단됩니다.

이 주제는 HashiCorp에 의해 마이그레이션된 Vagrant Cloud 레지스트리를 HCP Vagrant Registry에서 되찾는 방법을 설명드려요.

HCP Vagrant는 2024년 초봄에 Vagrant Cloud의 후속 서비스로 출시됐어요. 전환의 다음 단계로, HashiCorp는 기존 Vagrant Cloud 박스를 HCP Vagrant로 자동 마이그레이션하고 있어요. 자동 마이그레이션된 박스는 기존 URL에서 계속 사용할 수 있지만, 조직 소유자는 레지스트리를 계속 관리하고 박스를 릴리스하려면 반드시 자신의 레지스트리를 소유권 인정(claim)해야 해요.

되찾기 절차 개요

마이그레이션 절차는 다음과 같은 주요 단계를 거쳐요:

  1. HashiCorp가 조직을 마이그레이션한 후, 조직 소유자에게 알림 이메일이 발송돼요.
  2. 사용자가 HCP에 로그인하고 소유권을 인정하지 않은(unclaimed) 레지스트리를 확인해요.
  3. 사용자가 레지스트리를 선택해 HCP 프로젝트에 할당하며 소유권을 인정해요.
  4. 레지스트리를 인정한 후, 사용자는 HCP UI를 통해 이를 관리할 수 있어요.

사전 요구 사항

마이그레이션 절차를 시작하기 전에, Vagrant Cloud 계정에 연결된 것과 동일한 이메일을 사용하는 HCP 계정이 필요해요. Vagrant Cloud 계정에 연결된 이메일은 Vagrant Cloud 로그인 이메일과 다를 수 있어요. Vagrant Cloud 설정의 Profile에서 기본 이메일 주소를 확인할 수 있어요.

마이그레이션 상태 확인

HashiCorp가 Vagrant Cloud 조직을 마이그레이션하면, 소유자(owner) 수준 액세스 권한이 있는 모든 사용자는 자동 마이그레이션된 레지스트리를 되찾는 방법에 대한 알림을 받아요. 알림을 받지 못했다면 이메일 스팸 폴더를 확인해 보세요.

마이그레이션된 조직은 Vagrant Cloud의 Settings에서 더 이상 확인되지 않아요. 조직이 Vagrant Cloud 설정에서 더 이상 보이지 않으면, HashiCorp가 해당 조직을 HCP Vagrant Registry로 자동 마이그레이션했을 가능성이 높아요.

소유권을 인정하지 않은 레지스트리에 접근하기

Vagrant Cloud 레지스트리를 보고 되찾기 전에 Vagrant Cloud 계정과 HCP Vagrant 계정을 연결해야 해요. Vagrant Cloud 계정을 연결하지 않았다면 Link & reclaim을 클릭하고 Vagrant Cloud에 로그인해 계정을 연결하세요.

Vagrant Cloud와 HCP Vagrant 계정 연결

사이드바에서 Vagrant Registry, 그다음 Unclaimed Registries로 이동하면 계정에 연결된 자동 마이그레이션된 Vagrant Cloud 조직을 볼 수 있어요.

레지스트리 되찾기

Vagrant Cloud와 HCP 계정을 연결하고 나면 Unclaimed Registries 페이지에 자동 마이그레이션된 레지스트리 목록이 표시돼요. 이 과정은 몇 초밖에 걸리지 않지만, 일부 사용자는 Unclaimed Registries 페이지를 새로고침해야 할 수도 있어요.

되찾고 싶은 레지스트리의 체크박스를 선택하고, 레지스트리를 마이그레이션할 HCP 프로젝트를 선택한 다음 Reclaim 버튼을 클릭하세요.

Vagrant Cloud 레지스트리를 되찾고 나면, Registries 페이지로 이동해 마이그레이션된 레지스트리를 다룰 수 있어요.

문제 해결

계정이 연결되어 있는데도 되찾을 수 있는 레지스트리가 없다면, 자신의 Vagrant Cloud 조직이 마이그레이션됐는지 확인해 보세요. Vagrant Cloud의 Organizations 탭에서 조직이 여전히 Vagrant Cloud에 남아 있지 않은지 확인할 수 있어요.

이전된 레지스트리에 접근할 수 없거나, 계정을 연결했는데도 Vagrant Cloud와 Unclaimed Registries 페이지 양쪽에서 조직이 보이지 않는다면, 지원팀에 문의해 도움을 받으세요.

더 알아보기