OpenAPI

はじめに 本記事では RSpec の request spec から OpenAPI 仕様のドキュメントを出力する Gem、rspec-openapi を紹介します。 ドキュメンテーションツール導入にあたっての負担を少なくしたい、実装とドキュメントが乖離しないようにしたい、という場合に参考になるかもしれません。 背景 これまで弊社では、 API ドキュメントは社内 wiki に蓄積されていました。 最初はこれでも問題にならなかったのですが、機能が増えてきたことによってドキュメントの数も増えて管理が難しくなったり、 フォーマットが明確でないので書く人によってばらつきがあるという問題がちらほら出て…

OpenAPI の定義ファイルの作成と管理のためのツールを探していて、Stoplight Studio が良いと聞いたので試してみることにしました。 stoplight.io Stoplight Studio Stoplight Studio の触れ込み Next gen editor for API design & technical docs (API設計と技術文書のための次世代エディタ) Design APIs 10x faster with our free OpenAPI editor. Prototype and share your API within minutes. 無料…

Red Hat で Solution Architect として Quarkus を担当している伊藤ちひろ（@chiroito）です。 この記事は、Quarkus.io のブログ記事、Quarkus 1.10 released - JSON as default, Multiple reactive datasources, new Micrometer registries... の翻訳記事です。 リリースされたばかりの Quarkus 1.10.2.Final には、多くの改善と新機能が搭載されています。 デフォルトのメディアタイプが JSON になりました CodeStarts はデフォ…

×344 3連休明けの12日 全国的に悪天候 電力需給厳しさ続く 節電を | 気象 | NHKニュース ×83 電力会社・電力使用状況グラフ | エレクトリカル・ジャパン - 発電所マップと夜景マップから考える日本の電力問題 ×79 Masters Alumni | Stanford Computer Science ×77 GitHub - theseus-os/Theseus: A modern experimental OS written from scratch in Rust to explore novel OS structure and state management te…

2020 年振り返りを簡単にまとめました。 知人向けの近況報告のつもりです。 OSS 活動とかは、さすがに書き出すと細かい感想がどんどん出てくることに気づいたので 来年以降は別にまとめるとかしてもっとコンパクトな記事にしたいと、書きながら思いました。 特に同業者向けというつもりでもなかったので。 私生活 コロナの影響 リモートワークが常態化するにつれて、UberEats で朝はスタバ、昼はいきなりステーキの生活に違和感がなくなってきました。 同人イベント（コミケなど）がすべてなくなったので、それらのお手伝い業務も今年はありませんでした。 2, 3, 4 月は NYTimes などの詳細なコロナ…

今週は「良い」OpenAPI Documentについて考えている。 「良い」というのはどういうことなのかが分かっていない。 例えば細野ら*1はOpenAPI Documentとその実装にずれがあることをあげている。 本来的には仕様書であるOpenAPI Documentと実装がずれているのであれば、実装誤りのはずですが、現実的には実装が正でOpenAPI Documentの定義が誤りということが多いように思う。 つまりこのような状態にあるOpenAPI Documentとは「良く無い」OpenAPI Documentなのだろうと思う。 悪い理由は言いやすいけど、逆に良いOpenAPI Docu…

3連休初日。めちゃくちゃ寒いし緊急事態宣言なので、引きこもって本を読んだ。 2020年は、技術書を読んでもブログに書くのをサボっていた。書く時間が無駄という説もあるが、すぐに利用する領域でもないかぎり、読んだら次の日にはすべて忘れている。 なんらかアウトプットしておくと少なくともあとで見返せるし多少は整理できるので、久しぶりにメモをとりながら読んだ。ので、ブログに残す。 www.shoeisha.co.jp 社内向けの単機能なAPIとか、特定の外部サービスから叩く用のWebフックAPIはつくったことあるけど、もう少し広めのドメインかつ実環境に公開するWeb APIを0からつくったことがない。 …

TorchServeとは アーキテクチャ メリット 事前準備 利用データ インストール TorchServe実践 モデル作成 デプロイ 推論リクエスト まとめ TorchServeとは TorchServeはPytorchで構築したモデルをサービングするためのモデルサービングライブラリです． AWSとFacebookが連携して開発しているため，Pytorchのコミュニティと共に今後の発展が期待できます．また，GithubのスターもTensorflow Servingの4515と比べると見劣りしますが，2020年12月時点で1464と様々な人から注目されていることが分かります． また，AWSとの…

今年も一年が終わるということで今年も振り返ってみる。 今年の振り返り アウトプット BLOG BLOGは、今年1年で59記事書いてました📝 1週間に1.2記事ぐらい書いてるので、そこそこ書いてた✍ また月間PV数は4000弱くらいでした、別にPVは気にしてないですが、ほぼトラフィックがGoogle経由なので、毎月そこそこ誰かしらの検索結果に表示されていると思うと、感慨深いものがありますね🍵 Webサービスとかツール 今思い返すとgemとかwebサービスとか結構作って公開してた・・・！ github.com github.com github.com github.com github.com …

2020年が終わる前に今年学んだ技術などの振り返りや今後やりたいことなどをまとめてみたいと思います。 フロントエンド 言語 JavaScript・TypeScript(TSがほぼメイン) JavaScriptはほぼ書いたことがない・TypeScriptは全くの未経験という感じでしたが、良い書籍・サービスのおかげで なんとかキャッチアップできました。 www.oreilly.co.jp www.udemy.com TypeScriptの型はとても柔軟で素晴らしいと思うのですが、コードを書く側の頭も柔軟じゃないと全然使いこなせそうにないなという感じでした。 なんとか良い感じにTypeScriptの…

毎年この方法を調べている気がするが、今年はGithub CLIがGraphQL APIの呼び出しをサポートしたようなので、コレを使って出力してみることにする1。GraphQL自体を試したい場合には、 https://docs.github.com/en/free-pro-team@latest/graphql/overview/explorer のあたりを参考にして試行錯誤してみれば良い。 利用例は以下のような形。 --paginate をつけると、いい感じに100件以上になったときもページネーションして取ってきてくれる。必要なら引数を渡せる。 $ gh api graphql --pagin…

フリーランスになってからは毎年書いているので、今年も 1 年の振り返りをしておきます。今年はコロナの影響で正直どうなるか想像つきませんでしたが、仕事的な面では去年より忙しかった感がありますね。来年は今年を踏襲しつつも App Service / Azure Functions と Cosmos DB など、マネージドサービスを色々組み合わせたサーバーレスのアーキテクチャをもっと突き詰めていきたいと考えています。もちろん OSS 方面での活動やブログへの投稿も継続的に行っていくつもりです。 5 年目も無事生き延びることが出来た ここ数年は生き延びることが出来たというのは比喩ではなく、病気的な意味…

2020年、自分がどういったテーマについてどれだけインプット, アウトプットしたのかを振り返っていく。 2020年で読んだ本 今年は以下の本を読んだ。 他にも何冊か読んだが、記憶にあまり残っていないので割愛。 リファクタリング 既存のコードを安全に改善する（第2版） | Ohmsha ドメイン駆動設計入門 ボトムアップでわかる！ドメイン駆動設計の基本（成瀬 允宣）｜翔泳社の本 ［試して理解］Linuxのしくみ ～実験と図解で学ぶOSとハードウェアの基礎知識：書籍案内｜技術評論社 O'Reilly Japan - コンピュータシステムの理論と実装 １８歳の著作権入門 / 福井 健策【著】 - 紀…