리눅스에서 SharePoint 마운트하기 — NetDrive 실험적 빌드

어떤 엔지니어링 팀은 빌드 서버와 개발 워크스테이션 절반을 우분투에서 운영하지만, 회사의 나머지 부분은 윈도우를 쓰며 아키텍처 문서, 벤더 계약서, 온보딩 자료를 SharePoint 문서 라이브러리에 보관한다. 지금은 리눅스 박스에서 스펙 문서를 확인하려면 브라우저 탭을 열어 파일을 손으로 다운로드하거나, 윈도우를 쓰는 동료에게 내용을 Slack에 붙여넣어 달라고 부탁해야 한다. NetDrive의 리눅스 빌드는 바로 그 SharePoint 라이브러리를 일반 우분투 마운트 지점으로 마운트해 주므로, cat, less, 또는 스크립트의 open() 호출이 살아있는 문서에 직접 접근할 수 있다.

리눅스에서 SharePoint 라이브러리 마운트하기

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

• SharePoint 문서 라이브러리가 일반 우분투 마운트 지점으로 나타납니다
• 파일이 필요할 때 스트리밍됩니다 — 동기화 클라이언트도, 전체 다운로드도 필요 없습니다
• 개인 SharePoint 사이트와 SharePoint for Business 모두에서 동작합니다

WindowsmacOS

리눅스용 NetDrive 다운로드 →

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

왜 브라우저 탭 대신 마운트인가

SharePoint 자체의 작업 방식은 브라우저를 전제로 하거나, 윈도우에서는 라이브러리를 손대기 전에 통째로 다운로드하는 동기화 클라이언트를 전제로 한다. 둘 다 파일 하나씩만 읽으면 되는 리눅스 개발 박스에는 맞지 않는다. NetDrive는 마운트 지점을 통해 SharePoint 사이트에 대한 읽기를 직접 처리하므로, 설정 템플릿을 여는 빌드 스크립트는 수동 내보내기 없이도 최신 버전을 받아온다.

SharePoint 지원은 NetDrive 3.16.589 버전(2022년 3월)부터 제공되어 왔다. NetDrive 3.17.799에서는 비동기 디렉터리 목록 조회가 추가되었는데, 이는 여기서 중요하다. 라이브러리 하나에 파일이 수천 개인 SharePoint 사이트에서는 예전에 최초 폴더 읽기가 느렸고, 비동기 목록 조회는 이 지연이 발생하지 않도록 막아 준다. 드라이브 용량 표시는 3.16.667에서 추가되어, 같은 드라이브 화면에서 사이트 저장소 할당량 중 얼마나 사용 중인지 확인할 수 있다.

우분투에 NetDrive 설치하기

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

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

최소 지원 버전은 Ubuntu 16.04다. 업데이트는 apt upgrade가 아니라 GitHub 릴리스로 배포되므로, 해당 박스를 다루는 운영 문서 어디에든 이 점을 적어 둘 가치가 있다. 리눅스는 NetDrive 자체 비교 페이지 전반에서 쓰는 것과 같은 실험적(experimental) 표시를 그대로 달고 있다 — 테스트의 대부분은 윈도우와 macOS에 쏠려 있으므로, 리눅스에서의 SharePoint 마운트는 직접 충분히 테스트해 보기 전까지는 프로덕션 파이프라인에 걸기보다 개발 박스나 CI 러너에 적합한 것으로 다루는 편이 좋다.

단계별 안내: 우분투에서 SharePoint 연결하기

1. NetDrive의 드라이브 매니저를 연다 그리고 + Add Drive를 클릭한다.
2. 연결 유형 목록에서 Select SharePoint를 선택한다 — 같은 항목이 개인 SharePoint 사이트와 SharePoint for Business를 모두 다룬다.

3. 기본 브라우저에서 열리는 OAuth 흐름을 통해 Sign in with Microsoft를 진행한다. 브라우저가 설치되지 않은 헤드리스 우분투 박스에서는 X 포워딩 세션을 사용하거나, 같은 계정으로 로그인된 다른 컴퓨터에서 일회성 인증을 완료한다.
4. SharePoint 사이트 URL을 입력한다 — https://yourcompany.sharepoint.com/sites/LegalOps와 같은 형태다. 브라우저에서 해당 사이트를 보고 있을 때 주소창에서 복사하면 된다.
5. 마운트 지점을 설정한다 — /mnt/sharepoint 같은 경로, 또는 쓰기 권한이 있는 빈 디렉터리라면 무엇이든 가능하다.
6. Click Connect. NetDrive가 인증을 수행하고 해당 경로에 라이브러리를 마운트한다.

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

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

# Confirm the mount is listed
mount | grep sharepoint

# Or just try listing it
ls /mnt/sharepoint

첫 시도에서 디렉터리 목록이 비어 있다면, 마운트가 실패했다고 바로 단정하지 말고 잠시 기다려 본다 — 라이브러리가 큰 SharePoint 사이트는 비동기 목록 조회가 켜져 있어도 루트를 채우는 데 몇 초 걸릴 수 있다. 그 후에도 계속 비어 있다면 먼저 OAuth 단계를 다시 확인한다 — 헤드리스 박스에서 SharePoint 연결이 끝까지 완료되지 못하는 가장 흔한 원인은 브라우저 흐름이 중간에 끊기는 것이다.

리눅스 빌드에서 염두에 둘 점

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

마무리

우분투에서 SharePoint를 마운트하면, apt 대신 GitHub에 있는 설치 프로그램을 통해서이긴 하지만 NetDrive가 윈도우와 macOS에서 제공하는 것과 같은 드라이브 방식의 접근을 리눅스 박스에서도 그대로 얻을 수 있다. 더 많이 테스트된 플랫폼에서의 같은 공급자에 대해서는 Mount SharePoint on Windows with NetDrive 또는 Mount SharePoint on macOS with NetDrive를 참고한다. 리눅스 전반에 대한 더 넓은 그림은 NetDrive on Ubuntu Linux에서 확인할 수 있다.

— Steve, NetDrive