はてなブックマーク

どうもお疲れ様です。MESIです。 私は2017年にブログを書き始めたのをきっかけにインターネットに文章を公開するようになりました。 Zennでの投稿数は本記事執筆時点で22記事ですが、これまでブログ等に投稿してきた量は合計200本を超えています。 8年で200本という投稿頻度は決して高くありませんが、これだけの記事を書き続ける中で、読まれる記事とそうでない記事の違いを体感で理解するようになりました。 本記事では私がこれまで記事を書いてきて実践で学んだ読まれる記事の書き方について紹介します。 Zennでの投稿なので技術記事に焦点を当てますが、一般的なブログ記事にも応用できると思います。 【秘訣1】記事のタイトルに命をかける プログラミングにおいて変数名が重要であるように、記事においてはタイトルが極めて重要です。 どんなに素晴らしい記事を書いてもタイトルが駄目だと台無しになります。 タイトル

私は車輪の再発明が大好きです。 人が作った技術について、どういう風に作られているかとか興味ないですか？ エンジニアの世界でよく「車輪の再発明はするな。巨人の肩に乗れ！」と言われます。それは確かに、プロダクトを早く作り上げるには重要な考え方です。既存の技術を活用することで、効率よく目標に到達できます。 しかし、もし車輪の構造をよく知らないまま乗り物を作ったとしたらどうでしょう？いざ車輪にトラブルが発生したときに対処できなかったり、もっと良い車輪を生み出せる可能性を見逃してしまうかもしれません。 実際、データベースの仕組みを深く理解せずに使った場合、パフォーマンスの問題や障害に直面したときに原因を特定できず、対応に苦労することがあります。逆に、基礎から構造を学び、自分で仕組みを構築する経験を積むことで、トラブル解決能力が向上し、独自の最適解を導き出すことができるのです。 車輪の構造を学ぶには、

JWTって何？ JWTはJSON Web Tokenの略です。 まずは完成されたJWTを見てみましょう。 eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c この文字列がJWTです。 JWTの特徴を見てみる よく見ると、この文字列は 「.」(ドット) で区切られています。 JWTは次の3つのパーツから構成されています。 ヘッダ（Header） ペイロード（Payload） 署名（Signature） ただの文字列じゃない？ JWTは単なる文字列ではありません。 実は、この「ヘッダ」や「ペイロード」をデコードすると、JSON形式のデータ

どうもお疲れ様です。MESIです。 Web系のエンジニアをやっていると普段からクッキーやらセッションやらを使うことになると思います。 皆さんの職場でも、こんな言葉を耳にするのではないでしょうか。 「クッキーに保存しよう」 「クッキー削除しよう」 「セッションに保存しよう」 「セッションが切れた」 そこで私のようなよわよわエンジニアはこう思うのです。 「クッキーとセッションの違い is 何？」 今回はそんな私のようなエンジニア向きにクッキーとセッションを説明していきます。 そもそもなぜクッキーやらセッションが必要なのか そもそもなぜクッキーやセッションは必要なのでしょうか。 それはHTTPはステートレスなプロトコルだからです。 ステートレスって？ ステートレスは、その名の通り「状態を保持しない」ことを指します。 HTTPはサーバーがクライアントの状態を覚えず、毎回新たなリクエストとして処理さ

Rust 版 Rails "Loco" Loco は Rails にインスパイアされた Rust の比較的新しい Web フレームワークです。 2024 年 9 月 1 日時点でバージョン 0.8.0 がリリースされています。 Loco の特徴 タイトルにもある通り、Loco is Rust on Rails. [1] を謳っており、 Ruby on Rails の開発体験の良さを Rust でも再現しようとしています。 また、小さいサービスや個人開発に適したフルスタックフレームワークとして開発されているようです。 内部実装では、コントローラーやルーティングは Axum で実装されていたり、 ActiveRecord は SeaORM で実装されていたりするそうです。[2] Axum や SeaORM については、別の記事で触れているので良ければご覧ください！ Rust | Axum と

コンテナからホスト上のサービスにアクセスする コンテナから、ホスト上で起動しているサービスにアクセスする必要があったので、 備忘録として記事に残したいと思います。 ユースケース : ローカル環境でデバッグ中のサービスに、コンテナからアクセスしたい host.docker.internal を使用する ホスト上で内部の IP アドレスで名前解決できる、特定の DNS 名 host.docker.internal を使用することで、コンテナからホスト上のサービスにアクセスすることができます。

