GitHub Actionsの実践のためのコードです。
単体テストとリリースの2つのサンプルを用意しています。
2024/1/19時点
- Windows 10 Pro 64bit(WSL2 Ubuntu 22.04)
- MacOS14 M1 Apple silicon
-
WSL2
- Windows上では再現が複雑で困難のため、WSL2をインストールしてWSL2のLinux上で実行してください。もしLinux環境が別途用意できるのであれば、こちらは不要です。
-
Node.js 20
-
Git
-
Githubアカウント
-
GitコマンドでGithubへhttpsまたはsshでアクセスできる
- WSL2のインストール
こちらも参考にしつつインストールしてください。 コマンドプロンプトを起動します。
wsl --install
成功すると、Ubuntuがインストールされます。 インストール後、Ubuntuを起動します。 起動すると、ユーザ名とパスワードを設定します。
- パッケージのアップデート
ユーザーを設定したらそのまま作業します。 起動初回はパスワードが求められるので、設定したパスワードを入力します。
sudo apt-get update- nvmのインストール
Node.jsのバージョン管理ツールであるnvmをインストールします。
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash- bashrcリロード
source ~/.bashrc- Node.jsのインストール
20系のNode.jsをインストールします。
nvm install 20- Node.jsのバージョン設定
インストールしたNode.jsを使用するように設定します。
nvm use 20- Gitの設定
Gitはプリインストールされています。 アカウント名とメールアドレスを設定します。 GitHubのアカウント名とメールアドレスを設定してください。
git config --global user.name "アカウント名"git config --global user.email "メールアドレス"- GitHub personal access tokenの取得
GitHubの画面で自身のアカウントアイコンをクリックしてメニューを開きます。 「Settings」をクリックします。
「Developer settings」をクリックします。
「Personal access tokens」のTokens(classic)をクリックします。
「Generate new token」をクリックします。
Noteに管理しやすいトークン名を任意に入力して、「repo」にチェックを入れます。 「Generate token」をクリックしてトークンを発行します。
作成したトークンが表示されます。このトークンをコピーします。
gitコマンドでGitHubへアクセスする際は、このトークンを使用します。 自身の端末内で厳重に管理してください。
- リポジトリをフォークする
こちらからソースをフォークします。 右上の「Fork」から「Create a new fork」をクリックします。
- Owner・・・自身のアカウントを選択します。
- Repository name・・・リポジトリ名を入力します。(規定値でもOK)
作成時のリポジトリ名はアルファベットであれば任意でOKです。しかし自身のアカウントに既に存在するリポジトリ名は使用できないので注意してください。 ご自身で識別しやすい名前にすることをお勧めします。
- フォークしたリポジトリのアクセス先を確認する
フォークしたリポジトリをGithubで表示します。緑色のアイコン「<> Code」をクリックします。 アクセス先をコピーします。アクセス先はhttpsとsshとで異なるので注意してください。 今回はhttpsでのアクセス先を想定します。
- フォークしたリポジトリをクローンする
自身のPCで任意の作業フォルダを開きます。 2で確認したアクセス先でリポジトリをクローンします。
git clone <コピーしたアクセス先>コマンドを入力するとユーザ名とパスワードを求められます。
- ユーザ名・・・GitHubのアカウント名
- パスワード・・・事前準備8で取得したトークン
- クローンできればフォークしたリポジトリ名のフォルダがダウンロードされます。中にこのファイル含むいくつかファイルがあれば、無事クローンできています。
- 以下のコマンドは全てLinux環境(WSL Ubuntu)での作業となります。
- ブランチの確認
ローカルPCで作業を行います。このファイルと同じ階層へ移動します。 現在がmainブランチになっていることを確認します。
git branch- 作業ブランチを作成する
ブランチを作成します。アルファベッドで作成することをお勧めします。
git checkout -b <branch-name>- このファイルを編集する
試しに、このファイルを編集してコミットします。
git add .
git commit -m "test"- プッシュする
変更をGitHubへプッシュします。
git push- プルリクエストを作成する
GitHubの画面からプルリクエストを作成します。 「Pull requests」をクリックして、「new pull request」をクリックします。 「main ← プッシュしたブランチ 」となるようにブランチを選択して、「Create pull request」をクリックします。
Open a pull request画面が表示されたら、「Create pull request」をクリックして作成します。
- アクションの実行 作成したらアクションが自動で実行されることを確認します。 実行アクションの一覧がプルリクエスト画面に表示されます。 ステータスが全てグリーンの✅になっていればアクションの成功となります。
- 実践： ソースを変更して、プルリクエストを作成してみる
上記のサンプルでは、無事テストのパスが確認できたと思います。 今度は実際にコードを変更して、変更をプッシュしてみましょう。 プッシュしたら再度、アクションが実行されることが確認できます。
- ブランチの確認
ローカルPCで作業を行います。このファイルと同じ階層へ移動します。 現在がmainブランチになっていることを確認します。
git branch- フォルダを移動
actions-runnerフォルダに移動します。
cd actions-runner- actions runnerをインストールする
下記のコマンドでインストールを行います。
./install-linux.sh
- フォークしたリポジトリからrunnerを登録方法を確認する
GitHubのフォークしたリポジトリ画面から、 「Settings」=>「Actions」=>「Runners」=>「New self-hosted runner」を開きます。
OSを下記の通り選択します。
Runner image・・・「Linux」 Architecture・・・「x64」
次に、Configure欄を確認します。 2つコマンドが記載されています。このうち1つ目の下記のようなコマンドが表示されています。 これをコピーします。
./config.sh --url リポジトリurl --token xxxxxxxxxxx- actions runnerを起動する
シェル画面に戻ります。 4でコピーしたコマンドを実行します。 対話形式で設定しますが、今回は全てデフォルトのままでOKです。 全てEnterで進みます。
設定後、さらに下記を実行します。
./run.sh以上で、actions runnerの設定は完了です。
無事完了すると、runner一覧にrunnerが表示され、アイドル状態になります。
- 作成したプルリクエストをマージする
GitHubの画面からプルリクエストをマージします。 サンプルその1をしていれば、プルリクエストがあると思いますのでこれをマージします。（プルリクエストがない場合は、その1と同じ要領で作成してください）
該当のプルリクエストを開き、「Merge pull request」をクリックします。
- アクションが実行されることを確認する
マージ後、アクションが実行されることを確認します。 リポジトリの画面から「Actions」を開き、実行されているアクションを確認します。
ステータスが全て✅になればアクションの成功となります。
- リリースされていることを確認する
アクションが完了したら、ブラウザで http://localhost:3000/ncdc にアクセスします。 下記のような画面が表示されれば、リリースが成功していることになります。
- 実践： ソースを変更して、再デプロイしてみる
上記のサンプルでは、無事デプロイが確認できたと思います。 再度コードを変更して、変更をプッシュ。プルリクエストを作成してみましょう。 プルリクエストをマージしたら再度アクションが実行され、リリースされることが確認できます。