AWS CodeCommit
ユーザーガイド (API バージョン 2015-04-13)

AWS CodeCommit の開始方法のチュートリアル

CodeCommit を初めて使用するお客様向けに、このチュートリアルでは、その機能の使用方法について説明します。このチュートリアルでは、CodeCommit でリポジトリを作成します。CodeCommit リポジトリへの変更をコミットしたら、ファイルを参照して変更を表示します。他のユーザーのプルリクエストを作成して、自分のコードの変更を確認したり、コメントを追加したりすることもできます。

CodeCommit コンソールの折りたたみ可能なパネルを使用して、有益な情報を表示することができます。これは、情報アイコン、またはそのページの [情報] リンクから開くことができます ( )。このパネルは、いつでも閉じることができます。


            詳細なガイダンスをコンソールで表示する

また、CodeCommit コンソールでは、リポジトリ、ビルドプロジェクト、デプロイアプリケーション、パイプラインなどのリソースをすばやく検索することもできます。[Go to resource (リソースに移動)] または / キーを押して、リソースの名前を入力します。一致するものはすべてリストに表示されます。検索では大文字と小文字が区別されません。リソースを表示する権限がある場合のみ表示されます。詳細については、「コンソールでリソースを表示する」を参照してください。

Git に精通していない場合は、このチュートリアルに加えて、「CodeCommit での Git の使用に関するチュートリアル」の完了も必要になることがあります。このチュートリアルを終了後、自身のプロジェクトやチーム環境で CodeCommit を使用するには、十分な練習が必要です。

重要

開始する前に、以下の前提条件と設定を完了する必要があります。

  • IAM ユーザーへのアクセス権限の割り当て

  • このチュートリアルでローカルマシンでの HTTP および SSH 接続に使用する認証情報管理の設定

  • すべてのオペレーション (リポジトリの作成を含む) でコマンドラインまたはターミナルを使用する場合の AWS CLI の設定

ステップ 1: CodeCommit リポジトリを作成する

CodeCommit コンソールを使用して、CodeCommit リポジトリ を作成できます。このチュートリアルで使用するリポジトリがすでにある場合は、このステップをスキップできます。

注記

使用状況によっては、リポジトリの作成またはアクセスに対して課金される場合があります。詳細については、CodeCommit 製品情報ページの「料金表」を参照してください。

CodeCommit リポジトリ を作成するには

  1. https://console.aws.amazon.com/codesuite/codecommit/home にある CodeCommit コンソールを開きます。

  2. AWS リージョンセレクタで、リポジトリを作成するリージョンを選択します。詳細については、「リージョンと Git 接続エンドポイント」を参照してください。

  3. [Repositories (リポジトリ)] ページで、[Create repository (リポジトリの作成)] を選択します。

  4. [リポジトリの作成] ページの [リポジトリ名] に、新しいリポジトリの名前を入力します (例: MyDemoRepo)。

    注記

    リポジトリ名は 100 文字以内 (大文字と小文字は区別する) で入力してください。詳細については、「制限」を参照してください。

  5. (オプション) [Description (説明)] に、説明 (例: My demonstration repository) を入力します。この説明は、お客様と他のユーザーがリポジトリの用途を識別するのに役立ちます。

  6. (オプション) [Add tag] を選択して 1 つ以上のリポジトリタグ (AWS リソースを整理して管理するのに役立つカスタム属性ラベル) をリポジトリに追加します。詳細については、「AWS CodeCommit でのリポジトリのタグ付け」を参照してください。

  7. [作成] を選択します。


              コンソールからのリポジトリの作成

注記

リポジトリに MyDemoRepo 以外の名前を使用する場合は、その名前をこのチュートリアルの残りのステップで必ず使用してください。

リポジトリを開いたら、CodeCommit コンソールから直接ファイルを追加する方法が表示されます。

ステップ 2: リポジトリにファイルを追加する

リポジトリにファイルを追加するには以下の方法で行います。

  • CodeCommit コンソールでファイルを作成する。

  • CodeCommit コンソールを使用して、ローカルコンピューターからファイルをアップロードします。

  • Git クライアントを使用してこのリポジトリをローカルコンピューターにクローンし、CodeCommit リポジトリにファイルの追加、コミット、およびプッシュを行います。

最も手軽に開始する方法は、CodeCommit コンソールからファイルを追加することです。

  1. リポジトリのナビゲーションバーで [コード] を選択します。

  2. [ファイルの追加] を選択し、[ファイルの作成] または [コンピュータからファイルをアップロード] を選択します。

  3. 次の作業を行います。

    • 別のブランチにファイルを追加する場合は、ファイルを追加するブランチをブランチのドロップダウンリストから選択します。デフォルトのブランチが自動的に選択されます。この例では、デフォルトブランチの名前は master です。

    • [Author name (作者名)] に、他のリポジトリユーザーに表示する名前を入力します。

    • [E メールアドレス] に E メールアドレスを入力します。

    • (オプション) [メッセージのコミット] に短いメッセージを入力します。これはオプションですが、このファイルを追加した理由をチームメンバーが把握しやすいように、コミットメッセージを追加することをお勧めします。コミットメッセージを入力しない場合は、デフォルトメッセージが使用されます。

    • ファイルをアップロードしている場合は、アップロードするファイルを選択します。

    • ファイルを作成している場合は、[ファイル名] にこのファイルの名前を入力後、追加するコードをコードエディタに入力します。

    
                        CodeCommit コンソールにおけるファイルのアップロードビュー
  4. [変更のコミット] を選択します。

