Git SSH との連携

Monacaでは、Git サービスを使ってリポジトリとプロジェクトを SSH 認証で接続することができます。GitHub は、SSH 接続をサポートする Git サービスの 1 つです。 次の項目では、GitHub を例として使用します。

事前準備

Monaca クラウド IDE のバージョン管理機能を使用する場合、次のアカウントが必要となります。

• SSH をサポートしている Git サービスのアカウント

セットアップ

ステップ 1: SSH キーの生成

1. SSHキー管理 画面を表示します。

2. SSHキー 再生成ボタンをクリックします。

3. 次の項目 ( Git サービスに SSH キーを追加する ) で使用するために生成されたキーをコピーします。

ステップ 2: Git サービスに SSH キーを追加する

Monaca と Git サービスプロバイダ間の正しい認証のために、前の項目で生成された SSH キーを Git サービスアカウントに追加する必要があります。

例では、GitHub を使用しています。 他のサービスについては、Git サービスのドキュメントを参照してください。

1. SSH Key 画面を表示します。

2. New SSH keyボタンをクリックします。

3. 以下の情報を入力します。

   • Title: キーのタイトル

   • Key: Monacaアカウントから生成された SSH キー（「1. SSH キーの生成」で作成した SSH キー）

4. Add SSH keyボタンをクリックします。

Monaca プロジェクトを新しい Git リポジトリに接続する

ステップ 1: 新しい空のリポジトリを作成する

任意の Git サービスで、新しいリポジトリを作成できます。この項目では、次のようにGitHubに新しいリポジトリを作成します。

1. GitHub アカウントに移動し、新しい空のリポジトリを作成します（Readme

   ファイルなし）。

2. SSHボタンを選択します。

3. SSH リンクをコピーします（下記のスクリーンショットを参照）。 次の項目の後半に Monaca クラウド IDE でこのリンクを使用します。

ステップ 2: リポジトリと Monaca プロジェクトの接続

1. Monaca Dashboard から、リポジトリに接続するプロジェクトを開きます。

2. Monaca クラウド IDE のメニューから、**プロジェクト → バージョン管理設定**を選択します。

3. Git SSH オプションを以下のように選択してください。

4. 次に、 Repository URL (上記のリンク) と Committer Name を入力する必要があります。

5. 設定するボタンをクリックします。

6. プロジェクトは新しいリポジトリにアップロードされます。 デフォルトでは、作業ブランチは master として設定されます。 別の作業ブランチに切り替える場合は、**プロジェクト → バージョン管理設定**へ移動します。

プロジェクトを Git リポジトリから Monaca にインポートする

1. Monaca アカウントを使用して、Monaca クラウドIDE にログインします。

2. ダッシュボード上で、インポートを選択します。

3.「Gitのリポジトリ」を選択し、リポジトリURL 等の必要な情報を入力し、プロジェクトのインポートボタンをクリックします。

4. インポートの完了後、Monaca ダッシュボード上で対象のプロジェクトが表示されていることを確認します。デフォルトでは、master ブランチのコンテンツがインポート対象となります。ブランチは、**プロジェクト → バージョン管理設定**で切り替えることができます。

リモートリポジトリを使用した作業

リポジトリとプロジェクト間の接続完了後は、チームメンバーと同じプロジェクトで作業を開始し、Monaca クラウド IDE から最新のアップデートと同期させることができます。

Monaca クラウド IDE では、ユーザーフレンドリーなバージョン管理用のインターフェイスを提供しています。このインターフェイスを使用すれば、Git のコマンドの詳細を意識せずに、基本的な操作を一通り行うことができます。

ブランチの切り替え ( Git コマンドの checkout )

複数のブランチを使用したプロジェクトで、ブランチの切り替えを行う場合は、次の手順に従います。

1. Monaca クラウド IDE のメニューから、**プロジェクト → バージョン管理設定**を選択します。

2. 現在の作業ブランチから切り替えたいブランチを選択し、 アップデートボタンをクリックします。

リモートリポジトリから最新の内容を取得

Git コマンドでは、リモートリポジトリから最新の情報を取得/ダウンロードする場合、git pull ( git プル ) コマンドを使用します。Monaca クラウド IDE では、リモートリポジトリから最新の情報を取得する場合、Monaca クラウド IDE のメニューから、プロジェクト → プル を選択します。リモートリポジトリ側の内容が更新されている場合、その内容がダウンロードされ、対応するブランチ側に反映されます。

変更箇所のコミットとリモートリポジトリへの反映

現在作業をしているブランチで行った変更を、リモートリポジトリ側に反映させます。最初に、次の手順に従い、コミットを行い、リモートリポジトリ側へプッシュします ( コミット前に、ファイルを保存する必要があります )。

1. Monaca クラウド IDE のメニューから、**プロジェクト → コミット**を選択します。

2. コミットメッセージを入力して、コミット対象のファイルにチェックを入れます。次に、 コミットボタンをクリックします。

3. ここまでの手順で、リモートリポジトリに更新を反映させる準備ができました。次に、 **プロジェクト → プッシュ**を選択します。コミット後、リモートリポジトリ側が更新されているか確認します。

リモートリポジトリ側のコミット履歴の表示 ( GitHub 側の履歴ページ )

リモートリポジトリ側 ( GitHub 側 ) のコミット履歴を確認する場合、**プロジェクト → リモートのコミット履歴**を選択します。現在作業しているブランチのコミット履歴が表示された、GitHub 側のサイト ( 外部ページ ) にリダイレクトされます。

ローカルコミットの履歴表示 ( Monaca クラウド IDE 側の履歴ページ )

ローカルコミットとは、Monaca クラウド IDE 上で行ったコミットを指します。**プロジェクト → コミット履歴**を選択すれば、ローカルコミットの履歴を表示できます。各コミットの内容を確認する場合には、コミットメッセージ横の ID をクリックします。