# gcloud CLIでCloud Storageにファイルをアップロードする方法

## 1-1 目次

1. はじめに

2. Google Cloud SDKのインストール

   1. Windowsへのインストール

   2. macOSへのインストール

   3. Linuxへのインストール

3. gcloud CLIの初期設定

   1. 認証

   2. プロジェクトの設定

4. Cloud Storageバケットの作成

5. ファイルのアップロード方法

   1. 単一ファイルのアップロード

   2. ディレクトリのアップロード

   3. gsutilコマンドの使用

6. アップロードの確認

7. アップロードの自動化

8. トラブルシューティング

9. まとめ

## 1-2 はじめに

Google Cloud Storageはオブジェクトストレージサービスで、スケーラブルで信頼性の高いデータ保存を提供します。`gcloud` CLIを使用することで、Google Cloud環境に簡単かつ効率的にデータをアップロードすることが可能です。本記事では、具体的な手順を通じて、gcloud CLIを使ってCloud Storageにファイルをアップロードする方法を詳しく解説します。

## 2-1 Google Cloud SDKのインストール

gcloud CLIはGoogle Cloud SDKの一部として提供されています。以下の手順に従って、各オペレーティングシステムにSDKをインストールします。

### 2-1-1 Windowsへのインストール

1. [Google Cloud SDKのダウンロードページ](https://cloud.google.com/sdk/docs/install)にアクセスします。

2. Windows用のインストーラーをダウンロードします。

3. インストーラーを実行し、指示に従ってインストールを完了します。

   - Pythonが必要な場合は、一緒にインストールできます。

4. 新しいコマンドプロンプトを開き、以下のコマンドを実行してセットアップを完了します。

   ```shell

   gcloud init

   ```

### 2-1-2 macOSへのインストール

1. ターミナルを開き、以下のコマンドを実行してHomebrewを使用してインストールします。

   ```shell

   brew install --cask google-cloud-sdk

   ```

2. 環境変数PATHを更新してgcloudコマンドを使用可能にします。

### 2-1-3 Linuxへのインストール

1. ターミナルを開き、以下のコマンドを実行してSDKをダウンロードします。

   ```shell

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-XXX-linux-x86_64.tar.gz

   ```

   ※XXXは最新のバージョン番号です。サイトで確認します。

2. 次に、ダウンロードしたアーカイブを解凍します。

   ```shell

   tar -xvf google-cloud-sdk-XXX-linux-x86_64.tar.gz

   ```

3. SDKディレクトリに移動し、インストールスクリプトを実行します。

   ```shell

   ./google-cloud-sdk/install.sh

   ```

## 3-1 gcloud CLIの初期設定

インストール後、`gcloud` CLIを使用する前に初期設定が必要です。

### 3-1-1 認証

Googleアカウントでgcloudに認証します。以下のコマンドを実行し、ブラウザに表示されたコードを使用して認証します。

```shell

gcloud auth login

```

### 3-1-2 プロジェクトの設定

アップロード先のプロジェクトを設定します。

```shell

gcloud config set project [PROJECT_ID]

```

## 4-1 Cloud Storageバケットの作成

ファイルをアップロードするバケットを作成します。

```shell

gsutil mb -l [LOCATION] gs://[BUCKET_NAME]

```

- `[LOCATION]`には`us-central1`などのリージョンを指定します。

- `[BUCKET_NAME]`は一意のバケット名です。

## 5-1 ファイルのアップロード方法

### 5-1-1 単一ファイルのアップロード

以下のコマンドを使用して、単一ファイルをCloud Storageにアップロードします。

```shell

gsutil cp [LOCAL_FILE_PATH] gs://[BUCKET_NAME]/

```

- `[LOCAL_FILE_PATH]`はアップロードするファイルのパスです。

### 5-1-2 ディレクトリのアップロード

ディレクトリ内の全てのファイルをアップロードするには、以下のコマンドを使います。

```shell

gsutil cp -r [LOCAL_DIRECTORY_PATH] gs://[BUCKET_NAME]/

```

- `-r`オプションは再帰的にディレクトリ内の全てのファイルを対象とします。

### 5-1-3 gsutilコマンドの使用

gcloud CLIの代わりに`gsutil`を使用することも可能です。こちらもGoogle Cloud SDKに含まれています。

## 6-1 アップロードの確認

アップロードが成功したかを確認するには、次のコマンドを使用してバケット内のファイルをリストします。

```shell

gsutil ls gs://[BUCKET_NAME]/

```

## 7-1 アップロードの自動化

スクリプトを作成してアップロードのプロセスを自動化することが可能です。以下は簡単なBashスクリプトの例です。

```bash

#!/bin/bash

gcloud auth activate-service-account --key-file=[KEY_FILE]

gcloud config set project [PROJECT_ID]

gsutil cp -r [LOCAL_DIRECTORY_PATH] gs://[BUCKET_NAME]/

```

## 8-1 トラブルシューティング

- **認証エラー**: 認証が失敗した場合は、`gcloud auth login`を再実行してください。

- **権限エラー**: バケットに対する権限がない場合は、IAMポリシーを確認し、必要に応じて適切な権限を付与してください。

## 9-1 まとめ

gcloud CLIを使用して、ファイルをGoogle Cloud Storageに簡単にアップロードすることができました。gcloudは強力で柔軟なツールであり、様々なタスクを効率的に処理するための多くのオプションを提供しています。特に、大規模かつ頻繁なデータのアップロードを行う場合、スクリプトや自動化ツールと組み合わせることで大幅に作業効率を向上させることが可能です。

gcloud CLIでCloud Storageにファイルをアップロードする方法

1-1 目次

続きを読むには単価診断を受けてください（30秒）