Share
Embed
第2回 AWSとGitHub勉強会 - CodespacesとHelidonの利用 -
荻原利雄
September 18, 2023
Transcript
42 slides
-
本日の内容 • 前回の課題の回答(5分) • 課題の補足(50分) • GitHub Codespacesとは • Sampleで使っているHelidonの仕組み
• Sampleのテストの仕組み • Gitの補足 • 次回までの課題の説明(30分) 2 画面キャプチャやコマンド操作等はGitHubのssi- mz-studygroupユーザで行った例となります。キャ プチャやコマンド等の該当部分は自分のユーザIDに 読み替えてください ・ssi:simple server infra ・mz:mamezou -
GitHub Codespacesとは 7 • 構成ファイルをもとにビルドされたコンテナイメージから生成されたコンテナインスタンスを個別の開発環境としてユーザに提供す る機能 • ユーザはブラウザもしくはローカルのVSCodeから生成されたコンテナインスタンスに接続して作業を行う • ユーザは目の前にあるブラウザやVSCodeを操作するが、リポジトリからチェックアウトしたファイルやJavaのビルドや実行などは
すべてGitHub側のコンテナ内に存在し行われます 個人アカウントでも2コアCPU/4GBメモリ のリソースを月60時間まで無料で使うこ とができる -
Sampleを動かしてみる(1/2) • Sampleで使っているHelidonとは • アプリケーションサーバ不要でJakartaEE(Core Profile)とMicroProfileアプリ ケーションを起動させることができるフレームワーク 9 デモしてみる 1.
アプリケーションのビルド 2. アプリケーションの実行 案内が出てくるので とりあえず 無視して閉じる ここで紹介するコマンドは https://github.com/mamezou-tech/try-aws-github-learning のREADMEにも記載しています -
Sampleが動作している環境 11 起動Javaプロセス GitHub コンテナインスタンス(Codepsace)内 接続 起動したJavaプロセスはGitHub側のコン テナインスタンス内で起動している。 よって、localhostは自分のローカルマシン のlocalhostではなく、コンテナインスタンス
のlocalhostとなる。 コンソールで $ ps aux を試してみると見てくるもの があるかも!? -
MicroProfileとは – Helidonが実装しているもの 12 MicroProfile®プロジェクトは、マイクロサービスアーキテクチャ向 けにエンタープライズJavaを最適化することを目的とし、 JakartaEEかを問わずJavaのエコシステムを活用しながらマイクロ サービス向けの新しい共通APIと機能をオープンな環境で短いサ イクルで提供してくことを目標にする <MicroProfileプロジェクトの公式説明>
JakartaEEや既存のエコシステムを活用したマイクロサービス アーキテクチャ(MSA)向けのAPIや機能をオープンなプロセス で策定し、短期間でリリースしてく <超訳> JakartaEEをベースとしたMSA向けAPIセット つまるところ・・・ 出典:https://projects.eclipse.org/projects/technology.microprofile -
MicroProfileの実装形態 <JakartaEEアプリケーションサーバ(Liberty)> <MicroProfileフレームワーク(Helidon)> ✓ アプリケーションサーバに内包されるMicroProfileの実装 を利用する ✓ JakartaEEアプリと同じようにwar形式でアプリケーション サーバにデプロイする ✓
アプリの動作にはアプリケーションサーバが必要 ✓ jarのライブラリ形式で提供されるMicroProfile実装をアプリケー ションのdependencyに追加して利用する ✓ nettyなどの組み込みのHTTPサーバを内包しているため、アプリ ケーションサーバは不要で動作する ✓ 利用イメージとしては組込みTomcatを使ったSpringBootと同 じ HelidonはMicroProfileフレームワークの1つ ◼ 2つの実装形態がある -
おまけ:Helidonの実装方法 14 @ApplicationScoped @Path("/hello") public class HelloController { @GET public
String hello(@QueryParam("name") String name) { return String.format("Hello %s!", name); } } package jaxrs; public class HelloMain { public static void main(String[] args) { // Helidonの起動 io.helidon.microprofile.cdi.Main.main(args); } } <dependencies> <dependency> <groupId>io.helidon.microprofile.bundles</groupId> <artifactId>helidon-microprofile-core</artifactId> </dependency> ... </dependencies> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-jar-plugin</artifactId> <configuration> <archive> <manifest> <addClasspath>true</addClasspath> <classpathPrefix>libs</classpathPrefix> <mainClass>jaxrs.HelloMain</mainClass> </manifest> </archive> </configuration> </plugin> <アプリのコード> <pom.xml(一部抜粋)> これだけで推移的依存により必要な依存が追加される mainメソッドから起動 mainClassとclasspathをMANIFESTファイルに設定した ExecutableJarの作成 Sampleとは別ものを例に -
おまけ:Helidonのビルド~実行 15 target ├─jjug-mp-sample.jar <-- mainClassを持つアプリのExcutableJar ├─libs <-- 依存ライブラリ(Helidonの実体) │
├─aopalliance-repackaged-3.0.3.jar │ ├─helidon-common-3.2.1.jar │ ├─helidon-common-configurable-3.2.1.jar │ ├─helidon-common-context-3.2.1.jar │ ├─helidon-common-crypto-3.2.1.jar │ ├─helidon-common-http-3.2.1.jar │ ... $ mvn clean package $ java -jar target/jjug-mp-sample.jar 1. mavenでアプリをビルド ビルド結果 2. javaコマンドでアプリを起動 maven-dependency-pluginの copy-dependenciesゴールで runtimeとcompileスコープのjarが ./target/libにコピーされる 3. 起動イメージ ※target/libをls するとあります Sampleとは別ものを例に -
MicroProfileフレームワーク JakartaEEアプリケーションサーバ(warデプロイ形式) 主なMicroProfile実装 16 IBM陣営 ✓ 最新のMicroProfile6.0に対応しているの は現時点でOpenLibertyのみ ✓ ここに挙げたOpenLiberty以外は
MicroProfile5.0に対応 ✓ OpenLibertyは常にMicroProfileの最新 仕様に追従するスタンス ✓ 図からもIBM陣営はMicroProfileに積極的 なことがうかがえる ✓ LauncherはJakartaEEアプリケーションサー バではないが、アプリケーションをwar形式に する必要がある。warをuber JARに変換し てJavaコマンドから起動することができる ✓ PayaraMicroも同様なことができる -
JAX-RSの単体テストについて • WAS Libertyなどのアプリケーションサーバを使った開発ではJAX-RSアプリはアプリ ケーションサーバ上でしか動作させることができない。このため、JUnitを使って簡単にテ ストすることができず、この点がかなりつらい(Spring Bootが裏山) • 一方Helidonはmainメソッドから普通にJAX-RSアプリを起動することができる。この ため、HelidonのようなMicroProfileフレームワークでは単体テストを簡単に行うこと
ができる (Spring Bootと方式は同等!) • 今回のテストはJUnitから本物のJAX-RSアプリを動作させてテストを行っている 18 -
単体テストの仕組み – テストコード 20 @HelidonTest @AddConfig(key = "server.port", value =
"7001") @ExtendWith(JulToSLF4DelegateExtension.class) public class HelloResourceTest { private HelloResource helllResource; @BeforeEach public void setup() throws Exception { helllResource = RestClientBuilder .newBuilder() .baseUri(new URI("http://localhost:7001/api")) .build(HelloResource.class); } @Test void tesHello() { var expected = "Hello"; var actual = helllResource.hello(); assertEquals(expected, actual); } @Path("hello") interface HelloResource { @GET @Produces(MediaType.TEXT_PLAIN) String hello(); } } Helidonを起動するアノテーション(HelidonのJUnit拡張) Helidonを7001ポートで起動する指定 Helidonのログを見やすくするJUnit拡張(荻原オリジナル) setupメソッドで取得したRESTクライアント。このRESTクライアントを使って、 テスト対象のREST API(HelloResource)を呼び出す MicroProfile RestClientの機能を使って、テスト対象のREST API(HelloResource)を呼び出すHelloResourceインタフェースに対する Proxyインスタンスを取得する HelloResourceインタフェースのProxyインスタンスから http://localhost:7001/api/helloのリクエストが発行され、本物の HelleoResource#helloが呼び出される 同様にREST APIを呼び出すかをJAX-RSのアノテーションを使って定義した MicroProfile RestClientのインタフェース定義 これはプロダクトコード側のsample.HelloResourceは別もの(インタフェー ス名を同じにしているが異なっていてもよい) -
参考情報 • らくらくMicroProfile RestClient | 豆蔵デベロッパーサイト • https://developer.mamezou-tech.com/msa/mp/cntrn07-mp-restclient/ • Helidon
Tips - MicroProfile RestClientを使ったRESTリソースのJUnitテスト | 豆蔵デベロッパーサイト • https://developer.mamezou-tech.com/msa/mp/ext03-helidon-rest-testing/ 21 -
GitとGitHub • GitはVCS(Version Control System)の1つ • 未来で使っているVCSはSubversion • GitもSubversionと同様に自分でインストールしてGit単独で使うこともできる •
GitHubはVCSとしてGitや課題管理、CI環境などソフトウェア開発に必要な様々な サービスを一体として提供してくれるSaaSアプリケーション • 同様なSaaSアプリケーションとしてメジャーなものにGitLabがある 23 -
GitとSubversionの違い • Gitはマスタに相当するRemoteリポジトリとそのRemoteリポジトリをローカルに複製 (clone)したLocalリポジトリの2種類のリポジトリから構成される • 作業者はLocalリポジトリからチェックアウトしたワークファイルに対して変更を行い、行った変更を Localリポジトリにcommitする • Localリポジトリのcommit(変更内容)はRemoteリポジトリに対してpushすることでRemoteと Localが同期させる
• これに対してSubversionはRemoteリポジトリのみ • Remoteリポジトリからチェックアウトしたワークファイルを変更し、Remoteリポジトリに直接コミットす る • Gitの作業はすべてリポジトリ単位 • Subversionはリポジトリの下のどこからでもチェックアウトやブランチ、タグの作成ができるが、Gitで はこのようなことはできない。 • Gitでのチェックアウトやブランチ、タグの作成を行う単位はすべてリポジトリ単位となる 24 -
GitとSubversionの比較 Subversionの方が優れている点 • Subversionは仕組みがシンプル • Subversionは集中型でリポジトリがひとつです。 Gitはリモートとローカルリポジトリの両方を意識し なければならず、Subversionよりも操作が複 雑です。 •
リビジョン番号がわかりやすい • commitするとcommitを識別するためのリビジョ ン番号(ID)が振られます。Subversionは連 番で分かりやすいですが、Gitでは分散リポジトリの ためIDにハッシュ値が使われ分かり辛いです。 26 Gitの方が優れている点 • Gitはローカルにcommitできる • Gitは分散型でローカルにリポジトリを持つため、共 有リポジトリを汚さずにローカル上でcommit出来ま す。変更内容を共有リポジトリに反映させるかは任 意です。Subversionは「実験的なコードや未完成 なコードで共有リポジトリを汚したくない」との声がよく 聞かれます • ブランチとマージが使いやすい • GitのブランチとマージはSubversionに比べ高 速かつ手軽に使えます。Gitを活用するポイントはこ の2つを使いこなす事です。Git flowやGitHub Flow等の開発フローが参考になります。 引用:https://tracpath.com/works/development/subversion_vs_git/ -
次回までの課題 • テーマ • GitHubのCI/CD機能であるGitHub Actionsを試してみる • GitHub Actions でコンパイル~デプロイまでの行ってみる
• この成果物(artifact)をもとに次々回ではアプリのコンテナ化を行う • お題 • GitHubから提供されているGitHub Actions Template(Publish Java Package with Maven)からワークフロー定義を作成する • テンプレートを修正してゴールを満たすようにする • ゴール • ワークフロー定義が課題の中で指定された条件を満たしている • ワークフローの実行が成功する • GitHub Packagesにjarがデプロイ(登録)されていること 28 -
課題の実施手順 Step1. テンプレートからベースとなるワークフロー定義を生成する Step2. 起動条件に手動実行を追加してコミットする Step3. 実行してみる(失敗する) Step4. 課題を対応する Step5.
実行してみる(成功するまで行う) 29 今回の課題はCodespacesを使いません -
Step1. テンプレートからベースとなるワークフロー定義を生成する • リポジトリは前回の課題で各自に作成してもらったものを引き続き使います。⇒自分の リポジトリに移動 30 ココは自分のアカウントとリポジトリ クリック クリック テンプレート選択画面から
・リポジトリのチェックアウト ・コンパイル&jarの作成 ・GitHub Packagesへのデプロイ のアクションが予め定義された Publish Java Package with Mavenテンプレートを選択する -
Step2. 起動条件に手動実行を追加してコミットする • テンプレートに従ったワークフロー定義が生成される 拡大 ワークフロー定義のファイル名の指定⇒そのままでOK on: release: types: [created]
workflow_dispatch: 起動条件(on:)に破線赤枠の内容(手動実行)を追加する ※YAMLフォーマットなのでインデントには注意 上記が追加できたら ”Commit changes..”ボタンをクリック 左のダイアログがでるので、そのまま ”Commit changes”ボタンをクリック commitが完了すると参照画面になる 拡大 -
Step3. 実行してみる(失敗する)- 実行 • 作成したワークフローをGitHub Actionsで実行する ①Actionsをクリックして Actionsメニューを出す 登録済みワークフロー ※登録済みワークフローは./github/workflow以下のファイルが自動で認識される
②さっき作ったワークフローを選択 ③クリックする とメニューが現 れる ④クリックして実行 -
Step4. 課題を対応する • 課題その1 • ビルドエラーにならないようにワークフロー定義を修正する • 後続スライドのpom.xmlへの追加設定を行う • ヒント
• サンプルのアプリで使っているHelidonはJava17を必要とします • uses: actions/setup-java@v3のようにusesプロパティの右側にあるものはJP1の組み込みJOBのような ものに相当します。なので、何者か?やどんなプロパティ設定があるのか?などは”actions/setup-java”で 検索すると分かると思います • 課題その2 • リポジトリに変更があった場合、つまりmainブランチになにかがコミットされたら自動でワークフローが実行 されるようにする • ヒント • on:プロパティに起動条件を追加 • これもグルーグル検索すれば沢山情報があると思います -
Step4. 課題を対応する(web画面からの修正) クリック 展 開 クリック ワークフロー選択画面から クリックで編集モードになる 編集した後のcommit方法は「Step2. 起動
条件に手動実行を追加してコミットする」で説明 した手順と同じ -
Step4. pom.xmlへの追加設定 – jarのデプロイ先の指定 • 今回の課題ではjarをGitHub Packagesへデプロイするため、pom.xmlへでデプロイ先としてGitHub Packagesを指定する • GitHub
PackagesはGitHubのPackageリポジトリ機能 • ユーザごとに専用で使えるインハウスリポジトリのようなもの 編集モードに赤枠の部分をpom.xmlの一番下に追加する 編集 ひな形プロジェクトのREADMEの下記コード断片(snippet)から追加する部分のひな形をコピーする コード断片の@your_account@と@your_repository@の部分は自分のアカウントとリポジトリ名に置き換える 例)アカウントはssi-mz-studygroupでリポジトリ名はsample-appの場合、上記の例のとおりになる ※編集モード等の操作は前スライド「Step4. 課題を対応する(web画 面からの修正)」と同じ -
参考情報 • MavenでのJavaのビルドとテスト - GitHub Docs • https://docs.github.com/ja/actions/automating-builds-and-tests/building- and-testing-java-with-maven •
MavenでのJavaのパッケージの公開 - GitHub Docs • https://docs.github.com/ja/actions/publishing-packages/publishing-java- packages-with-maven#github- packages%E3%81%B8%E3%81%AE%E3%83%91%E3%83%83%E3%82%B 1%E3%83%BC%E3%82%B8%E3%81%AE%E5%85%AC%E9%96%8B