詳細については、「AWS CodeCommit リポジトリでファイルを操作する」を参照してください。

Git クライアントを使用してリポジトリをクローンするには、Git をローカルコンピューターにインストールし、CodeCommit リポジトリをクローンします。いくつかのファイルをローカルリポジトリに追加し、CodeCommit リポジトリにプッシュします。詳細な説明については、「CodeCommit での Git の使用に関するチュートリアル」を参照してください。Git は使い慣れているが、CodeCommit リポジトリでこれを実行する方法が不明な場合は、「コミットを作成する」、「ステップ 2: ローカルリポジトリを作成する」、または「リポジトリに接続する」で例や説明を確認することができます。

CodeCommit リポジトリにファイルを追加したら、それらのファイルをコンソールで表示できます。

ステップ 3: リポジトリの内容を参照する

CodeCommit コンソールを使用して、リポジトリ内のファイルを確認したり、ファイルの内容をすばやく読み取ったりすることができます。これは、どのブランチをチェックアウトするか、リポジトリのローカルコピーを作成するかどうかを判断するのに役立ちます。

  1. [Repositories (リポジトリ)] から MyDemoRepo を選択します。

  2. リポジトリの内容はリポジトリのデフォルトブランチに表示されます。ビューを別のブランチに変更するか、指定のタグでコードを表示するには、ビューセレクタボタンを選択し、表示するブランチまたはタグをリストから選択します。ここでは、ビューは [master] ブランチに設定されています。

    
                        リポジトリの内容の参照
  3. リポジトリ内のファイルの内容を表示するには、リストからファイルを選択します。表示されているコードのカラーディスプレイオプションを変更するには、歯車アイコンを選択します。

    
                        ファイルの内容を表示する

詳細については、「リポジトリでのファイルの参照」を参照してください。

また、リポジトリのコミット履歴を参照することもできます。これは、リポジトリに加えられた変更がいつ、誰によって行われたかなど、変更を識別するのに役立ちます。

  1. リポジトリのナビゲーションペインで、[コミット] を選択します。デフォルトブランチのリポジトリのコミット履歴は、新しい順に表示されます。

    
                        コンソールでのコミット履歴の表示
  2. コミット履歴をブランチタグ別で確認し、コミットに関する詳細を作成者や日付別などで取得します。

  3. コミットとその親との違いを表示するには、省略形式のコミット ID を選択します。空白の変更の表示/非表示、変更のインライン表示 (統合ビュー)、または並べて表示 (分割ビュー) など、変更の表示方法を選択できます。

    注記

    コードやその他のコンソール設定を表示するための設定は、変更するたびにブラウザの Cookie として保存されます。詳細については、「ユーザー設定の操作」を参照してください。

    
                        [統合] ビューに表示された変更 (空白の変更の表示を有効にした状態)
  4. コミットに関するすべてのコメントを表示するには、そのコミットを選択し、 変更をスクロールしてインラインで表示します。自分のコメントを追加して、他のユーザーによって行われたコメントに返信することもできます。

    詳細については、「コミットについてコメントする」を参照してください。

  5. 2 つのコミット指定子 (タグ、ブランチ、コミット ID など) の違いを表示するには、ナビゲーションペインで [コミット]、[コミットの比較] の順に選択します。

    
                        ブランチの先端へのコミットを分割ビューで比較する

    詳細については、「リポジトリのコミット履歴を参照する」および「コミットの比較」を参照してください。

  6. [コミット] で、[Commit Visualizer] タブを選択します。

    
                        コンソールでのリポジトリのグラフィカルな表示

    コミットグラフが表示され、グラフでは各コミットの件名が該当するコミットポイントの横に示されます。件名の表示は 80 文字に制限されています。

  7. コミットの詳細を確認するには、省略コミット ID を選択します。特定のコミットからグラフをレンダリングするには、グラフ内のポイントを選択します。詳細については、「リポジトリのコミット履歴のグラフを表示する 」を参照してください。

ステップ 4: プルリクエストの作成と協力

他のリポジトリユーザーと作業する場合には、コードで協力し、変更の確認を行うことがあります。自分のコード変更を別のブランチにマージする前に、他のユーザーがブランチのコード変更をレビューしてコメントを付けることができるプルリクエストを作成できます。リポジトリの通知を設定した場合、リポジトリユーザーは、リポジトリイベント (例: プルリクエストの場合、コードにコメントがついた時) に関する通知を E メールで受け取ることができます。詳細については、「AWS CodeCommit リポジトリイベントの通知を設定する」を参照してください。

