このページは Cloud Translation API によって翻訳されました。

ワークステーションのクローンを作成する

新しいワークステーションの作成時に、既存のワークステーションのコンテンツを簡単にクローンを作成できます。これは、ソースワークステーションのリージョンで不安定な状態が発生している場合に役立ちます。

始める前に

ワークステーションのクローンを作成する前に、ソースワークステーションに対する適切な権限があることを確認します。

ソースワークステーションに対する workstations.workstations.use 権限が必要です。
新しいワークステーションを作成するプロジェクトの ワークステーションサービスエージェントには、ソースワークステーションを含むプロジェクトに対する compute.disks.createSnapshot と compute.snapshots.useReadOnly の権限が必要です。

ワークステーションのクローンを作成する

ワークステーションのクローンを作成するには、新しいワークステーションを作成し、コピーするソースワークステーションを指定します。

    gcloud workstations create WORKSTATION \
      --project=PROJECT \
      --region=REGION \
      --cluster=CLUSTER_NAME \
      --config=CONFIG_NAME \
      --source-workstation=SOURCE_WORKSTATION

次のように置き換えます。

WORKSTATION: 新しいワークステーションの ID または完全修飾識別子
PROJECT: 新しいワークステーションを含むプロジェクト
REGION: 新しいワークステーションが配置されるリージョン（例: us-central1）
CLUSTER_NAME: 新しいワークステーションを含むワークステーションクラスタの名前
CONFIG_NAME: 新しいワークステーションを含むワークステーション構成の名前
SOURCE_WORKSTATION: 新しいワークステーションの永続ディレクトリのクローンを作成する送信元ワークステーションの完全修飾識別子

移行元ワークステーションの ID は次のようになります。
```
projects/SOURCE_PROJECT/locations/SOURCE_REGION/workstationClusters/SOURCE_CLUSTER/workstationConfigs/SOURCE_CONFIG/workstations/SOURCE_WORKSTATION
```
次のように置き換えます。
- SOURCE_PROJECT: ソースワークステーションを含むプロジェクト
- SOURCE_REGION: ソースワークステーションが配置されているロケーション
- SOURCE_CLUSTER: ソースワークステーションを含むワークステーションクラスタの名前
- SOURCE_CONFIG: ソースワークステーションを含むワークステーション構成の名前
- SOURCE_WORKSTATION: ソースワークステーションの ID

詳細については、gcloud workstations create をご覧ください。

API リファレンス情報については、REST と RPC をご覧ください。

ディスク容量の大きい新しいワークステーションにコンテンツをコピーする方法

クローンを作成して既存のワークステーションのディスクサイズを拡張することはできませんが、ディスクが大きいワークステーションにコンテンツをコピーすることはできます。

より大きな永続ディスクを指定する構成を使用して、新しい宛先ワークステーションを作成します。
移行元ワークステーションと移行先ワークステーションの両方を起動します。
宛先ワークステーションのターミナルにアクセスします。Google Cloud コンソールでターミナルを起動するか、SSH を使用してターミナルに接続します。
宛先ワークステーションのターミナルから、gcloud workstations start-tcp-tunnel を使用して送信元ワークステーションへの TCP トンネルを作成します。
```
gcloud workstations start-tcp-tunnel \
  --project=SOURCE_PROJECT \
  --region=SOURCE_REGION \
  --cluster=SOURCE_CLUSTER \
  --config=SOURCE_CONFIG \
  SOURCE_WORKSTATION \
  WORKSTATION_PORT \
  --local-host-port=:LOCAL_PORT
```
次のように置き換えます。
- WORKSTATION_PORT: トラフィックを送信する送信元ワークステーションのポート（デフォルト: 22）。
- LOCAL_PORT（省略可）: トラフィックの送信元となるローカルホストポート。有効なポート番号は 1024～65535 です。--local-host-port フラグを省略するか、0 のポートを指定する場合は、未使用のポートが自動的に選択されます。
トンネルの準備が整うと、ポート番号が表示されます。
```
Listening on port [LOCAL_PORT].
```
宛先ワークステーションの別のターミナルで scp を実行し、TCP トンネルがリッスンしているポートを指定して、ソースワークステーションからファイルをコピーします。
```
scp -rP LOCAL_PORT \
    user@localhost:~/SOURCE_DIRECTORY \
    ~/DESTINATION_DIRECTORY
```
次のように置き換えます。
- SOURCE_DIRECTORY: ソースワークステーションからコピーするディレクトリのパス
- DESTINATION_DIRECTORY: 新しいワークステーション上の宛先ディレクトリのパス