AWSのCodeCommitでGitを利用してみたいと感じ、試してみました。
誰かの参考になれば幸いです。
はじめに
今回は、AWS CodeCommitの動作を確認する為にGitを導入しました。
■ AWS CodeCommitを利用する場合にやること
AWS CodeCommitでリポジトリを作成してください。
AWSのIAMでユーザーを作成し、AWS CodeCommit の HTTPS Git 認証情報を取得しておいてください。
■実行環境
今回は、以下の環境で実行しました。
- Windows7 64bit
- Git 2.24.1.2
- TortoiseGit 2.9.0
Gitをパソコンにインストールする
Gitのインストール
■Information
こちらのページのダウンロードリンクをクリックし、最新のGitをダウンロードします。
ダウンロード完了後、実行ファイルを起動すると、インストーラーが起動します。
■Select Destination Location
インストールしたい場所を指定し、Nextをクリックします。
■Select Components
コンポーネントの選択を行い、Nextをクリックします。
今回は、デフォルトのままNextをクリックで問題ありません。
| 英語 | 訳 |
|---|---|
| Additional icons - On the Desktop | デスクトップにアイコンの配置 |
| Windows Explore - Git Bash Here | エクスプローラーの右クリックメニューのリストに「Git Bash Here」を追加 |
| Windows Explore - Git GUI Here | エクスプローラーの右クリックメニューのリストに「Git GUI Here」を追加 |
| Git LFS (Large File System) | Git LFS（大きなサイズのファイル・システム）の利用 |
| Associate .git* configuration files with the default text editor |
デフォルトのテキスト・エディターと「.git*」コンフィグレーション・ファイルを関連付ける |
| Assiciate .sh files to be run with Bash | Bashと「.sh」ファイルを関連付ける |
■Select Start Menu Folder
スタートメニューのフォルダを選択します。
■Choosing the default editor used by Git
デフォルトのエディターを選択します。
今回は、「Visual Studio Code」を利用するように選択しています。
■Adjusting your PATH environment
環境変数の設定を行います
| 英語 | 訳 |
|---|---|
| Use Git from Git Bash only | Git Bashのみ利用 |
| Git from the command line and also from 3rd-party software | コマンドライン及びサードパーティソフトウェアのGitを使用 |
| Use Git and optional Unix tools from the Command Prompt | コマンドラインから、Git及びオプションのUnixツールを使用する |
今回は「Git from the command line and also from 3rd-party software」を選択する
■Choosing HTTPS transport backend
| 英語 | 訳 |
|---|---|
| Use the OpenSSL library | サーバー認証はca-bundle.crtファイルを使って行う |
| Use the native Widows Secure Channel library | サーバー認証はWindows Certificate Storeを使って行う |
今回は「Use the OpenSSL library」を選択する
■Configuring the line ending conversions
| 英語 | 訳 |
|---|---|
| Checkout Windows-style, commit Unix-style line endings | Gitはテキス・ファイルのチェックアウトを行う時LFをCRLFに変換する。テキスト・ファイルをコミットする時CRLFをLFに変換する。クロス・プラットフォーム・プロジェクトのためにWindowsに対して推薦される設定である。（「autocrlf」が「true」に設定される） |
| Checkout as-is, commit Unix-style line endings | Gitはテキス・ファイルのチェックアウトを行う時どんな変換も行わない。テキスト・ファイルをコミットする時CRLFをLFに変換する。クロス・プラットフォーム・プロジェクトのためにUnixに対して推薦される設定である。（「autocrlf」が「input」に設定される） |
| Checkout as-is, commit as-is | Gitはテキス・ファイルのチェックアウトやコミットを行う時どんな変換も行わない。このオプションを選択することはクロス・プラットフォーム・プロジェクトのために推薦することはできない。（「autocrlf」が「false」に設定される） |
今回は、Windowsの推奨設定にする。
■Configuring the terminal emulator to use with Git Bash
| 英語 | 訳 |
|---|---|
| Use MinTTY(the default terminal of MSYS2) | Git BashはMinTTYをターミナル・エミュレータとして使う。そして、それはサイズが変更可能なウインドウで、非長方形の選択、Unicodeをサポートしている。Windowsコンソール・プログラムは（対話型のPythonのような）MinTTYの中で動作させるために「winpty」を通して起動しなければならない。 |
| Use Widow’s default console windows | GitはWindowsのデフォルト・コンソール。ウインドウ（exe）を使用する。そして、それは対話型のPythonやnode.jsのようなWin32コンソール・プログラムと共に正常に動作する。しかし、デフォルトのスクロール・バックは非常に限られたものである。非ASII文字を正しく表示するためにはUnicodeフォントが使えるように設定する必要がある。また、Windows10以前のウインドウは自由にサイズを変更できないし、長方形のテキスト選択しか許されていない。 |
ここではデフォルトの「Use MinTTY」を利用する
■Configuring extra options
| 英語 | 訳 |
|---|---|
| Enable file system caching | ファイル・システム・データはある操作を行うためにメモリに野中にバルクやキャッシュされる。（fscacheがtrueに設定される）これは大幅なパフォーマンス向上を提供する。 |
| Enable Git Credential Manager | WindowsのためのGit Credential Managerは、Windowsに対して安全な認証証明の付きのストレージを提供する。それは、特にVisual Studio Team ServiceやGitHubのためのさまざまな認証サポートを行う。 |
| Enable symbolic links | シンボリック・リンクを有効にする。（SeCreateSymbolicLink 許可が要求される）現状のリポジトリーは、この設定に影響されないことに注意してください。 |
■Configuring experimental options
| 英語 | 訳 |
|---|---|
| Enable experimental, built-in add -i/-p | 実験的なBuilt-in機能、インタラクティブ追加を利用して高速化が実現できます。 |
下記のオプションは無効にする。
インストールが開始されます。
■インストール完了
下記の画面が表示されればインストール完了です。
Gitの初期設定
「Git Bash」を起動し、下記のコマンドで自分の情報を設定します。
git config --global user.email "メールアドレス"
git config --global user.name "名前"
コミットなどの際、登録した情報が利用されます。
リポジトリのURLへのアクセス
Gitが正しくインストールされているかを確認します。
コマンドラインを利用する場合
アクセスしたいURLと認証情報を準備します。
（情報が分からない場合は管理者に問い合わせてください。）
- URL ： GitリポジトリのURL
- 認証情報 ： CodeCommitの認証情報（IAMの作成時に取得した認証情報）
Git Bashを起動します。
Git用のフォルダを作成したいフォルダに移動します。
コマンドラインで下記のコマンドを実行します。
mkdir ｛Git用のフォルダ名｝
git clone ｛GITのリポジトリURL｝ ｛Git用のフォルダ名｝
Proxyの設定
社内環境等でアクセスが拒否された場合は、下記のコマンドで設定を変更してください。
git config --global http.proxy http://proxy.xxx.co.jp:8080
git config --global https.proxy http://proxy.xxx.co.jp:8080
git config --global http.proxy http://user:password@proxy.xxx.co.jp:8080
git config --global https.proxy http://user:password@proxy.xxx.co.jp:8080
VPN接続＋Proxy時の設定
http.proxyの後ろに「http://」が付いていると上手く接続できないので、下記のようなコマンドを利用する。
git config --global http.proxy path.to.proxy:port
git config --global https.proxy path.to.proxy:port
git config --global http.proxy user:password@path.to.proxy:port
git config --global https.proxy user:password@path.to.proxy:port
ユーザー認証
下記のような認証情報確認画面が表示された場合は、管理者から伝えられた認証情報を入力してください。
GUIを利用する場合
Git GUIをオープンし、Clone Existing Repositoryを選択します。
「Source Location」：GitのURL
「Target Directory」：Cloneしたいパス
を入力してcloneを実行します。
Proxyの設定
社内環境等でアクセスが拒否された場合は、「Git Bash」を起動し、下記のコマンドで設定を変更してください。
git config --global http.proxy http://proxy.xxx.co.jp:8080
git config --global https.proxy http://proxy.xxx.co.jp:8080
git config --global http.proxy http://user:password@proxy.xxx.co.jp:8080
git config --global https.proxy http://user:password@proxy.xxx.co.jp:8080
VPN接続＋Proxy時の設定
http.proxyの後ろに「http://」が付いていると上手く接続できないので、下記のようなコマンドを利用する。
git config --global http.proxy path.to.proxy:port
git config --global https.proxy path.to.proxy:port
git config --global http.proxy user:password@path.to.proxy:port
git config --global https.proxy user:password@path.to.proxy:port
Tortoise Gitの導入
個人的には、Tortoise Gitの方が使いやすいので、オススメです。
Tortoise Gitインストーラーのダウンロード
こちらから本体と言語パッケージをダウンロードする。
Windows 64bitの場合は下記の部分からダウンロードしてください。
■ 本体
■言語パック
Tortoise Git本体のインストール
インストーラーを起動したら、はじめのページが表示されますので、Nextをクリックします。
規約を確認し、Nextをクリックします。
今回はデフォルトのままでNextをクリックします。
英語の辞書は不要かと思いますので、今回は未選択にしました。
インストール先もデフォルトのままにしました。
インストールをクリックして、開始します。
日本語化を行う為に、自動起動のチェックを外します。
Tortoise Git言語パックのインストール
先ほどダウンロードした日本語化パックをインストールしていきます。
実行すると、はじめの画面が表示されますの、次へをクリックします。
以下の画面が表示されれば、日本語化は完了です。
日本語を利用するにチェックを入れて完了をおしてください。
Tortoise Gitネットワークの設定
社内ネットワーク等でProxyサーバーを利用している場合
ファイルエクスプローラーで右クリックし、下記の図のように設定を選択してください。
（メニューが日本語になっていない場合は、Settingsをクリックしてください。）
メニューが英語の場合は、全般の設定で「Language」という項目がありますので、日本語を選択してください。
ネットワークの設定を行います。
サーバーアドレスやユーザー名、パスワードを入力してください。
Tortoise Git 動作の確認
新規確認用のフォルダを任意の場所に作成してください。
その後、右クリックでメニューを開き、Gitクローン（複製）を選択してください。
URLにGitのURLを入力してOKを押してください。
下の図のように成功と表示されれば正常に動作しています。
下記のような認証情報確認画面が表示された場合は、管理者から伝えられた認証情報を入力してください。
まとめ
お疲れ様でした。
ここまで設定できればもうGitを利用して開発する事ができます。