2024 年 6 月 17 日以降、新規のお客様は Cloud Source Repositories をご利用いただけなくなります。組織で以前に Cloud Source Repositories を使用したことがない場合、API を有効にしたり、Cloud Source Repositories を使用したりすることはできません。組織に接続されていない新しいプロジェクトでは、Cloud Source Repositories API を有効にできません。2024 年 6 月 17 日より前に Cloud Source Repositories を使用したことのある組織は、この変更の影響を受けません。

ローカル認証の設定

システムからホストされているリポジトリにアクセスまたはホストされているリポジトリを操作するには、ご使用の環境でローカル認証を設定する必要があります。

ローカル認証を設定すると、適切な役割と権限のある、ホストされたリポジトリに対してアクセスできるようになります。標準的な Git オペレーション（git clone、git pull、git push など）を実行することもできます。ローカル認証は、Google Cloud Console で操作（たとえば、リポジトリの内容の閲覧）を行うために必須というわけではありません。

Cloud Source Repositories では、次の種類の認証を使用できます。

SSH
Google Cloud CLI
手動で生成した認証情報

SSH を使用して認証を行う

Cloud Source Repositories を使用すると、SSH 公開鍵認証を使用して、ホストされているリポジトリにアクセスできます。このシナリオでは、まずリポジトリにアクセスするローカルシステムで鍵ペアを生成します。その後、公開鍵を Google Cloud に登録します。システムに SSH 認証鍵ペアがすでにある場合は、それらの鍵を認証に再利用できます。Google アカウントごとに最大 20 個の公開鍵を登録できます。

Cloud Source Repositories では以下の 3 つの SSH 認証鍵タイプがサポートされています。

RSA（2,048 ビットを超える鍵のみ）
ECDSA
ED25519

鍵ペアの生成

SSH 鍵ペアは、ローカルシステムにある秘密鍵と Google Cloud に登録した公開鍵で構成されます。

Linux または macOS

OpenSSH がローカルシステムにインストールされていることを確認します。
コマンドプロンプトで、次のコマンドを入力します。
```
ssh-keygen -t [KEY_TYPE] -C "[USER_EMAIL]"
```
ここで
- [USER_EMAIL] はあなたのメールアドレスです。
- [KEY_TYPE] は次のいずれかです。
  - rsa
  - ecdsa
  - ed25519
次に例を示します。
```
ssh-keygen -t rsa -C "user@example.com"
```
1. プロンプトが表示されたら、公開鍵ファイルのファイル名を入力します。デフォルトの ~/.ssh ロケーションをそのまま使用する場合は、Enter キーを押します。それ以外の場合は、ファイル名を指定します。
2. プロンプトが表示されたら、パスフレーズを空白のままにして Enter キーを押します。
キーを登録する

Windows

PuTTY がローカルシステムにインストールされていることを確認します。
Windows の [スタート] メニューから、PuTTYGen を起動します。
表示されたウィンドウで [パラメータ] フィールドから鍵タイプを選択します。
[生成] をクリックします。

PuTTYGen で生成された公開鍵文字列が表示されます。
鍵ペアを保護するためのパスフレーズを指定します。
生成した鍵ペアをローカルシステムに保存するには、[公開鍵の保存] と [秘密鍵の保存] をクリックします。

既存のキーを使用する

SSH 認証に既存の鍵ペアを使用することもできます。

Linux または macOS

デフォルトでは、公開鍵ファイルは ~/.ssh ディレクトリにあります。

コマンドプロンプトで、次のコマンドを入力します。

ls -a ~/.ssh

デフォルトのファイル名は次のとおりです。

id_rsa.pub
id_ecdsa.pub
id_ed25519.pub

Windows

Windows の [スタート] メニューから、PuTTYGen を起動します。
表示されたウィンドウで [読込] をクリックします。
ローカルファイルシステムで公開鍵ファイルを参照し、ファイルを選択します。

PuTTYGen で公開鍵の文字列が表示されます。鍵ファイルを保存したときにパスフレーズを指定した場合は、公開鍵を表示する前に PuTTYGen によってパスフレーズを入力するように求められます。

公開キーを登録する

Google Cloud コンソールで [SSH 認証鍵の管理] ページを開きます。

Cloud Source Repositories を開く
[SSH 認証鍵の登録] をクリックします。

[SSH 認証鍵の登録] ダイアログが開きます。
[キー名] フィールドに、鍵の一意の名前を入力します。
[キー] フィールドで、公開鍵ファイルからキー文字列をコピーします。
[Register] をクリックします。

SSH 認証を設定すると、必要なロールと権限を持っているリポジトリのクローンを作成するか、空のホストされるリポジトリにローカルリポジトリの内容を push できます。

gcloud CLI を使用して認証を行う

Cloud Source Repositories では、gcloud CLI を使用して認証を行うことができます。このシナリオでは、システム上で gcloud init コマンドを実行してローカル認証を設定します。

ローカルシステムに gcloud CLI がインストールされていることを確認します。
コマンドプロンプトで gcloud init を実行します。
```
gcloud init
```
画面上の指示に沿って操作します。

gcloud CLI 認証を設定すると、標準の Git コマンドを使用して Cloud Source Repositories 上のホストされているリポジトリを操作できます。

手動で生成された認証情報を使用して認証を行う

手動で生成された認証情報を認証に使用することもできます。Cloud Source Repositories には、ホストされるリポジトリへのアクセスに必要な認証情報を手動で生成するために使用できる一連のスクリプトが用意されています。

[Configure Git] ページに移動して認証情報を生成します。

[Configure Git] ページに移動する
ターミナルウィンドウを開きます。
以下のコマンドを入力します。
```
git clone https://source.developers.google.com/p/PROJECT_ID/r/REPOSITORY_NAME
```
ここで
- PROJECT_ID はプロジェクトの名前です
- REPOSITORY_NAME はリポジトリの名前です

手動で生成された認証情報を使用して認証を設定したら、標準の Git コマンドを使用して Cloud Source Repositories 上のホストされているリポジトリを操作できます。