初めに よくNext.jsを使用する事があるのですが、最近プライベートでようやく気になっていたApp Routerを色々触ってみました。 そこで、Page Routerとの違いについて、気づいた点/学習した点をアウトプットしてみようと思います。 なお、公式には以下のように記載されており、App Routerを推奨しているようですね。 Before Next.js 13, the Pages Router was the main way to create routes in Next.js. It used an intuitive file-system router to map each file to a route. The Pages Router is still supported in newer versions of Next.js, but we recommen

API シナリオテストツール runn とは 今回は、API シナリオテストツールである runn について紹介します😉✨ runn の主な特徴 runn は Go 言語で実装されているツールで、主な特徴は以下です。 発音は「ラン エヌ」です。 シナリオベースのテストツールとして機能 Go 言語用のテストヘルパーパッケージとして機能 ワークフロー自動化ツールとして機能 以下をサポート： HTTP リクエスト gRPC リクエスト DB クエリ Chrome DevTools Protocol SSH/ローカルコマンド実行 HTTP リクエストテストに OpenAPI 文書に似た構文を使用 単一のバイナリファイル = CI （継続的インテグレーション）に適している 引用: k1LoW/runn: runn is a package/tool for running operations f

Ntex とは Ntex is a powerful, pragmatic, and extremely fast framework for composable networking services for Rust Ntexは、Rust向けのコンポーザブル・ネットワーキング・サービスのための、強力で実用的、そして非常に高速なフレームワークです。 公式ページでは、以下の 4 つの特徴が挙げられています。 Type Safe: 型安全であること Feature Rich: 豊富な機能を提供していること Extensible: 拡張可能であること Blazingly Fast: 驚くほど高速に動作すること 高速に動作することという部分に関して、 Web Framework Benchmarks Round 22 で以下のランクを獲得しています。 第 3 位: ntex [sailfish

はじめに 開発に集中するために、お手軽に使えるDBを探したところ、 NeonというサーバーレスのフルマネージドPostgresサービスを見つけました。 触ってみたので記事にしたいと思います。 Neonの特徴 数秒でセットアップできる! ブランチ機能 ブラウザでデータが見れる。 しかし、この後にも書きますが、一番近いリージョンがシンガポールになります😭 NeonでDBをセットアップする Neonのサイトに、サインインします。 サインインしましたら、「Create a project」をクリックします 「Name」「Postgres version」「Region」を入力して 「Create project」をクリックします。 以上でDBのセットアップ完了です👍 あとはDBにインターネット経由で接続します。 Neonは、接続にSSLを必須にすることでセキュリティを守るという考え方だそうです

TypeORM の date は Date ではなかった TypeORM で以下のような Entity を定義します。 birthday なので、日付と時刻を表す timestamp ではなく、日付のみを表す date をデータベース上の型としています。 @Entity('users') export class User extends BaseEntity { @Column({ name: "name" }) public name: string; @Column({ name: "birthday", type: "date" }) public birthday: Date; }

イミュータブルデータモデリング Q. イミュータブルデータモデリングについて教えてください。 A. 以下、ChatGPT の回答です。 イミュータブルデータモデリング（Immutable Data Modeling）は、データモデリングのアプローチの一つで、データを不変（変更不可）な形式で扱う方法です。このアプローチでは、データが一度生成されたら、その値を変更せず、新しいバージョンを作成することが一般的です。イミュータブルデータモデリングは、分散システム、バージョン管理、データの整合性、履歴のトラッキングなどのさまざまな領域で有用です。 以下は、イミュータブルデータモデリングの主要な特徴と利点です。 データの安定性と信頼性: データが不変であるため、一度データが記録されたら、それを変更することができないため、データの信頼性と安定性が向上します。これは、エラーやバグがデータを破損させる可能性

はじめに 先日クラスメソッドさん主催のDevelopersIO 2023に参加してきました！ どれも聞き応えのあるセッションで大変勉強になりました。 その中でLlamaIndexというライブラリを利用して、ChatGPTに独自データを付与するセッションがあり、ChatGPTのAPI初心者である自分でもできそうだったのと、面白そうだなと思ったのでやってみました！ LlamaIndexとは LlamaIndexは、大規模言語モデル（LLM） と外部データを接続するためのインターフェースを提供します。LlamaIndex を使うと、自分の持っているデータをLLMに組み込んで、質問があった際はこのデータを参照しつつ返答を返すことができます。 パッケージのインストール Pythonで以下のパッケージをインストールします。 今回はPDFから独自データを読み取るためpypdfもインストールします。 読み

AWS を利用して静的な Web コンテンツを配信する方法として CloudFront + S3 の構成をよくとります。 構成方法は開発ガイド「安全な静的ウェブサイトの使用開始」や 巷の記事 が参考になります。 CloudFront のポテンシャルを十分に引き出すために、S3オリジンのキャッシュを存分に利かせて「爆速だー！ヒャッハー！」しようとしたら・・・ S3 に置いたファイルを上書きしても直ぐに反映してくれない。 ﾏｼﾞﾃﾞｽｶ… トラップカードの存在に気づきます。 とりあえず反映する方法 手作業で済む範囲で、すぐにキャッシュを更新したい場合は大まかに2通り。 キャッシュを無効にする CloudFront のビヘイビア設定にあるキャッシュポリシーを無効(Managed-CachingDisabled)に変更する方法です。まごうことなき急しのぎな回避策です。 応答パフォーマンスは確実に落

はじめに 煽りから入るパターンで書き始めます。ケニーです。 なんとなくテストの重要性は頭で分かってはいるものの、後回しにしてしまう事ってないですか？ 最近の私は業務でテストに関わる事が多く、学びも非常に多いので、複数回に分けてアウトプットしてみようと思います。 第一回目はテスト駆動開発についてです。 テスト駆動開発とは 【テストケースから書いて、実装していく手法】 で、 Test-Driven Development：TDDと略して記載するケースが多いです。 例）テストを書かずに、実装をした場合 数か月後にコードの修正をしたら、すべて正しく動作している事を保証できますか？ 他にデグレは無いと断言できますか？ 修正や機能追加する度に、すべての動作を手動で確認しないといけませんか？ メリット 後に上記のような課題に直面する前に、手を打っておきましょう。というのが今回の手法。 テストコードがある

今回は、私が何度も挑戦しつづけて失敗してきた「RSSリーダーを利用した情報収集」を遂に成功したので紹介させていただきます！ 失敗してきた理由 RSSリーダーを使ったことがある方にとっては、あるあるな話だとは思っているのですが、失敗してしまった主な理由は以下の通りです。 未読記事が貯まり続けた結果、使い続けるのが嫌になった。 自分にとって興味のない情報が入って来る場合があり、次第に情報の取捨選択が面倒になった。 外部サービスと連携しすぎていたら、各デバイスでサービスにログインするのが面倒になった。 要するに私は面倒くさがりなんです…🫠 ですが、RSS リーダー「inoreader」のプロプランを利用してみたところ、 こんな面倒くさがりの私でも、情報収集を習慣化できたので「inoreader」の推しポイントを紹介させていただきます！ 「inoreader」の推しポイント inoreader

はじめに 普段VSCodeを利用しているのですが、複数のプロジェクトを並行して進めている場合にワークスペースの切り替えが地味に面倒だなと感じていました。。 何か簡単に切り替えれる方法はないかと調べていたところ、VSCodeの拡張機能「Workspace Explorer」がよさげだったので試してみました！ 事前準備 VSCodeの ファイル > 名前を付けてワークスペースを保存 から各プロジェクトのワークスペースを作成し、1つのフォルダにまとめて保存しておきます。 設定方法 拡張機能のインストール VSCodeの拡張機能から「Workspace Explorer」で検索し、インストールします。 拡張機能の設定 VSCodeの ファイル > ユーザー設定 > 設定 を開き、設定の検索から「workspaceExplorer.workspaceStorageDirectory」を入力します。

この記事について ここ 3 週間ほど仕事で Box API について調査する機会をいただきました。この記事では Box API の基本的な使い方を中心に調査で得られた知見を共有したいと思います。また、Box API を使う上での注意点やトラブルシューティングの方法についても言及します。この記事が Box API を使ったプロジェクトや開発に役立てば幸いです。 Box とは何か？ Box はクラウド上でファイルを管理・共有するためのオンラインストレージサービスであり、企業向けのプラットフォームとして有名です。Dropbox や Google Drive など類似サービスと比較すると企業向けの機能が充実しており、セキュリティ面でも優れています。 Box を利用することでユーザーはファイルをオンライン上で保存し、必要な場合には共有することができます。また、Box のユーザーはパソコン・スマートフ

初めまして！ なるおと申します！ 初めてのZenn記事です！ 今回はYOLOというライブラリを使って、画像内のオブジェクト検出と座標取得をしてみたいと思います！ ↓こんなの YOLOって？ 画像や映像ストリーム内のオブジェクト検出アルゴリズムです。 You Only Look Onceの頭文字をとっており、人間と同じく、一目見たら物体検出できるという意味らしいです。 YOLOには複数のバージョンがあり、2023/04/23現在で v8となっています。 本記事の前提 YOLO CLIもpipを使ってインストールするため、Pythonのインストールは必須ですね。 Pythonのインストールについては、他のサイトを参考にお願いします。 YOLO CLIの使用 YOLO CLIは、ノーコーディングでYOLOのタスクを簡単に実行できるので、YOLOでどんなことをできるのか試したり、訓練したりなどがお