15
9

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

GenUを最速で更新!AWS CodePipelineで実現するワンクリック更新術

Posted at

AWSで生成AIの活用方法を検討する際に、GenU(Generative AI Use Cases JP)を使われている方は多いと思います。

オフィシャルサイトがかっこいい!!

GenUとは

GenUはAWSのソリューションアーキテクトの皆様が作成されたアプリケーションで、オープンソースで公開されています。

デプロイの手順もとても簡単にまとめられており、AWSにはじめて触る人でも十分構築できると思います。

ただ、生成AIを扱ったアプリケーションであるため、更新が高頻度で発生するという特徴があります。
最近では、「Claude 3.7」がAmazon Bedrockで利用できるようになりましたが、当日中にGenUでも利用できるよう対応されました。

翌日には新機能であるextended thinkingにも対応済みです!驚きの速さですね!!

以下のように、毎日更新がありますw

github.com_aws-samples_generative-ai-use-cases-jp_commits_main_.png

更新頻度が高いので、毎回開発環境を立ち上げてコマンドを実行する作業自体が手間になってきます。
そこで、新機能が追加された際に素早く簡単に更新する方法として、AWS CodePipelineをGitHubと連携して使用する方法を紹介します。

GitHubの画面で差分を取り込むだけGenUが最新版になります

知識として知っているのと、実際に使って実感する便利さは雲泥の差です。さあ、レッツトライ!

全体イメージ

まずは、本家のリポジトリを自分用のフォークします。フォークしたリポジトリに変更を取り込むと、変更をCodePipelineが自動で検知し、ビルドとデプロイを開始します。

image.png

なので、更新時にすることは、「最新の変更を自分のGitリポジトリに取り込む」だけです。

↓↓↓百聞は一見にしかず↓↓↓

Animation.gif

「Sync fork」を行って少し待つと、CodePipelineによるビルドとデプロイが始まります。

手順

GitHubのリポジトリをフォークする

  1. GitHubのGenUリポジトリを開く
    右上の「Fork」ボタンをクリックします

    同時にStarもつけましょう!!!

  2. Fork先のリポジトリの情報を入力します。デフォルトで構いません
    「Create fork」をクリックします

    少し待ちます

AWS CodePipelineの設定

  1. AWSのマネジメントコンソールでCodePipelineの画面を開きます
    「パイプラインを作成する」をクリックします

  2. 「カスタムパイプラインを構築する」を選択して、「次に」をクリックします(次に ってなによ)

  3. パイプライン名(「GenU-Pipeline」とします)を入力し、「次に」をクリックします(次に ってなによ)

  4. ソースプロバイダーとして「GitHub(GitHubアプリ経由)」を選択します

    us-east-1.console.aws.amazon.com_codesuite_codepipeline_home_region=us-east-1 (3).png

    入力欄が出てくるので、「GitHubに接続する」をクリックします

  5. ポップアップが開きます
    接続名(ここでは「GitHub」)を入力して、「GitHubに接続する」をクリックします

  6. 「新しいアプリをインストールする」をクリックします

  7. GitHubの画面に遷移します(未ログイン状態の場合はログインを求められると思います)
    GitHubに「AWS Connector for GitHub」アプリをインストールするかどうかの同意を求められます
    このアプリにアクセスを許可するリポジトリを選択します(Allでも良いですしGenUのリポジトリのみでもOKです)

  8. AWS側の画面に遷移しますので、「接続」をクリックします

  9. モーダルが閉じ、元の画面に戻ります(「接続」が入力された状態になります)
    リポジトリ名とデフォルトブランチを入力します
    「次に」をクリックします(次に ってなによ)

  10. ビルドステージを追加します
    プロバイダーを構築するは「コマンド」を選択します

    最近のアップデートで、別途CodeBuildを設定しなくても、CodePipelineのウィザードでビルドコマンドを指定できるようになりました!!!

    参考:https://dev.classmethod.jp/articles/codepipeline-action-commands/

    コマンドに以下のコマンドを入力します(空白行があると後でエラーになるので注意)

    npm ci
    npm run cdk:deploy:quick
    

    ブートストラップ処理(npx -w packages/cdk cdk bootstrap)は必要に応じて追加してください。私はすでに実施済みのため、上記コマンドには含めていません。

    「次に」をクリックします(次に ってなによ)

  11. テストは行わないので、「テストステージをスキップ」をクリックします

  12. ビルドステージですでにCDKコマンドでデプロイしてしまうので、デプロイステージはスキップします。「導入段階をスキップ」をクリックします(導入段階 ってなによ)

  13. 内容を確認し、画面最下部の「パイプラインを作成する」をクリックします

  14. パイプラインが作成されると自動的に実行が開始します

    ただし、設定がまだ足りていない(IAM権限が不足している)ので必ず失敗します

  15. 「設定」タブにサービスロールARNが表示されるのでリンクをクリックし、IAMの設定画面を表示します

  16. 「許可を追加」メニューの「インラインポリシーを作成」をクリックします

  17. 「JSON」表示に切り替えて、以下のJSONを入力します

    ロググループのARNはご自分の環境に合わせてください。ロググループ名は「/aws/codepipeline/{pipeline-name}」です)

    {
    	"Version": "2012-10-17",
    	"Statement": [
    		{
    			"Sid": "VisualEditor0",
    			"Effect": "Allow",
    			"Action": [
    				"logs:CreateLogStream",
    				"logs:CreateLogGroup",
    				"logs:PutLogEvents"
    			],
    			"Resource": [
    				"arn:aws:logs:us-east-1:123456789012:log-group:/aws/codepipeline/GenU-Pipeline",
    				"arn:aws:logs:us-east-1:123456789012:log-group:/aws/codepipeline/GenU-Pipeline:log-stream:*"
    			]
    		},
    		{
    			"Sid": "VisualEditor1",
    			"Effect": "Allow",
    			"Action": "sts:AssumeRole",
    			"Resource": "*",
    			"Condition": {
    				"ForAnyValue:StringEquals": {
    					"iam:ResourceTag/aws-cdk:bootstrap-role": [
    						"image-publishing",
    						"file-publishing",
    						"deploy",
    						"lookup"
    					]
    				}
    			}
    		}
    	]
    }
    
  18. ポリシー名を入力して、「ポリシーの作成」をクリックします

  19. CodePipelineの画面に戻り、「変更をリリースする」をクリックします。こうすることで同じソースコードに対して再ビルドが動きます

    成功すると、緑色になります。やったね

これで、mainブランチに変更が入るたびに、自動でパイプラインが動くようになります。

まとめ

本記事では、AWS CodePipelineを活用してGenU(Generative AI Use Cases JP)を効率的に最新版に保つ方法を紹介しました。

  • GenUは高頻度で更新されるため、手動での更新作業が負担になりがち
  • GitHubリポジトリをフォークし、AWS CodePipelineと連携することで自動更新が可能に
  • 更新時には「Sync fork」ボタンをクリックするだけというシンプルな運用
  • IAM権限設定などの初期セットアップは少し手間ですが、一度設定すれば長期的に大幅な時間節約になる

このパイプラインを構築することで、Claude 3.7のextended thinkingなど、続々と追加される最新機能をすぐに試せるようになります。AWSの生成AI機能をビジネスに活用したい方や、常に最新の開発環境を維持したい方には特におすすめの方法です。
ぜひ皆さんもAWS CodePipelineの魔法を体験して、GenUの最新機能を存分にお楽しみください!

コマンドはシンプルなので、CDKで構築されたものは同様にPipelineを構築できると思います

15
9
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
15
9

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?