WindowsにMinIOをマウント — NetDrive S3互換セットアップガイド
NetDriveでMinIOバケットをWindowsドライブとしてマウントする手順を解説。プライベートなS3互換オブジェクトストレージをWindowsエクスプローラーから直接ブラウズできます。
チームのビルド成果物のためにMinIOクラスタを構築した——テストフィクスチャ、Dockerのレイヤーキャッシュ、夜間エクスポートなど2テラバイト分が、自分たちで管理するハードウェア上にある。今度はWindowsの開発者全員が、MinIO独自のクライアントをインストールしたりスクリプトでラップしたりせずに、見慣れたドライブレターを開いてExplorerで直接ファイルをドラッグできるようにしたい。NetDriveならこれをきれいに解決できる。MinIOのS3互換APIに接続し、数秒でバケットをネイティブなドライブとして表示する。
MinIOをWindowsドライブとしてマウント
NetDrive を使えば Google Drive、OneDrive、S3、SFTP、WebDAV などが Windows と macOS でネイティブドライブとして表示されます — 同期も、まるごとダウンロードも不要です。
- S3互換接続 — あらゆるMinIOエンドポイントに対応
- Windowsエクスプローラーから直接バケットとオブジェクトをブラウズ
- リアルタイム進捗表示付きのバックグラウンドアップロード
無料トライアル。永久ライセンスとサブスクリプションプランあり。
始める前に必要なもの
NetDriveを開く前に、以下を用意しておく。
- MinIOエンドポイントURL — ローカルやLAN内のインスタンスなら通常
http://your-server:9000、リバースプロキシ配下のサーバーならhttps://minio.yourdomain.com。MinIOのデフォルトAPIポートは9000で、コンソールは9001で動作するがNetDriveが接続するのはそちらではない。 - アクセスキーとシークレットキー — MinIOコンソールのIdentity → Service Accountsでサービスアカウントを作成するか、
mc admin user svcacct addで生成する。ルート認証情報ではなくサービスアカウントを使い、最小権限のために対象バケットに限定してスコープを設定すること。 - バケット名 — NetDriveはバケット単位で接続する。複数のバケットを公開したい場合は、NetDrive側でバケットごとに別のドライブを追加する。
- Windows 8、8.1、10、または11にNetDriveをインストール済みであること。インストーラーはこちらからダウンロード。
MinIOの最新リリースはデフォルトでパススタイルアドレッシングを使用しており、これはNetDriveがS3互換プロバイダーで使用するモードと同じである。使用しているMinIOのバージョンがRELEASE.2022-10-08より前の場合は、パススタイルアクセスがMinIOの設定で明示的に無効化されていないか（MINIO_API_REQUESTS_MAX およびバーチャルホスト設定）確認すること。
WindowsでNetDriveをMinIOに接続する
NetDriveを開き、Drive Managerの**+ボタンをクリックして新しいドライブを追加する。プロバイダー一覧からAmazon S3**を選択する——MinIOはS3 APIを話すため、MinIOやWasabiをはじめとする自己ホスト型のS3互換ストレージすべてに対して、この項目が正しい選択となる。
接続項目に入力する。
- Access Key ID: MinIOのアクセスキー
- Secret Access Key: MinIOのシークレットキー
- Region:
us-east-1と入力する——MinIOはこの値を無視するが、フィールドは空にできない - Endpoint: MinIOのAPI URL。例:
http://192.168.1.50:9000やhttps://minio.example.com - Bucket: マウントする具体的なバケット。例:
build-artifacts
Path style（NetDriveのバージョンによってはForce path styleと表記される場合もある）を有効にする。bucket.minio.example.com のようなバーチャルホストスタイルのURLは、通常セルフホストのMinIOには存在しないDNSエントリを必要とする。パススタイル——バケットが minio.example.com/bucket のようにパスの一部として表示される方式——がここでは求められる。
Testをクリックして接続を確認する。緑のチェックマークが表示されれば、NetDriveがMinIOに到達し認証できていることが確認できる。テストが失敗する場合、よくある原因はポート9000をブロックするファイアウォール、自己署名証明書を使うHTTPSエンドポイント、あるいはアクセスキーが対象バケットへの s3:ListBucket 権限を持っていないことである。
ドライブレターの割り当てと自動マウント
接続テストに成功したら、Mountセクションまでスクロールする。
- Drive letter — 未使用のレターを選ぶ。共有ワークステーションでは、
M:（MinIOのM）のようなチーム内の命名規則を決めておくと、マシン間で一貫性が保てる。 - Mount type — 完全な読み書きアクセスならNetwork drive、このバケットがワークステーションから変更してはいけない参照用データセットを保持しているならRead-only driveを選ぶ。
- Auto-mount オプション:
- On login — Windowsにログインした後にドライブが表示される。開発用ワークステーションに向いている。
- On boot — ログイン前にドライブがマウントされる。システムアカウントで動作しスタートアップ時にMinIOから読み込む必要があるスケジュールタスクやサービスに有用。
- Disabled — Drive Managerから手動でマウントする。アクセス頻度の低いバケットに便利。
Mount（再生）ボタンをクリックする。数秒以内に、Windowsエクスプローラーに新しいドライブレターが表示される。そこに移動すると、MinIOバケットのトップレベルのフォルダとオブジェクトがローカルのファイルであるかのように表示される。
Windowsエクスプローラーでのファイル操作
ドラッグ&ドロップによるアップロードは期待通りに動作する。NetDriveは転送をバックグラウンドでキューに入れ、システムトレイのアイコンから進捗を表示する。5GBを超えるオブジェクトについては、NetDriveが自動的にS3マルチパートアップロードに切り替える——大きなアーティファクトのバンドルやデータセットファイルでも設定は不要である。
CIパイプラインが新しいテストフィクスチャをプッシュするなど、閲覧中に別のプロセスがバケットに書き込みを行うと、ドライブの一覧がすぐには更新されないことがある。マウントされたドライブをエクスプローラーで右クリックし、NetDriveのコンテキストメニューからForce folder refreshを選ぶと、最新のディレクトリ一覧を取得できる。
スクリプトやCIランナーからのアクセス向けに、nd3cmd CLIツール（NetDrive 3.8.921以降で利用可能）を使うと、コマンドラインからドライブのマウント・アンマウントができる。GUIではなくビルドスクリプトから接続を自動化したい場合に便利である。
まとめ
認証情報さえ手元にあれば、WindowsでMinIOをNetDriveに接続するのは3〜5分で完了する。同じS3互換接続方式は、Wasabi、Backblaze B2など他のセルフホスト型・マネージド型のS3互換ストレージにも通用するため、このセットアップパターンはストレージ環境全体に広げて使える。macOS版の手順についてはMount MinIO on macOS with NetDriveを参照。正規のAWS S3については、Mount Amazon S3 on Windows with NetDriveでリージョン選択とIAM認証情報の設定を扱っている。
— Steve, NetDrive