리눅스에서 OneDrive for Business 마운트 — NetDrive 실험적 빌드

한 데이터 엔지니어가 우분투 장비에서 ETL 스크립트를 관리하는데, 재무팀이 OneDrive for Business에 보관하는 참조 스프레드시트를 읽어야 한다. 지금은 브라우저를 통해 파일을 일일이 다운로드하고, 재무팀이 원본을 수정할 때마다 다시 업로드해야 한다는 뜻이다. NetDrive의 리눅스 빌드는 동일한 OneDrive for Business 라이브러리를 일반 우분투 마운트 지점으로 마운트하므로, cron 작업의 open() 호출이 오래된 로컬 사본이 아니라 최신 파일에 직접 접근한다.

리눅스에서 OneDrive for Business 마운트하기

NetDrive 는 Google Drive, OneDrive, S3, SFTP, WebDAV 등을 Windows 와 macOS 에서 일반 드라이브처럼 보이게 합니다 — 동기화도, 전체 다운로드도 없이.

• OneDrive for Business가 일반 우분투 마운트 지점으로 나타남
• 파일이 필요할 때 스트리밍됨 — 동기화 클라이언트도, 전체 다운로드도 없음
• Microsoft 365 업무용 및 학교 계정과 호환

WindowsmacOS

리눅스용 NetDrive 다운로드 →

무료 체험. 평생 라이선스와 구독 플랜 제공.

리눅스 장비에 이 기능이 필요한 이유

OneDrive for Business는 개인 Microsoft 계정이 아닌 Azure AD로 인증하는, 업무용 또는 학교 계정에 연결된 Microsoft 365 문서 저장소다. Microsoft는 리눅스용 네이티브 OneDrive 동기화 클라이언트를 제공하지 않기 때문에, 이 파일들이 필요한 리눅스 워크스테이션이나 CI 러너는 보통 수동 브라우저 다운로드나 Windows를 쓰는 동료가 첨부파일을 전달해 주는 방식에 의존한다. NetDrive는 첫 출시 때부터 OneDrive for Business를 지원해 왔고, 동일한 연결 유형을 리눅스 빌드에서도 제공한다 — 이 라이브러리는 마운트 지점을 통해 읽기 요청을 Microsoft 서버에 직접 해결하므로, 최신 상태를 유지해야 하는 로컬 동기화 폴더가 필요 없다.

우분투에 NetDrive 설치하기

NetDrive for Linux는 우분투 패키지 저장소에 없으므로 GitHub를 통해 설치한다.

1. github.com/NetDrive/installer로 이동해 사용 중인 우분투 버전에 맞는 릴리스를 다운로드한다.
2. 해당 저장소의 릴리스 노트를 따른다 — NetDrive가 무언가를 마운트하려면 먼저 드라이버 컴포넌트를 설치해야 한다.
3. NetDrive 패키지 자체를 설치한다.
4. NetDrive를 실행한다. 첫 실행 시 드라이버 컴포넌트가 로드되며 sudo를 요청할 수 있다.

최소 지원 버전은 Ubuntu 16.04다. 업데이트는 apt upgrade가 아니라 GitHub 릴리스로 배포된다. 리눅스는 NetDrive 자체 비교 페이지 전반에서 사용하는 실험적 표기가 동일하게 적용된다 — 직접 테스트하지 않고 무인 프로덕션 작업을 맡기기보다는, 리눅스에서의 OneDrive for Business 마운트를 개발 워크스테이션이나 CI 러너용으로 다루는 것이 적절하다.

단계별 안내: 우분투에서 OneDrive for Business 연결하기

1. NetDrive의 Drive Manager를 열고 + Add Drive를 클릭한다.
2. 연결 유형 목록에서 Select OneDrive for Business를 선택한다 — 개인용 OneDrive와는 별도로 나열되어 있다.

3. 기본 브라우저에서 열리는 Azure AD OAuth 흐름을 통해 Microsoft 365 업무용 또는 학교 계정으로 로그인한다. 브라우저가 설치되지 않은 헤드리스 우분투 장비에서는, 같은 계정에 로그인된 다른 컴퓨터에서 1회 인증을 완료한다.
4. 마운트 지점을 설정한다 — /mnt/onedrive-business와 같은 경로, 또는 쓰기 권한이 있는 빈 디렉터리라면 어디든 가능하다.
5. Connect를 클릭한다. NetDrive가 인증을 수행하고 해당 경로에 라이브러리를 마운트한다.

의존하기 전에 마운트 확인하기

GUI만 믿지 말고 터미널에서 마운트가 실제로 됐는지 확인하자.

# Confirm the mount is listed
mount | grep onedrive

# Or just try listing it
ls /mnt/onedrive-business

첫 시도에서 목록이 비어 있어도 곧바로 실패로 단정하지 말고 잠시 기다려 보자 — 대용량 문서 라이브러리는 루트를 채우는 데 몇 초 걸릴 수 있다. 그 후에도 여전히 비어 있다면 먼저 Azure AD 로그인 단계를 다시 확인한다. 헤드리스 장비에서 OneDrive for Business 연결이 끝까지 완료되지 않는 가장 흔한 원인은 중단된 브라우저 인증 흐름이다.

리눅스 빌드에서 미리 알아둘 점

• 별도의 릴리스 주기 — 리눅스 드라이버 컴포넌트는 자체 일정으로 관리되므로, Windows나 macOS에 적용된 수정 사항이 같은 주에 리눅스로 자동 반영되지는 않는다.
• apt 통합 없음 — 설치와 업데이트는 우분투 기본 패키지 관리자가 아니라 GitHub 릴리스를 통해 이루어진다.
• Windows와 macOS가 검증된 대상 — NetDrive 자체 가이드는 이 두 플랫폼을 프로덕션에 적합하다고 다루며, 리눅스는 실험적으로 표기한다. 가끔 파일을 읽는 개발 워크스테이션이나 CI 러너에는 충분히 적합하다. OneDrive for Business 접근에 의존하는 무인 프로덕션 작업이라면 자신의 환경에서 먼저 충분히 테스트할 가치가 있다.

마무리

우분투에서 OneDrive for Business를 마운트하면 리눅스 장비도 NetDrive가 Windows와 macOS에서 제공하는 것과 동일한 드라이브 방식 접근을, apt가 아니라 GitHub에 있는 설치 프로그램을 통해 얻을 수 있다. 더 폭넓게 검증된 플랫폼에서 동일한 공급자를 다루는 글은 Windows에서 NetDrive로 OneDrive for Business 마운트하기 또는 macOS에서 NetDrive로 OneDrive for Business 마운트하기를 참고하라. 리눅스 전반에 대해서는 우분투 리눅스에서의 NetDrive를 참고하라.

— Casey, NetDrive