Makoto Kamono

!この文章は人間が書きました画像はGeminiを使って生成しました なぜ、私たちはドキュメントを求めるのか開発現場において、ドキュメント管理は永遠の課題だ。点在する情報、矛盾する記述、実装との乖離、記されない背景情報など、ドキュメントの陳腐化は様々な形で現れる。これらに立ち向かおうとしては、その管理コストの高さに圧倒される。効果が明確に見えにくく、長い時間のかかるドキュメント整備をやり切ることは難しく、多くの現場でドキュメントは放置され、陳腐化し続けている。今度こそドキュメントの整備をやり切ると決意し、絶望する前に考えてほしい。私たちはなぜドキュメントがほしいのか？欲しいも...

決断をプロットし、全力で走り続けるためのプロジェクトドキュメント管理

はじめにAIに手順書を書かせてみよう! 手順書にはいくつか必要なポイントがあるね!明確な作業目的作業内容の確実性手順の網羅性影響範囲AIはここに書かれていること、結構苦手だよね。特に作業内容の確実性を担保することは苦手なんだよね!だから、AIに手順書を書かせるときは、AIが苦手なポイントを補うように工夫する必要があるよ!今回は、AIに｢災害時検証: CloudSQLリージョン移行｣の手順書を書かせてみて、一緒に工夫してみよう! 手順作成 まずはそのまままずは、AIにそのまま手順書を書かせてみよう! 以下のプロンプトを使用してみたよ!Cloud SQLの...

AIに手順書を書かせよう! 手順書作成で向き合うAIの不確実性

はじめにアプリケーションを運用する上で、可用性は避けて通れない重要なテーマです。可用性を確保するためにインフラの単一障害点を可能な限りなくし、冗長化構成を組むことは今や常識となっています。その中でも特に強力な障害対策として挙げられるのが「マルチリージョン構成」です。しかし、その実装と運用には相応のコストと複雑さが伴います。この記事では、クラウドインフラにおける障害対策としてのマルチリージョン化が、本当にあなたのアプリケーションに必要なのかを、コストとリスクの観点から考察します。 あなたのアプリに「高い可用性」は必要か？あらゆるサービスが高い可用性を目指すべきかというと、必...

あなたのアプリにマルチリージョンは必要ないかもしれない

!この記事は人間が書き、AIにレビューしてもらいました はじめにAIによって開発が加速した現在、プロダクト開発においてアイデアを素早くプロダクトに落とし込み、実際に市場に展開することが重要になっています。しかしMVP(最小限の実用的製品)を立ち上げる際のクラウドインフラやアーキテクチャの選択は、その後のプロダクトの成長や運用に大きな影響を与えます。本格的な構成を最初期から採用することは立派ですが、MVPが成功するかわからないものに高コストなインフラを選択することはリスクが高いです。逆に、安易に無料枠や低コストなサービスを選択すると、将来的なスケーリングや機能追加が困難になりま...

ミニマムかつ未来を見据えたGoogle Cloudアーキテクチャ

はじめにArgo CDとは、Kubernetesのための継続的デリバリー（CD）ツールです。GitOpsの原則に従い、Gitリポジトリの状態をKubernetesクラスターに同期させることができます。これにより、アプリケーションのデプロイメントや管理が容易になります。Kubernetes環境では広く利用されているArgo CDですが、Argo CD自体のセットアップ方法はいくつかの方法があります。ここでは、Argo CDの初期セットアップについて解説します。 Argo CDの初期セットアップArgo CDを利用可能にするには、以下の手順が必要になります。Argo CD ...

Argo CDのセットアップ方法を解説してみる

はじめにAWS LBC(Load Balancer Controller)は、EKS上のリソースとしてALBを構成するための機能です。今回はこの機能の基本的な使い方や、より高度な構成について説明します。 AWS LBCとはなにかAWS LBC(Load Balancer Controller)は、Kubernetesのリソースを監視し、AWS Elastic Load Balancerをそれにあわせて管理するコンポーネントです。AWS LBCが監視する対象は、EKS内のIngressリソースとService Type LoadBalancerリソースです。これらのKubern...

AWS Load Balancer Controller (LBC)でkubernetesのServiceを外部に公開する

はじめにAWS EKS (Elastic Kubernetes Service) を利用している場合、Kubernetes上のリソースだけで完結させることはほぼなく、多くの場合、kubernetesの世界にないAWSリソースにアクセスする必要があります。例えば、S3バケットへのファイルのアップロード、DynamoDBのテーブルへのデータの読み書き、SQSキューへのメッセージの送受信など、様々なユースケースが考えられます。その際に使用するのがPod Identityです。https://docs.aws.amazon.com/ja_jp/eks/latest/userguide/p...

EKS Pod Identityを利用してセキュアにkubernetesリソースからAWSリソースにアクセスする

