PINNED
このブログについて このブログは、私自身が開発・運用している技術ブログです。 私について SES企業でWebアプリケーションエンジニアとして、PHPを用いた既存システムの画面改修、データベース変更、テスト、不具合調査などを経験してきました。 現在は自己学習としてPython・Djangoを中心に、Webアプリケーション開発に取り組んでいます。 学習では、分からないことをそのままにせず、必要な範囲を調べ、小さく切り分けながら一つずつ理解して進めることを大切にしています。 このNagiLogも、Python・Djangoで開発しました。 AIの活用について 開発では、ChatGPTとCodexを活用しています。 ChatGPTには、実装方針や影響範囲を整理する際のメンターとして相談し、Codexにはコードレビューや実装の補助、コードの整理などを依頼しました。 AIが生成したコードをそのまま採用するのではなく、「なぜこの実装になるのか」「既存機能への影響はないか」を確認しながら、自分で理解・検証できる範囲で利用することを意識しています。 私が大切にしていること 私は、学ぶことをやめたくありません。 学び続け、それをお客様への価値につなげること。 技術そのものを目的とするのではなく、誰かの困りごとを解決するための手段として使えるエンジニアでありたいと考えています。 今回のブログも、最初からすべてを一度に作ったわけではありません。 小さく作る → 動作を確認する → テストする → 組み合わせる → もう一度テストする。 この流れを繰り返し、途中でレビューも挟みながら少しずつ組み立てました。 そうして作ったこのブログが、訪れてくださった方にとって読みやすく、使いやすいものになっていれば、とても嬉しく思います。🐇 NagiLogはこれからも育てていきます このブログは、現在の形が完成形ではありません。 今後は画像投稿やページング、統計機能などを追加し、蓄積したデータを可視化できるよう改良していく予定です。 そして、その過程で困ったこと、実装で悩んだこと、思いがけずハマってしまったことなども、このブログに記録していきたいと考えています。 採用担当者の皆様へ ここまでご覧いただき、ありがとうございます。 私は、誰かの役に立つものを作りたいという気持ちを大切にしています。 そのために、小さく作って試し、テストし、「実際に使う人にとって使いやすいだろうか」と考えながら改善することを心がけています。 まだ学んでいる途中の技術もたくさんありますが、分からないことを調べ、試し、検証しながら前へ進むことは、これからも続けていきたいと思っています。 このブログでは、完成した成果物だけではなく、「なぜそう考えたのか」「どのように問題を切り分けたのか」といった開発中の思考も「ログ」タグに残していく予定です。 もし私の開発に対する考え方や学習の過程にも興味を持っていただけましたら、ぜひ「ログ」タグの記事もご覧いただけると嬉しく思います。
インフラ見直し計画について NagiLogを公開してしばらく経ち、本番環境について改めて見直すことにした。 きっかけは、かなり単純だった。 「今使っているVPSをMinecraftサーバーにできないかな?」 という、ブログとはほぼ関係のないところから始まった。 調べていくうちに、現在のVPSはもともとゲームサーバーとして契約したものであり、 今の自分の用途に対して本当に適切なのか?という疑問が出てきた。 現在、一番大切なのはMinecraftサーバーではない。 Djangoで作ったNagiLogを安定して運用しながら、本番環境について学ぶこと。 そこで、NagiLog V2ではアプリケーション側だけでなく、 本番インフラについても見直してみることにした。 現在考えていること 現時点では、以下のような構成を考えている。 VPS自体の見直し NagiLogのDocker化 PostgreSQLのDocker環境への移行 nginxによるリバースプロキシ HTTPS対応 DBバックアップの自動化 バックアップデータのVPS外への保管 リストア手順の確認 DNS切り替えによる新環境への移行 特に今回重視したいのが、バックアップ。 これまでは「バックアップを取る」というところまでを考えていたが、 本当に大切なのは、 バックアップから実際に復旧できること だと気が付いた。 そのため、本番環境を変更する前に現在のPostgreSQLをdumpし、 ローカルのDocker環境へrestoreできることを確認してから 移行作業へ進む予定。 また、現在公開している記事はMarkdown形式でも別途保存する。 DBのリストアに失敗した場合でも、 最低限、記事そのものだけは失わないための保険として残しておく。 まだ「計画」の段階 今回はまだ実装していない。 VPSについても複数のサービスを比較している段階で、 構成についてもこれから検証していく。 AIにも設計案を出してもらう予定だが、 提案された構成をそのまま採用するのではなく、 「なぜ必要なのか?」 「自分の環境に本当に必要なのか?」 「障害が起きたときに復旧できるのか?」 を一つずつ確認して決めたい。 実際に移行が完了したら、 構築手順や失敗したところも含めて改めて記録する予定。 Minecraftサーバーを作ろうとしていただけなのに、 気が付いたら本番インフラの再設計が始まっていた。 どうしてこうなった。
🐋 PCを汚したくないのでDockerでPostgreSQL環境を作った NagiLogの開発環境ではSQLite、本番環境ではPostgreSQLを使用していた。 この環境差は以前から把握していたものの、優先順位を下げていたため、 NagiLog_v2ではローカル環境もPostgreSQLへ統一することにした。 ただし、PostgreSQLをWindowsへ直接インストールして常駐させるのは避けたい。 そこで今回はDockerを使い、PostgreSQLをコンテナとして動かすことにした。 🐋 Docker環境を準備 PCにはDocker環境がなかったため、まずWSL2とDocker Desktopを導入した。 Docker Engineが正常に起動することを確認後、 NagiLog_v2にcompose.yamlを作成した。 🐘 PostgreSQLコンテナを定義 今回の構成は以下。 PostgreSQL 17 DB名:nagilog PostgreSQL用ユーザーを作成 Windows側の5432ポートをコンテナへ接続 Docker Volumeを利用してDBデータを永続化 Dockerコンテナ自体を作り直してもDBデータを保持できるよう、 PostgreSQLのデータ領域にはVolumeを割り当てた。 🧪 Compose設定を確認 コンテナを起動する前に、 docker compose config を実行。 Composeファイルが正常に解釈されることを確認した。 その後、 docker compose up -d でPostgreSQLコンテナを起動。 docker compose ps でコンテナがUpになっていることと、 5432ポートが正常に公開されていることを確認した。 🐘 PostgreSQLへの接続確認 最後にコンテナ内のPostgreSQLへpsqlで接続。 作成したnagilogデータベースへ正常に接続できることを確認した。 これでWindowsへPostgreSQLを直接インストールせず、 NagiLog_v2専用のPostgreSQL環境を用意できた。 📝 今回理解したこと Docker Composeでは、 image:コンテナを作る元となるイメージ environment:コンテナへ渡す環境変数 ports:ホストPCとコンテナのポートを接続 volumes:コンテナとは別にデータを永続化 という役割がある。 特にVolumeはバックアップそのものではなく、 コンテナを作り直してもデータを保持するための永続化領域であることを理解した。 🚀 次回 PostgreSQL自体の準備は完了したが、 現時点ではDjangoはまだSQLiteを使用している。 次はDjangoのDATABASES設定を変更し、 SQLite → Docker上のPostgreSQL へ接続先を切り替える。 その後、 migration 既存機能の動作確認 全回帰テスト まで実施する予定。
職務経歴書を一から見直して学んだこと 今回は、転職活動中に起きた職務経歴書の失敗について記録しておこうと思います。 技術的な実装の話ではありませんが、自分の経験やスキルを正確に伝えることも、エンジニアとして大切なことだと感じた出来事でした。 きっかけ 応募活動では、第三者に整理していただいた職務経歴書を使用していました。 自分一人で作成したものよりも見た目がきれいに整理されており、 プロが作成したものだから大丈夫だろう と安心してしまっていました。 もちろん一度も内容を見ていなかったわけではありません。 しかし、文章の修正や不要な情報の削除には目を通していたものの、担当工程や技術経験について、一つひとつ自分の実際の経験と照らし合わせるところまではできていませんでした。 そして面接をきっかけに、その問題に気が付きました。 知らないスキルが生えていた 改めて職務経歴書を確認すると、自分では経験した認識のない工程が記載されていました。 反対に、実際に経験していた複数の業務が大きな案件としてまとめられ、具体的に「何をしていたのか」が分かりにくくなっている部分もありました。 見た目としては、とてもきれいな職務経歴書でした。 しかし、 見た目がきれいに整理されていることと、自分の技術経験が正確に伝わることは別です。 ここを混同してしまったことが、今回の一番大きな失敗だったと思います。 過去の経験を一から掘り起こした 問題に気が付いてから、職務経歴書を一から作り直すことにしました。 まず行ったのは、過去のスキルシートを探すことでした。 幸い、以前使用していたスキルシートが残っていたため、それを当時の記憶と照らし合わせながら、一つずつ経験を確認していきました。 例えば、 PHPを使って何を変更したのか React / TypeScriptでは何を実装したのか SAML認証の案件ではどこまで担当したのか C# / ASP.NETでは何を変更したのか DBに対してどのような作業をしたのか テストでは何を作成し、何を確認したのか といった形です。 記憶が残っているものは具体的に書き、過去の資料でも確認しました。 一方で、どうしても詳細を思い出せないものについては、無理に具体化しないことにしました。 「説明できること」を基準にする 今回、職務経歴書を作り直すうえで一つの基準を決めました。 面接で質問されたとき、自分の言葉で説明できるか。 これです。 例えば、経験していない工程を職務経歴書に記載してしまえば、面接でその内容について質問されるのは当然です。 そこで説明できなければ、実際には別の部分で経験を積んでいたとしても、それを伝えることが難しくなってしまいます。 反対に、小さな改修だったとしても、 「どのような変更だったのか」 「何を確認したのか」 「どの技術を使ったのか」 を自分で説明できるのであれば、それは自分が実際に経験した仕事です。 職務経歴書を強く見せることよりも、まずは事実を正確に伝えることを優先することにしました。 今回の学び 今回の学びは、とてもシンプルです。 自分の名前で提出する技術経歴は、自分自身が説明できる内容になっているか必ず確認する。 第三者に作成や添削をお願いすること自体が問題だったわけではありません。 最終的にその書類を自分の名前で提出する以上、内容を確認する責任は自分にあります。 今後は職務経歴書を更新するときに、 実際に経験した内容か 使用技術は正しいか 担当した工程は正しいか 複数の案件や業務が混ざっていないか 面接で質問されたときに自分の言葉で説明できるか を確認してから使用するようにします。 失敗から得られたもの 今回の失敗は、かなり痛いものでした。 もっと早く気が付くべきだったという後悔もあります。 ただ、過去の資料を探し、当時の記憶を掘り起こしながら職務経験を一つずつ整理したことで、 「自分はこれまで何をしてきたのか」 を改めて理解する機会にもなりました。 忘れていた経験もありましたし、逆に記憶が曖昧で、今の自分では詳しく説明できないものもありました。 それらを区別して整理したことで、以前よりも自分自身が納得できる職務経歴書になったと思います。 まとめ 今回の件で、職務経歴書は単に「きれいな書類を作るもの」ではないと改めて感じました。 大切なのは、自分が経験してきたことを正確に整理し、相手に伝えられる状態にすることです。 そして何より、 自分の経歴を一番理解していなければならないのは、自分自身です。 今後は同じ事故を起こさないよう、職務経歴書についてもコードと同じように、変更したら内容を確認し、自分自身でレビューしてから使うようにしたいと思います。
🐇 Markdown表示崩れの修正と本番反映 Markdownの記事で、コードブロックやテーブルが正しく表示されない問題を修正した。 🔍 原因調査 本番と同じ記事データをローカル環境で確認し、Markdown変換処理を順番に調査。 確認した結果、 fenced code block が通常の <code> として処理されていた コードブロックの language-* 属性が保持されていなかった Markdown Table が <table> に変換されていなかった Preview側のDOMPurifyでもtable関連タグが許可されていなかった など、複数の原因が重なっていることが分かった。 🛠 Markdown変換処理を修正 Python-Markdownで必要なExtensionを有効化。 fenced_code tables Bleach側でも必要なHTMLタグ・属性を許可し、サニタイズを維持したままMarkdownを表示できるように修正した。 Preview側のDOMPurifyについても、table関連タグを許可するよう変更。 🧪 テスト追加 今回見つかった問題についてテストを追加。 fenced code blockが<pre><code>へ変換されること コードブロックのlanguage情報が保持されること Markdown Tableが<table>へ変換されること 既存テストも含めて実行。 80 tests ALL GREEN ✅ 🎨 Tableの表示調整 Markdown Table自体は表示できるようになったものの、罫線がなく読みにくかったためCSSを追加。 記事詳細と入力中PreviewのMarkdown領域だけを対象にして、 罫線 セルの余白 見出し背景 テーブル幅 を調整した。 🚀 本番環境へ反映 GitHubへpush後、VPSへ反映。 その際、本番環境ではローカルと異なり、 PostgreSQL 環境変数によるSECRET_KEY / DB設定 Gunicorn STATIC_ROOT などの本番専用設定がVPS側に存在していることを再確認。 本番設定をバックアップ+stashへ退避してから最新版をpullし、本番設定を復元した。 その後、 manage.py check collectstatic Gunicorn再起動 systemctl status ブラウザでの表示確認 まで実施。 CSSが更新されない問題があったため、collectstatic --clear でstaticファイルを再収集して解消した。 ✅ 結果 コードブロック表示:OK language情報:OK Markdown Table:OK Table CSS:OK Preview:OK 80 tests:ALL GREEN Gunicorn:active (running) 本番表示:OK 無事、本番環境まで修正完了 🐇✨ 📝 次回 ローカルはSQLite、本番はPostgreSQLという構成になっているため、次回はローカル環境もPostgreSQLへ移行する。 あわせて、本番環境だけで変更されている設定を整理し、今後のデプロイを安全かつシンプルにできる構成へ改善する。
🐇 nginx + サブドメイン公開 チートシート 目的 blog.example.com のようなサブドメインへのアクセスをVPSへ向け、 nginxで受け取ってWebアプリへ渡し、HTTPSで公開する。 🌐 全体の流れ ブラウザ │ │ https://blog.example.com ▼ DNS │ 「このドメインは、このVPSだよ」 ▼ VPS │ ▼ nginx │ 「blog.example.com 宛てだね」 ▼ proxy_pass │ 「このアプリへ渡すよ」 ▼ Webアプリ ① DNS:サブドメインをVPSへ向ける ドメイン管理側で、サブドメインを VPSのIPアドレス に向ける。 例 blog.example.com ↓ xxx.xxx.xxx.xxx Aレコードならイメージはこんな感じ。 名前:blog 種類:A 値 :VPSのIPアドレス 🐇 覚え方 DNS = 住所案内 「blog.example.com に行きたい!」 ↓ 「その住所なら、このVPSですよ」 ② nginx:サブドメインの受付を作る nginxの設定に server_name を書く。 server { listen 80; server_name blog.example.com; location / { proxy_pass http://127.0.0.1:8000; } } server_name server_name blog.example.com; このドメイン宛てのアクセスを、この設定で受け取る。 proxy_pass proxy_pass http://127.0.0.1:8000; nginxが受け取ったリクエストを、内部で動いているWebアプリへ渡す。 🐇 イメージ blog.example.com ↓ nginx ↓ 127.0.0.1:8000 ↓ Webアプリ ③ nginx設定を有効化する Ubuntu系でよく使われる構成: /etc/nginx/sites-available/ に設定ファイルを置く。 そして、 /etc/nginx/sites-enabled/ から使えるようにする。 シンボリックリンクを作成 sudo ln -s /etc/nginx/sites-available/blog \ /etc/nginx/sites-enabled/blog 🐇 覚え方 sites-available → 設定ファイル置き場 sites-enabled → 実際に使う設定 ln -s はコピーではなく、 「この設定を使います!」というリンクを作る イメージ。 ④ nginxの構文チェック 設定を書いたら、いきなり反映しない。 まずチェック。 sudo nginx -t 成功すると、おおむね以下のような結果になる。 syntax is ok test is successful ⚠️ ここでエラーが出たら反映せず、設定を修正する。 🐇 sudo nginx -t ↓ GREEN? ↙ ↘ YES NO ↓ ↓ 反映 修正 ⑤ nginxへ設定を反映 構文チェックが通ったら、 sudo systemctl reload nginx nginxに新しい設定を読み直してもらう。 🐇 覚え方 nginx -t 「この設定、大丈夫?」 reload nginx 「じゃあこの設定使って!」 ⑥ HTTPS化 Certbot + Let's Encrypt を使う場合。 代表的な例: sudo certbot --nginx -d blog.example.com 役割 Let's Encrypt → TLS証明書を発行する。 Certbot → 証明書の取得・設定・更新などを助けてくれる。 結果: http://blog.example.com ↓ https://blog.example.com 🧠 ここだけ覚える 項目 役割 DNS サブドメインをVPSへ向ける nginx / server_name どのドメイン宛ての通信を受けるか決める proxy_pass 受け取った通信をWebアプリへ渡す nginx -t nginx設定の構文チェック systemctl reload nginx nginxへ設定を反映 Certbot / Let's Encrypt HTTPS化 🐇 最短ルート ① DNS ↓ サブドメイン → VPS ② nginx ↓ server_name を設定 ③ 有効化 ↓ sites-available → sites-enabled ④ チェック ↓ sudo nginx -t ⑤ 反映 ↓ sudo systemctl reload nginx ⑥ HTTPS ↓ Certbot / Let's Encrypt ⚠️ 今回のNagiLogでは、なぜあんなに大変だった? このチートシートは、 「nginx + サブドメイン公開」 だけを抜き出した基本ルート。 NagiLogでは、これだけではなく、 Djangoアプリをまっさらな本番Linux環境へ持っていき、 実行環境を整え、Webサーバーへ接続し、HTTPSで公開する ところまで行った。 そのため、実際には以下も登場した。 Python ↓ venv ↓ pip / requirements.txt ↓ PostgreSQL ↓ Django ↓ Gunicorn ↓ systemd ↓ nginx ↓ DNS ↓ Certbot / HTTPS さらに途中で、 Pythonのバージョン調整 pip・依存パッケージの調整 Linuxのファイル・ディレクトリ権限 PostgreSQLの設定 Djangoの本番設定 Gunicornの起動 systemdによる常駐化 なども必要になった。 💡 つまり サブドメイン公開そのものが巨大だったわけではない。 ❌ サブドメインを切るだけで大量の作業が必要だった ⭕ Djangoアプリの本番環境をゼロから構築したため、 大量の作業が必要だった 📌 別チートシートへ 次に整理するもの: 「Django 本番デプロイ正式ルート」 Python → venv → pip → PostgreSQL → Django → Gunicorn → systemd → nginx → DNS → HTTPS それぞれ、 「何をする?」 「なぜ必要?」 「どのコマンド?」 の3点で整理する。
Minecraft 26.3が起動直後にクラッシュした話 Minecraft 26.3へアップデートしたところ、起動直後にクラッシュするようになりました。 今回は原因を一つずつ切り分けて調査しました。 症状 MultiMCからMinecraft 26.3を起動すると、画面が表示されたあとクラッシュ。 ログでは以下のエラーを確認しました。 STATUS_ACCESS_VIOLATION (0xC0000005) 最初はSodiumなどのMODを疑いました。 切り分け 原因を確認するため、環境を一つずつ減らして試しました。 Sodiumを無効化 → クラッシュ Irisを無効化 → クラッシュ Fabric APIを無効化 → クラッシュ 新しくVanilla 26.3環境を作成 → クラッシュ Minecraft 26.2を起動 → 正常 Vanilla環境でも同じ現象が発生したため、MODが直接の原因ではなさそうだと判断しました。 また、正常に動作する26.2と26.3では同じJava 25.0.1を使用していました。 解決方法 Minecraft 26.3で同様のクラッシュが発生している事例を調べたところ、Javaの起動引数に以下を追加する方法が見つかりました。 -XX:StackShadowPages=32 MultiMCでは、 インスタンスの編集 → 本実例の個別設定 → Java → Java起動引数 から追加しました。 その後、Vanilla 26.3を起動。 正常に起動しました。 今回の学び 最初はMODを疑いましたが、一つずつ機能を外し、最後にVanilla環境でも再現することを確認したことで、原因の範囲を絞ることができました。 不具合が起きたときに、いきなり環境を作り直すのではなく、 一つ変更する → 動作確認 → 結果を記録する という切り分けの大切さを改めて実感しました。 今回は無事解決です。🐇