# gt: General Translation CLI tool: アップロード
URL: https://generaltranslation.com/ja/docs/cli/upload.mdx
---
title: アップロード
description: ソースファイルと翻訳を General Translation プラットフォームへアップロードする方法
---

## 使用方法

```bash
npx gt upload
```

<Callout type="info">
  **注:** このコマンドには本番環境用のAPIキーが必要です。APIキーは
  [プラットフォーム](https://generaltranslation.com/dashboard)で取得してください。
</Callout>

## 概要

`gt upload` コマンドは、プロジェクトのソースファイルと既存の翻訳を General Translation プラットフォームにアップロードします。これにより、ローカルファイルがプラットフォームと同期され、ファイルの管理、翻訳キューへの追加、進捗の追跡が可能になります。

分割された CI/CD パイプラインでの一般的なワークフローは次のとおりです。

1. **`gt upload`** — ソースファイルを General Translation プラットフォームにアップロードする
2. [`gt enqueue`](/docs/cli/enqueue) — アップロードしたファイルを翻訳キューに追加する
3. [`gt download`](/docs/cli/download) — 完了した翻訳をダウンロードする

<Callout type="warn">
  **本番環境でのみ使用してください！**

  このコマンドは本番ビルド用であり、**開発環境では使用しないでください**。
  環境変数には、本番用の API キー (`GT_API_KEY`) とプロジェクト ID (`GT_PROJECT_ID`) を必ず指定してください。
</Callout>

## 動作の仕組み

1. `gt.config.json` を読み込み、アップロードするファイルを判定します
2. 翻訳対象のソースファイル (JSON、YAML、Markdown、MDX など) をすべて収集します
3. 各ファイルをハッシュ化し、`fileId` (パスに基づく) と `versionId` (内容に基づく) を生成します
4. General Translation API に問い合わせて、新規または変更されたファイルを判定します
5. ファイルの移動 (内容は同じでパスが異なる場合) を検出し、既存の翻訳を維持します
6. 新規または変更されたソースファイルをプラットフォームにアップロードします
7. 既存の翻訳ファイルがローカルで見つかった場合は、それらもアップロードします

## フラグ

`upload` コマンドは、[`translate`](/docs/cli/translate#flags) と同じフラグを受け付けます。

| Parameter                    | Description                          | Type       | Optional | Default            |
| ---------------------------- | ------------------------------------ | ---------- | -------- | ------------------ |
| `--api-key`                  | 本番環境用の API キーを指定します                  | `string`   | `true`   |                    |
| `--project-id`               | プロジェクト ID を指定します                     | `string`   | `true`   |                    |
| `--version-id`               | バージョン ID を指定します (デフォルトではコンテンツのハッシュ)  | `string`   | `true`   |                    |
| `--config <path>`            | GT 設定ファイルへのパスを指定します                  | `string`   | `true`   | `"gt.config.json"` |
| `--new, --locales <locales>` | プロジェクトの翻訳先ロケールを指定します                 | `[string]` | `true`   |                    |
| `--default-locale <locale>`  | プロジェクトのソースロケールを指定します                 | `string`   | `true`   | `en`               |
| `--dry-run`                  | コマンドをドライランで実行します                     | `flag`     | `true`   | `false`            |
| `--timeout`                  | リクエストのタイムアウト時間 (秒) を指定します            | `number`   | `true`   | `600`              |

## 例: CIパイプラインを分割する

```bash
# ステージ 1: ソースファイルをアップロード
npx gt upload

# ステージ 2: 翻訳をキューに追加
npx gt enqueue

# ステージ 3: 準備完了後にダウンロード
npx gt download
```