はじめにgoruotineはgo言語の軽量スレッドの仕組みであり、並行処理が比較的簡単に実装できます。しかしその自由度の高さから、慣れていない人にとってはどのように実装したらよいのか、という迷いが生まれてしまいます。その中でもよく使う並行処理のパターンは決まっており、今回はよく自分が使うパターンを2つ紹介します。 前提こういう遅くて、エラーも起こる関数をテーマにします。func slowFunction(arg string) (string, error) {	fmt.Printf("SLOW FUNCTION START: %s\n", arg)	start :=...

goroutineによる頻出並行処理パターン2選

はじめにGoogleのSpannerデータベースはまだまだ知名度が低く、日本語での文献も豊富ではないため、いざ使うとなるとかなり苦労する技術です。ここでは最低限の概念を説明することにつとめ、通常利用においてSpannerのハードルを下げようと思いこの記事を執筆しました。基本的には以下の資料に載っている情報かと思いますが、実際にソースコードを見るとドキュメントの更新が追いついていない部分が多い印象でした。そのためクライアントライブラリのソースコードに可能な限り追従し、できるだけ平易な文章でまとめようと思います。https://cloud.google.com/spanner/do...

【基礎】 GoでSpannerを使う

始めにこの正月に、関数型ドメインモデリングという本を読みました。良書でした。https://amzn.asia/d/4NlwXFgそこで、今までオブジェクトで書いていたコードを関数としてかけないか?という思いつきでこの記事を書いた結果、なんだか関数型とは関係ない感じの記事になってしまいました。ご容赦ください。 ベースとなるサンプルコードまずはオブジェクト指向でよく使う形のサンプルを用意しました。タスク管理のモデルです。簡単のため、エラーなどはあまり返さないようにしています。domain/user.gopackage domainimport "fmt"typ...

interface、structで書くか、functionで書くか

はじめに最近になってTerraformを触る機会が少し増えてきました。そのリポジトリはdevelopment, staging, productionのそれぞれのディレクトリがありました。.└── environments    ├── development    │   ├── main.tf    │   └── xxx.tf    ├── staging    │   ├── main.tf    │   └── xxx.tf    └── production        ├── main.tf        └── xxx.tfこの構成では環境...

【GitHub Actions】編集されたディレクトリに応じてラベルを付与する

Goにはjavaでいうreadonlyのような、フィールドの変更を制御するような文法が存在しません。そのためGoではフィールドの公開、非公開が非常に重要な役割を持っています。Goで不変を表現したい場合、非公開なフィールドをつくり、それのゲッターを使って値を参照することが推奨されていますこの記事では興味本位ですが、フィールドの公開、非公開に注目して、どういった挙動をするのかまとめました。 検証 基本形それぞれの公開、非公開のプリミティブ型のフィールドを持っている場合は以下のようになります。pkg/item.gppackage pkgtype Item struct {...

Goの公開、非公開フィールドについて

Goのポインタについて、結局どうやって使い分けたらいいんだっけ?となることがあったので、挙動を整理したうえで使い所をまとめてみました。 ポインタの挙動 基本的な挙動Goのポインタは、変数の値が格納されているメモリアドレスを指します。そのためポインタをPrintすると、その変数のメモリアドレスが表示されます。main.gofunc main() {	v := "Hello, World!" // v is a string	p := &v              // p is a pointer to v	fmt.Println(v)	fmt.Prin...

Goのポインタをどう扱うべきか

はじめに釣りタイトルですまん。この記事は社内勉強会向けに作成した内容をZenn向けに再編集したものです。ソースコードhttps://github.com/Mkamono/objective-fizz-buzz 種本「ちょうぜつソフトウェア設計入門 PHPで理解するオブジェクト指向の活用」の5-3を参考にしました。https://amzn.asia/d/ewM0dJ1 突然ですが、FizzBuzzを書いてみてくださいはい。頑張ってください。要求は以下のとおりです。1以上の整数値が入力として渡される3の倍数のときは"Fizz"と出力する5の倍数のときは"B...

おまえらのFizzBuzzは間違っている(Go オブジェクト指向)

はじめに皆さん、Makefileは使っていらっしゃるでしょうか？Makefileは、ソフトウェアのビルドプロセスを自動化するための設定ファイルです。主にUNIX系OSで使用され、プログラムのコンパイル、リンク、インストールなどの手順を記述することで、簡単に実行できます。今回はBetter MakefileとしてTaskfileを紹介したいと思います。!Makefileはmakeコマンドによって実行されるファイルのことを指します。この記事では簡単のため、makeコマンドとMakefileを区別せず、ほぼすべての部分でMakefileと記載します。Taskfileもtaskコ...

Taskfileを有効活用して、Makefileのシェル芸から逃げる

はじめにGoogle Cloudを使う際、最も頻繁に遭遇するエラーは「権限が足りない」というものでした。特に新しいプロジェクトを立ち上げ、CI/CDの構築に取り組む際にこのエラーに何度も直面し、時間を浪費してしまいました。この経験から、Google Cloudの権限管理を深く知ることが重要であると痛感しました。そこで、体系的にGoogle Cloudの権限管理を学び、その成果をこの記事でわかりやすく共有したいと思います。 この記事を読んでほしい人Google Cloudにおける権限、ロール、プリンシパル、ポリシーの意味と関係性を説明できない人Workload Ident...