はじめにこんにちは、Finatext で保険事業のプロダクト開発をしている @toshipon です。今回は以前の Fin-JAWS のイベントで少し紹介させていただいた、我々の現場で取り組んでいる、大規模API開発における Swagger を用いたAPI仕様のドキュメント運用方法について紹介いたします。 概要我々の現場では、API ベースのWeb Application を開発する際に、Swagger を用いて API 設計をしたり、BFFサーバー開発者やフロントエンド開発者とのコミュニケーション手段として活用しています。 ただし、Web Application の規模が大きくなってくると、Swagger の 定義ファイルは肥大化してしまい、メンテナンスが困難になってきます。 今回は、Web Application の規模が大きくなっても耐えうる Swagger 定義ファイルの運用方法を
本文の内容は、2021年3月9日にÁlvaro Iradierが投稿したブログ(https://sysdig.com/blog/dockerfile-best-practices/)を元に日本語に翻訳・再構成した内容となっております。 Dockerfileのベストプラクティスのクイックセットをイメージビルドに適用することで、セキュリティ問題を防ぎ、コンテナ化されたアプリケーションを最適化する方法を学びます。 コンテナ化されたアプリケーションやマイクロサービスに精通している人なら、自分のサービスがマイクロサービスであることに気づいているかもしれません。しかし、脆弱性の検出、セキュリティ問題の調査、デプロイ後の報告や修正など、管理のオーバーヘッドがマクロな問題になっています。 このオーバーヘッドの多くは、セキュリティをシフトレフトし、開発ワークフローの中で可能な限り早く潜在的な問題に取り組むこ
March 9, 2021Getting Started With Apollo Client in Next.js (Update May 2023) We published a library that makes it easier to use Apollo Client with Next.js 13, this guide still remains valid if you’re using the pages directory. Wait, you want me to put my data where!? Figuring out how to configure Apollo Client with Next.js can be a bit confusing. This confusion stems from the fact that there are t
先日「ドクセル」というサービスをリリースしたので技術的な振り返りをQiitaにも投稿します。 追記:Qiitaにドクセルの埋め込み機能が対応しました! モチベーション SlideShareが親会社をころころ変えるわりに中身が進化してなくてやる気ない SpeakerDeckが日本語のファイルをアップするとSlugを勝手に中国語読みにする なんか個人サービス作りたい 作ったもの https://www.docswell.com ドクセル と読ませるようにしている シンプルなスライド共有サービス Laravelベース 特徴 画質がいい(長辺1920px・Full HD相当のプロジェクターにも耐えうる) URL(Slug)をある程度自分で決めることができる マウスオーバーに頼らない(タッチデバイスを意識) アーキテクチャ アーキテクチャはこんな感じです。初期バージョンとしては、PHPなので共用サー
OpenAPI(Swagger)のAPI開発Docker環境を整備した(yaml分割編集、SwaggerUI表示、モックサーバー、静的HTML出力)JavaScript初心者swaggerフロントエンドOpenAPI はじめに OpenAPI(Swagger)でのAPI開発をプロジェクトで導入する際、 OpenAPIのyamlの書き方を覚えることよりも、 チーム開発するための最善の環境(ツール)選定に苦労したりします。 WEB上のSwaggerEditorを利用することや、 SwaggerHubというサービスを利用するという手もありますが、 いろいろとネックとなるところがあります。1 2 各自のローカルPCで各種ツールを利用できるような環境を作ってしまうのが便利かなと思い、 一式のツールをまとめたDocker環境を整備しました。 環境概要 完成品の環境コードはこちらに公開しています。 ht
今回、GASを記述する上でのガイドラインを作成しましたので、公開いたします。 また、自分が今後書いていく際の備忘録でもあります。 ガイドラインを作る背景 Google Workspaceを使っているところで勤務しており、各々が効率化でスクリプト(GAS)をかいたりしていたのですが、レビューとかはせずに好き勝手書いてる現状があります。 そのため、下記の2つのような問題があります。 保守性が悪い 同じ処理を他のスクリプトで1から作っている また、可読性を意識した開発を常にすることは技術の向上に繋がりますので、今回ガイドラインを作成します。 ガイドライン導入 目的 このガイドラインの目的は以下の3つです。 保守性の向上 可読性の向上 再利用可能なコード 保守性 バグは起こりうるものでしょう。完全にはなくせないかもしれません。そういったバグの対応は緊急性が高いにもかかわらず、fixするのに時間がか
facebook オフィス狛 技術部のHammarです。 node.jsを使った開発を行う時に、JavaScriptライブラリのパッケージマネージャーであるnpmを使いますが、このnpmにはプロジェクトの情報管理ファイルであるpackege.jsonがあります。 基本的なpackege.jsonの記載方法については割愛しますが、このpackege.json内にscriptsという記述を設定することによって、独自のコマンドを設定することができます。 これによって、例えばローカルサーバーの起動や停止等、良く使うコマンドを設定しておけば、いろいろコマンドを打たずに済むといった感じになります。 例えばAngularの開発では、package.jsonには下記のようにscriptsの記載したりします。 "scripts": { "start": "ng serve", "test": "ng tes
json-serverとは WebAPIを利用したアプリケーションを開発している時に、APIをモックで置き換えたい事があると思います。json-serverはJSON形式のレスポンスを返すモックサーバを、簡単に構築できるライブラリです。 json-server https://github.com/typicode/json-server インストール・起動方法 インストール方法 インストールにはnodejsが必要です。npmを使ったインストール方法は以下の通りです。 npm install —-save-dev json-server 起動方法 あらかじめ、以下のようなjsonファイルを準備しておきます。 作成したjsonファイルを指定してjson-serverを実行すると、キー名をエンドポイントとしてjsonを返却するサーバがlocalhostに起動します。 // end-point-
This converter is used to convert Excel (or other spreadsheets) into Markdown Table. Also API supported.
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く