タグ

2019年1月25日のブックマーク (3件)

  • Flask-RESTPlusでREST APIとSwaggerドキュメントを統合 - Qiita

    はじめに この記事は Muroran Institute of Technology Advent Calendar 2017 25日目の記事です。 Flaskを使ってREST APIを作りたいときに、同時にドキュメントとしてSwaggerも整備したいこと、あると思います。しかしドキュメントも書きつつAPIも書くとどっちかを更新したときにどっちかを更新し忘れるなどして、だんだん面倒になってきてしまいがちです。 そこで今回は簡単なToDo管理APIを例に、Flask-RESTPlusを使ってAPI定義とSwaggerによるドキュメント生成を一気に行ってしまう方法をご紹介します。 Python環境の準備 とりあえずPython環境を準備しておきましょう。PyenvとVirtualenvを使ってさくさくっと作っていきます。仮想環境名はrestplusにしてありますが別に何でもかまいません。今回は

    Flask-RESTPlusでREST APIとSwaggerドキュメントを統合 - Qiita
  • 積極性と強い問題意識を要求する「振り返り」は、もうたくさん - Qiita

    Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? 「この人たちのために成長したい」といつも自分を駆り立ててくれる、大好きな職場のみなさんに稿は捧げます。 はじめに これからの人生で、チームで「振り返り」をする可能性が1%でもある方々に稿は贈らせていただきます。 皆さんの「振り返り」が行われる前にもう一度、読んでいただき、参考にしていただければ幸いです。 「振り返り」への違和感 「積極性」と「強い問題意識」を持ったメンバーがいることを前提とした方法論ばかりが叫ばれることに私は強い違和感を感じています。 その目的や背景は置いといて、「過去に起きた出来事をチームメンバーと共に目を向ける過

    積極性と強い問題意識を要求する「振り返り」は、もうたくさん - Qiita
  • Ansibleとは何か 構成管理ツールの目的〜Ansible導入まで最速で理解する - Qiita

    はじめに 記事は、構成管理ツールの目的〜Ansible導入まで最速で理解することを目標に、インフラエンジニアの観点でまとめました。 なお、文明が遅れているSI業界の片隅のシステムにおけるインフラ構築は大体こんな感じです。 【現状】 設計書を基に、パラメータシート(Excel)及び構築手順書(ExcelまたはWord)の作成 構築手順書を見ながら、構築作業の実施(※1) 運用開始後、設定変更が発生した場合は、パラメータシート(Excel)に変更履歴を記入 (※1)SI業界に構成管理ツールは存在しない。(同じSIでも使っているところはあると思うが、行政のようなレガシーシステムでは皆無)せいぜいテラタームでブロードキャストして、実行するコマンドを書いたスクリプト動かすだけ。あとは、confファイルなど必要資材は、WinSCPで送ったりする。 【問題点】 ドキュメント作成に時間がかかる(構築手順

    Ansibleとは何か 構成管理ツールの目的〜Ansible導入まで最速で理解する - Qiita