重要

プルリクエストを作成する前に、レビューするコードの変更が含まれるブランチを作成する必要があります。詳細については、「ブランチを作成する」を参照してください。

  1. ナビゲーションペインで、[プルリクエスト] を選択します。

  2. [プルリクエスト] で、[プルリクエストの作成] を選択します。

    ヒント

    また、プルリクエストは、[Branches] や [Code] から作成することもできます。

    [Create pull request (プルリクエストの作成)] の [ソース] で、レビューする変更が含まれるブランチを選択します。[送信先] で、プルリクエストがクローズされた際に確認済みのコードをマージするブランチを確認します。[Compare] を選択します。

  3. マージの詳細と変更を確認し、プルリクエストにレビューする変更とコミットが含まれていることを確認します。その場合、[タイトル] にこのレビューのタイトルを入力します。これは、リポジトリのプルリクエストのリストに表示されるタイトルです。[Description (説明)] に、このレビューに関する詳細やレビューアにとって有益な情報を入力します。[作成] を選択します。

    
                        プルリクエストの作成
  4. プルリクエストは、リポジトリのプルリクエストのリストに表示されます。開いているリクエスト、閉じたリクエスト、自分が作成したリクエストなどを表示するようにビューをフィルタリングできます。

    
                        リポジトリでプルリクエストを表示する
  5. リポジトリの通知を設定し、プルリクエストイベントをユーザーに通知することを選択した場合、ユーザーは新しいプルリクエストに関する E メールを受信します。ユーザーは、特定の行のコードへの変更とコメント、ファイル、プルリクエスト自体を表示できます。コメントに返答することもできます。必要に応じて、プルリクエストブランチに変更をプッシュでき、これによりプルリクエストが更新されます。

    
                        プルリクエストでアクティビティを表示する
  6. すべてのコード変更が確認され、合意に達したことに満足したら、次のいずれかを実行します。

    • プルリクエストを終了する一部としてブランチをマージするには、[Merge (マージ)] を選択します。送信元と送信先の差異に応じてコードに使用できるマージ戦略を選び、マージが完了した後に送信元のブランチを自動的に削除するかどうかを選択できます。選択が決まったら、[Merge pull request (プルリクエストのマージ)] を選択してマージを完了します。

      
                                CodeCommit コンソールでのマージで利用できるマージ戦略を示すプルリクエスト。
    • ブランチのマージなしでプルリクエストを終了するには、[Close pull request (プルリクエストの終了)] を選択します。

    • 自動的に解決できないマージ競合がブランチにある場合、CodeCommit コンソールで解決を試みるか、ローカルの Git クライアントを使用してブランチをマージし、マージをプッシュできます。詳細については、「AWS CodeCommit リポジトリ内のプルリクエストの競合を解決する」を参照してください。

    注記

    ローカルリポジトリの git merge コマンドを使用して変更をプッシュすることで、いつでも手動でプルリクエストブランチを含めたブランチをマージできます。

詳細については、「プルリクエストの操作」を参照してください。

ステップ 5: 次のステップ

CodeCommit とその機能のいくつかを理解できたところで、以下のことを検討します。

ステップ 6: クリーンアップ

CodeCommit リポジトリを必要としなくなった場合には、CodeCommit リポジトリ およびこのチュートリアルで使用した他のリソースを削除して、ストレージ領域に対して課金され続けないようにすることが必要です。

重要

削除したリポジトリは ローカル repo や共有リポジトリに複製できなくなります。また、ローカル repo または共有リポジトリから、そのリポジトリに対してデータをプルまたはプッシュしたり、Git オペレーションを実行できなくなります。このアクションは元に戻すことができません。

リポジトリの通知を設定した場合、リポジトリを削除するとリポジトリ用に作成された Amazon CloudWatch Events ルールも削除されます。そのルールのターゲットとして使用された Amazon SNS トピックは削除されません。

リポジトリにトリガーを設定した場合、リポジトリを削除しても、それらのトリガーのターゲットとして設定した Amazon SNS トピックまたは Lambda 関数は削除されません。不要なリソースは必ず削除してください。詳細については、「リポジトリからトリガーを削除」を参照してください。

CodeCommit リポジトリ を削除するには

  1. https://console.aws.amazon.com/codesuite/codecommit/home にある CodeCommit コンソールを開きます。

  2. [リポジトリ] で、削除するリポジトリを選択します。このトピックの命名規則に従っていれば、[MyDemoRepo] という名前になります。

  3. ナビゲーションペインで [設定] を選択します。

  4. [設定] ページの [リポジトリの削除] で、[リポジトリの削除] を選択します。

  5. delete」と入力後、[削除] を選択します。リポジトリは完全に削除されます。