리눅스에서 Google Cloud Storage 마운트 — CI 파이프라인용 NetDrive
NetDrive로 Ubuntu에서 Google Cloud Storage 버킷을 로컬 경로로 마운트하세요 — 리눅스 CI 러너와 빌드 에이전트에 GCS 액세스를 설정합니다.
Ubuntu에서 실행되는 빌드 에이전트가 Google Cloud Storage 버킷에 저장된 사전 빌드된 컨테이너 레이어와 참조 데이터셋을 읽어야 하는데, 현재 파이프라인 단계는 gsutil cp 실행 후 대기하는 방식입니다. 실제 테스트 스위트가 시작되기도 전에 모든 작업이 수 기가바이트를 다운로드하며, 픽스처의 절반은 실행 간에 전혀 바뀌지 않습니다. 해당 GCS 버킷을 러너의 경로로 마운트하면 복사 단계가 사라집니다 — 파이프라인은 디스크의 다른 디렉터리를 읽듯 버킷을 직접 읽습니다.
Ubuntu에서 GCS 마운트 — 다운로드 단계를 건너뛰세요
NetDrive 는 Google Drive, OneDrive, S3, SFTP, WebDAV 등을 Windows 와 macOS 에서 일반 드라이브처럼 보이게 합니다 — 동기화도, 전체 다운로드도 없이.
- 클라이언트 라이브러리 변경 없이 버킷 객체를 일반 파일 경로로 읽기
- CI 러너가 이미 사용 중인 동일한 Ubuntu 16.04+ 빌드에서 작동
- 작업이 시작되기 전에 자동 마운트로 경로를 준비 완료 상태로 유지
무료 체험. 평생 라이선스와 구독 플랜 제공.
GCS 지원과 리눅스에서 “실험적”이라는 말의 의미
NetDrive는 버전 3.15.450에서 추가된 MIME 타입 처리를 포함해 초기 릴리스부터 Google Cloud Storage를 지원해 왔습니다. 이 부분은 Windows, macOS, 리눅스 전반에 걸쳐 동일합니다 — 같은 GCS 연결 로직, 같은 버킷 탐색 방식입니다.
리눅스 빌드 자체는 이야기가 다릅니다. NetDrive의 리눅스 릴리스는 github.com/NetDrive/installer에서 배포되며, 안정적인 프로덕션급 릴리스가 아니라 실험적(experimental) 기능으로 표시되어 있습니다. Ubuntu 16.04 이상에서 작동합니다. 이 구분은 CI 사용 사례에서 중요합니다: 리눅스 러너에서의 GCS 마운트는 빌드 에이전트, 스테이징 작업, 내부 도구용으로는 적합하지만 고객 대상 프로덕션 서비스의 스토리지 계층으로는 사용하지 마십시오. 팀에 안정적이고 완전히 지원되는 경험이 필요하다면 Windows나 macOS를 권장 환경으로 사용하세요.
버킷을 마운트 지점으로 설정하기
사용 중인 Ubuntu 버전에 맞는 GitHub 릴리스에서 NetDrive를 설치했다면, GCS 버킷을 추가하는 과정은 다른 공급자와 동일한 흐름을 따릅니다.
- Open NetDrive → + Add Drive를 클릭하고 공급자 목록에서 Google Cloud Storage를 선택합니다.
- 대상 프로젝트와 버킷을 소유하고 있거나 읽기/쓰기 권한이 있는 Google 계정으로 로그인합니다.
- 마운트할 버킷을 선택한 다음 마운트 지점을 지정합니다 — Windows 드라이브 문자가 아니라
/mnt/gcs-fixtures와 같은 디렉터리 경로입니다. - 아무도 로그인해 있지 않은 상태로 작업 사이에 재부팅될 수 있는 CI 러너에서 중요한, 부팅 시 드라이브를 자동으로 마운트할지 여부를 선택합니다.
마운트가 완료되면 버킷은 다른 디렉터리와 마찬가지로 파일 시스템에 나타납니다. /mnt/gcs-fixtures/snapshots/를 가리키는 테스트 러너는 파일이 실제로 Cloud Storage에 있다는 사실을 알거나 신경 쓸 필요가 없습니다.
작업이 의존하기 전에 마운트 확인하기
마운트가 성공했다고 가정하고 테스트 실행 도중에 실패하는 CI 작업은 설정 단계에서 실패하는 작업보다 더 나쁩니다. 파이프라인이 진행되기 전에 마운트 상태를 확인하세요 — 마운트 지점에 대한 간단한 ls 명령이나 NetDrive의 nd3cmd 커맨드라인 도구를 이용한 점검을 통해, 이후 단계에서 무언가가 이를 사용하려 시도하기 전에 버킷이 실제로 연결되어 읽을 수 있는 상태인지 확인할 수 있습니다.
마운트 결과가 비어 있거나 작업이 대기 상태로 멈춘다면 Add Drive 단계를 다시 실행하고 자격 증명을 다시 확인하세요 — 이 단계에서 발생하는 대부분의 실패는 버킷 자체의 문제가 아니라 만료되거나 취소된 Google 계정 토큰 때문입니다.
마무리
Ubuntu에서 실행되는 빌드 에이전트와 내부 도구의 경우, NetDrive로 GCS 버킷을 마운트하면 객체 스토리지가 일반 경로가 되어 대부분의 CI 구성이 기본적으로 사용하는 다운로드 후 실행 패턴을 없앨 수 있습니다. 파이프라인이 대신 Amazon S3를 읽는다면 Mount Amazon S3 on Linux with NetDrive에서 동일한 설정 과정을 다루며, NetDrive on Ubuntu Linux는 어떤 공급자에 연결하든 적용되는 설치 세부 사항을 다룹니다. 이미 S3 테스트 픽스처로 이 작업을 하고 있는 팀이라면 S3 Test Fixtures for CI Teams에서 더 폭넓은 패턴을 참고할 수 있습니다.
— Kai, NetDrive