UNIX/Linuxの部屋 gsutilコマンドの使い方

TOP >> UNIX/Linux の部屋 >> 検索

TOP UNIX/Linuxの部屋 UNIX/Linuxコマンド一覧 用語集 新版 由来/読み方辞書 環境変数マニュアル Cシェル変数 システム設定ファイル システムコール・ライブラリ ネットワークプログラミングの基礎知識 クラウドサービス徹底比較・徹底解説




コマンド gsutil Google Cloud Storage (GCS) の管理用コマンド。オブジェクトのコピー・削除・同期等。 このエントリーをはてなブックマークに追加

目次:
  1. gsutil help … gsutil コマンドのヘルプを表示する
  2. gsutil ls … GCS のファイル一覧を表示する
  3. gsutil cp … GCS に/GCSへ/GCSからGCSへ、ファイルをコピー
  4. gsutil du … GCS のオブジェクトサイズを表示する
  5. gsutil rm … GCS のバケットまたはオブジェクトを削除する
  6. gsutil mb … GCS にバケットを作成する
  7. gsutil rb … GCS のバケットを削除する
  8. gsutil rsync
  9. gsutil acl 【2019-07-11 権限削除を追記】
  10. gsutil defacl 【2019-07-11 権限削除を追記】
  11. gsutil iam
  12. 関連コマンド

gsutil コマンドは、Google Cloud Platform (GCP) のサービスのひとつである Google Cloud Storage (GCS) について表示・管理・更新を行うコマンドラインツールで、Google が作成している Cloud SDK の中の一部である。Google が提供する GCE や Cloud Shell には gsutil コマンドがデフォルトでインストールされているが、Windows・Linux・mac 用の Cloud SDK が配布されているので、それをインストールすることで GCP 以外の環境でも gsutil コマンドを使うことができる。

gsutil は GCS 専用のコマンドであり、汎用コマンドとして gcloud コマンド、BigQuery は bq コマンド、
GKE (≒Kubernetes) は kubectl コマンドをそれぞれ使用する。
>> コマンド gcloud
>> コマンド bq

●gsutil help … gsutil コマンドのヘルプを表示する
 gsutil help で、gsutil のヘルプを表示できる。
% gsutil help
gsutil help [コマンド] で、そのコマンドのヘルプを表示できる。
% gsutil help ls
gsutil help [コマンド] [サブコマンド] で、さらに絞り込むこともできる。
% gsutil help acl ch
なお、最後に --help オプションを付けても同じことになるので、途中までタイプしたあとにヘルプを見たい場合は下記の方が使い勝手がよいかもしれない。
% gsutil ls --help
% gsutil acl ch --help

gsutil help 自体のヘルプは下記のようにする。
% gsutil help help
gsutil のコマンドではないが、"acls"・"options" などのトピックがあり、gsutil help [トピック名] で説明を表示することができる。
% gsutil help acls
→ ACL についてのヘルプを出力
% gsutil help options
→ オプションについてのヘルプを出力
トピックは以下のとおり (2018/10 確認)。"gsutil help" で最新のトピック名を確認できる。
  • acls ACL (アクセスコントロールリスト≒権限) について
  • anon パブリックデータへのアクセスについて
  • apis Cloud Storage の API について
  • crc32c CRC32 チェックサムと、コマンドのインストールについて
  • creds クレデンシャルについて
  • dev gsutil の開発に貢献する方法
  • encoding ファイル名のエンコーディングについて
  • encryption 暗号化について
  • metadata オブジェクトのメタデータについて
  • naming オブジェクトとバケットの命名について
  • options gsutil コマンドの共通オプション (トップレベルオプション) について
  • prod 大量データを扱う際の注意点
  • projects GCP のプロジェクトについて
  • retries リトライ戦略について
  • security セキュリティとプライバシーについて
  • subdirs サブディレクトリについて
  • support Google Cloud Storage のサポートについて
  • throttling gsutil コマンドのスロットリング (帯域制御) について
  • versions オブジェクトのバージョニングについて
  • wildcards ワイルドカードについて

●gsutil ls … GCS のファイル一覧を表示する
 ●gsutil cp … GCS に/GCSへ/GCSからGCSへ、ファイルをコピー
 ●gsutil du … GCS のオブジェクトサイズを表示する
 ●gsutil rm … GCS のバケットまたはオブジェクトを削除する
 ●gsutil mb … GCS にバケットを作成する
 ●gsutil rb … GCS のバケットを削除する

●gsutil rsync
 ▷ gsutil rsync -d オプション
dst にはあるが src にはないオブジェクトについて、src から削除する。
▷ gsutil rsync -r オプション
src 以下のサブディレクトリも含め、再帰的に同期させる。-R でも同じ。

●gsutil acl 【2019-07-11 権限削除を追記】
 ▷ gsutil acl ch … 権限設定
% gsutil acl ch -u myservice-account@myproject.iam.gserviceaccount.com:W gs://mybucket
→ 末尾は :W で WRITE、:R で READ、:O でオーナー権限
▷ gsutil acl ch -d … 権限削除
% gsutil acl ch -d myservice-account@myproject.iam.gserviceaccount.com gs://mybucket
→ 削除の場合は末尾に :W :R :O をつけないこと

●gsutil defacl 【2019-07-11 権限削除を追記】
 ▷ gsutil defacl ch … 権限設定
% gsutil defacl ch -u myservice-account@myproject.iam.gserviceaccount.com:O gs://mybucket
→ 末尾は :W で WRITE、:R で READ、:O でオーナー権限
▷ gsutil defacl ch -d … 権限削除
% gsutil defacl ch -d myservice-account@myproject.iam.gserviceaccount.com gs://mybucket
→ 削除の場合は末尾に :W :R :O をつけないこと

●gsutil iam
 ▷ gsutil iam ch … 権限設定
% gsutil iam ch serviceAccount:myservice-account@myproject.iam.gserviceaccount.com:objectAdmin gs://mybucket

●関連コマンド
>> コマンド gcloud
>> コマンド bq



頑張って書いたおすすめコンテンツ！