{"id":547,"date":"2020-06-06T20:13:32","date_gmt":"2020-06-06T11:13:32","guid":{"rendered":"http:\/\/snow-cat.net\/?p=547"},"modified":"2020-06-06T21:36:35","modified_gmt":"2020-06-06T12:36:35","slug":"swagger%e3%81%ae%e7%92%b0%e5%a2%83%e6%a7%8b%e7%af%89","status":"publish","type":"post","link":"https:\/\/snow-cat.net\/?p=547","title":{"rendered":"swagger\u306e\u74b0\u5883\u69cb\u7bc9"},"content":{"rendered":"

swagger\u306e\u30aa\u30f3\u30e9\u30a4\u30f3\u52c9\u5f37\u4f1a\u306b\u53c2\u52a0\u3057\u305f\u306e\u3067\u3001swagger\u306e\u8a2d\u5b9a\u3092\u53cd\u6620\u3057\u305f\u30e2\u30c3\u30af\u30b5\u30fc\u30d0\u3092\u7acb\u3066\u3066\u307f\u3088\u3046\u304b\u3068\u601d\u3044\u307e\u3059\u3002<\/p>\n

\u53c2\u52a0\u3057\u305f\u52c9\u5f37\u4f1a\u306f\u300c\u30b5\u30fc\u30d0\u30fc\u30b5\u30a4\u30c9\u30a8\u30f3\u30b8\u30cb\u30a2\u304b\u3089\u5b66\u3076”Swagger\u5165\u9580”<\/a><\/strong>\u300d\u3067\u3059\u3002swagger\u306e\u66f8\u304d\u65b9\u3068\u304b\u4f7f\u3044\u65b9\u304c\u308f\u304b\u308a\u3084\u3059\u304f\u3066\u3088\u304b\u3063\u305f\u3067\u3059\u3002<\/p>\n

\u4f7f\u7528\u3059\u308b\u6280\u8853<\/h2>\n

\u30a4\u30f3\u30d5\u30e9:firebase(CloudFunction)
\n\u8a00\u8a9e:JavaScript(node.js)
\n\u4f7f\u7528\u3059\u308b\u30e9\u30a4\u30d6\u30e9\u30ea:swagger-jsdoc, firebase-tools<\/p>\n

\u521d\u671f\u8a2d\u5b9a<\/h2>\n

\u307e\u305a\u306f\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u7528\u306e\u30c7\u30a3\u30ec\u30af\u30c8\u30ea\u3092\u4f5c\u3063\u3066firebase<\/span>\u3092\u8a2d\u5b9a\u3057\u307e\u3059\u3002(firebase<\/span>\u3067\u30ed\u30b0\u30a4\u30f3\u3057\u3066\u3044\u306a\u3044\u5834\u5408\u306f\u30ed\u30b0\u30a4\u30f3\u3057\u3066\u304f\u3060\u3055\u3044)
\nfirebase<\/span>\u3092\u521d\u671f\u5316\u3059\u308b\u969b\u306f\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u540d\u306a\u3069\u805e\u304b\u308c\u307e\u3059\u304c\u3001\u305d\u3053\u306f\u81ea\u5206\u306e\u597d\u307f\u306b\u3057\u3066\u304f\u3060\u3055\u3044\u3002<\/p>\n

mkdir swagger\u2028\r\ncd swagger\u2028\r\nfirebase init functions<\/pre>\n
\u6b21\u306b\u3001swagger<\/span>\u3092\u4f7f\u7528\u3059\u308b\u306e\u306b\u5fc5\u8981\u306a\u30e9\u30a4\u30d6\u30e9\u30ea\u3092\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u3057\u307e\u3059\u3002<\/p>\n
cd functions\u2028\r\nnpm install --save swagger-jsdoc firebase-tools<\/pre>\n
\u305d\u3046\u3057\u307e\u3057\u305f\u3089\u3001funtions\/index.js<\/span>\u306bswagger<\/span>\u3068\u7c21\u5358\u306a\u95a2\u6570\u3092\u8a18\u8f09\u3057\u3066\u3044\u304d\u307e\u3059\u3002<\/p>\n
\u9577\u304f\u306a\u308b\u3057\u3001\u30b3\u30fc\u30c9\u3092\u66f8\u304f\u306e\u304c\u30e1\u30a4\u30f3\u3067\u306f\u306a\u3044\u306e\u3067\u7701\u304d\u307e\u3059\u3002<\/p>\n
\u8a18\u8ff0\u3057\u305f\u3089\u3001\u30c7\u30d7\u30ed\u30a4\u3057\u307e\u3059\u3002<\/p>\n
cd project\r\nnpm install --save swagger-jsdoc firebase-tools<\/pre>\n
\u78ba\u8a8d\u306e\u305f\u3081\u3001\u30b3\u30f3\u30bd\u30fc\u30eb\u306b\u8868\u793a\u3055\u308c\u305f\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u306eURL<\/span>\u306b\u30a2\u30af\u30bb\u30b9\u3057\u3066\u3001\u5de6\u5074\u306e\u958b\u767a\u306e\u4e0b\u306b\u3042\u308bFunctions<\/span>\u3092\u958b\u304d\u307e\u3059\u3002<\/p>\n
\"\"<\/p>\n
\"\"<\/p>\n
\u3067\u304d\u305f\u3002<\/p>\n
\u78ba\u8a8d\u306e\u305f\u3081\u3001curl<\/span>\u3067\u53e9\u3044\u3066\u307f\u307e\u3059\u3002<\/p>\n
curl -X GET \"https:\/\/us-central1-snowcat-swagger.cloudfunctions.net\/getHealthcare?weight=68&height=177\" -H \"accept: application\/json\"<\/pre>\n
\u304a\u3063\u3051\u30fc\u3002<\/p>\n
git<\/span>\u306b\u30b3\u30df\u30c3\u30c8\u3057\u3066github<\/span>\u306b\u4e0a\u3052\u307e\u3059\u3002<\/p>\n
git init\u2028\r\ngit add -A\r\n\u2028git commit -m 'Initialize swagger project'\u2028\r\ngit remote add origin https:\/\/github.com\/snowcat-jp\/swagger.git\u2028\r\ngit push -u origin master<\/pre>\n
\u3064\u3044\u3067\u306bCI<\/span>\u3082\u8a2d\u5b9a\u3057\u307e\u3057\u3087\u3046\u3002\u3044\u3061\u3044\u3061\u30c7\u30d7\u30ed\u30a4\u3059\u308b\u306e\u3082\u9762\u5012\u3067\u3059\u3057\u3002<\/p>\n
CircleCI\u306e\u8a2d\u5b9a<\/span><\/h2>\n
\u81ea\u52d5\u3067\u6700\u65b0\u306e\u72b6\u614b\u306b\u3057\u305f\u3044\u306e\u3067\u3001CI\u74b0\u5883\u3092\u6574\u3048\u307e\u3059\u3002<\/p>\n
\u4eca\u56de\u306fCircleCI\u3092\u4f7f\u3044\u307e\u3059\u3002\u5404\u7a2e\u521d\u671f\u8a2d\u5b9a\u306f\u7701\u304d\u307e\u3059\u3002<\/p>\n
\u307e\u305a\u3001CircleCI<\/span>\u306b\u30ed\u30b0\u30a4\u30f3\u3057\u3066github<\/span>\u306e\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u3092\u8a2d\u5b9a\u3057\u307e\u3059\u3002<\/p>\n
\"\"<\/p>\n
\u6b21\u306b\u3001\u74b0\u5883\u5909\u6570\u3068\u3057\u3066FIREBASE_TOKEN\u3092\u8a2d\u5b9a\u3057\u307e\u3059\u3002<\/p>\n
\u53f3\u4e0a\u306e\u8a2d\u5b9a\u3092\u62bc\u4e0b\u3057\u305f\u3042\u3068\u3001\u5de6\u5074\u306eEnvironment Variables<\/span>\u304b\u3089\u8a2d\u5b9a\u3057\u307e\u3059\u3002<\/p>\n
\"\"<\/p>\n
\"\"<\/p>\n
\"\"<\/p>\n
FIREBASE_TOKEN<\/span>\u306e\u78ba\u8a8d\u306e\u4ed5\u65b9\u304c\u308f\u304b\u3089\u306a\u304b\u3063\u305f\u306e\u3067\u4ee5\u4e0b\u306e\u30b3\u30de\u30f3\u30c9\u3067\u969b\u30ed\u30b0\u30a4\u30f3\u3057\u3066\u78ba\u8a8d\u3057\u307e\u3057\u305f\u3002<\/p>\n
firebase login:ci<\/pre>\n
\"\"<\/p>\n
1\/\u304b\u3089\u59cb\u307e\u308b\u5974\u304cFIREBASE_TOKEN\u3067\u3059\u3002<\/p>\n
\u8a2d\u5b9a\u304c\u5b8c\u4e86\u3059\u308b\u3068\u3053\u3093\u306a\u72b6\u614b\u3067\u3059\u3002<\/p>\n
\"\"<\/p>\n
\u6b21\u306b\u3001\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u306bCircleCI<\/span>\u306e\u8a2d\u5b9a\u30d5\u30a1\u30a4\u30eb\u3092\u4f5c\u308a\u307e\u3059\u3002<\/p>\n
mkdir .circleci\r\n\u2028touch .circleci\/config.yml<\/pre>\n
\u30d5\u30a1\u30a4\u30eb\u3092\u8a18\u8ff0\u3057\u307e\u3059\u3002\u4eca\u56de\u306f\u3053\u3093\u306a\u611f\u3058\u3067\u3002<\/p>\n
version: 2\r\njobs:\r\n  deploy_dev:\r\n    docker:\r\n      - image: circleci\/node:14.1\r\n    steps:\r\n      - checkout\r\n      - run:\r\n          name: npm install\r\n          command: cd functions && npm install\r\n      - run:\r\n          name: deploy to Firebase Hosting\r\n          command: .\/functions\/node_modules\/.bin\/firebase deploy --token=$FIREBASE_TOKEN  --only functions\r\n\r\nworkflows:\r\n  version: 2\r\n  deploy_dev:\r\n    jobs:\r\n      - deploy_dev:\r\n          filters:\r\n            branches:\r\n              only: master # master\u30d6\u30e9\u30f3\u30c1\u306e\u307f\u5b9f\u884c\r\n<\/pre>\n
\u5b8c\u4e86\u3057\u305f\u3089\u3001github<\/span>\u306b\u4e0a\u3052\u307e\u3059\u3002<\/p>\n
git add .circleci\/config.yml\r\n\u2028git commit -m \"setting circleci\"\u2028\r\ngit push -u origin master<\/pre>\n
\u4f55\u5ea6\u304b\u5931\u6557\u3057\u307e\u3057\u305f\u304c\u3001\u8abf\u6574\u3046\u307e\u304f\u3044\u304d\u307e\u3057\u305fw<\/p>\n
\"\"<\/p>\n
CircleCI\u306e\u8a2d\u5b9a\u306fSPA\u3068\u304b\u3067\u3082\u6d41\u7528\u3067\u304d\u307e\u3059\u306d\u3002<\/p>\n
\u4eca\u56de\u306e\u30bd\u30fc\u30b9\u30b3\u30fc\u30c9\u306f\u3053\u3061\u3089<\/a><\/strong><\/p>\n
\u53c2\u8003<\/p>\n
Circle CI\u304b\u3089<\/span>Firebase Hosting\u306b\u81ea\u52d5\u30d3\u30eb\u30c9<\/span>&\u30c7\u30d7\u30ed\u30a4\u3059\u308b<\/span><\/strong><\/a><\/p>\n
 <\/p>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
swagger\u306e\u30aa\u30f3\u30e9\u30a4\u30f3\u52c9\u5f37\u4f1a\u306b\u53c2\u52a0\u3057\u305f\u306e\u3067\u3001swagger\u306e\u8a2d\u5b9a\u3092\u53cd\u6620\u3057\u305f\u30e2\u30c3\u30af\u30b5\u30fc\u30d0\u3092\u7acb\u3066\u3066\u307f […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[7],"tags":[],"class_list":["post-547","post","type-post","status-publish","format-standard","hentry","category-7"],"aioseo_notices":[],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/pattVc-8P","jetpack-related-posts":[{"id":1433,"url":"https:\/\/snow-cat.net\/?p=1433","url_meta":{"origin":547,"position":0},"title":"react\u3067firebase\u306e\u521d\u671f\u8a2d\u5b9a","author":"hiro","date":"2022\u5e747\u670821\u65e5","format":false,"excerpt":"\u6700\u8fd1react\u3067\u6a5f\u80fd\u3092\u4f5c\u3063\u3066\u3044\u308b\u306e\u3067\u3059\u304c\u3001firebase\u304c\u30d0\u30fc\u30b8\u30e7\u30f3\u306b\u3088\u3063\u3066\u7d50\u69cb\u5b9f\u88c5\u65b9\u6cd5\u304c\u9055\u3063\u3066\u82e6\u2026","rel":"","context":"firebase","block_context":{"text":"firebase","link":"https:\/\/snow-cat.net\/?cat=25"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":1435,"url":"https:\/\/snow-cat.net\/?p=1435","url_meta":{"origin":547,"position":1},"title":"firebase\u3067storage\u306b\u4fdd\u5b58\u3057\u3088\u3046\u3068\u3057\u305f\u6642\u306b\u51fa\u305f\u30a8\u30e9\u30fc\u306e\u5bfe\u51e6\u6cd5","author":"hiro","date":"2022\u5e747\u670821\u65e5","format":false,"excerpt":"\u6700\u8fd1\u3001react\u3067firebase\u3092\u4f7f\u3063\u305f\u958b\u767a\u3092\u3057\u3066\u3044\u308b\u306e\u3067\u3059\u304c\u3001storage\u306b\u753b\u50cf\u3092\u4fdd\u5b58\u3057\u3088\u3046\u3068\u2026","rel":"","context":"firebase","block_context":{"text":"firebase","link":"https:\/\/snow-cat.net\/?cat=25"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":447,"url":"https:\/\/snow-cat.net\/?p=447","url_meta":{"origin":547,"position":2},"title":"\u30dd\u30fc\u30c8\u30d5\u30a9\u30ea\u30aa\u3067\u4f7f\u7528\u3057\u305f\u6280\u8853","author":"hiro","date":"2020\u5e744\u670816\u65e5","format":false,"excerpt":"\u6628\u65e5\u30dd\u30fc\u30c8\u30d5\u30a9\u30ea\u30aa\u3092\u4f5c\u6210\u3057\u307e\u3057\u305f\u3002 \u73fe\u5728\u8ee2\u8077\u4e2d\u306a\u306e\u3067\u4f5c\u3063\u305f\u306e\u3082\u3042\u308a\u307e\u3059\u304c\u3001\u3082\u3068\u3082\u3068SPA\u3092\u4f5c\u308a\u305f\u304b\u3063\u2026","rel":"","context":"\u305d\u306e\u4ed6\u3082\u308d\u3082\u308d","block_context":{"text":"\u305d\u306e\u4ed6\u3082\u308d\u3082\u308d","link":"https:\/\/snow-cat.net\/?cat=1"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":246,"url":"https:\/\/snow-cat.net\/?p=246","url_meta":{"origin":547,"position":3},"title":"vue.js\u3092\u4e00\u304b\u3089\u8a2d\u5b9a\u3059\u308b","author":"hiro","date":"2019\u5e746\u670830\u65e5","format":false,"excerpt":"\u3053\u3093\u306b\u3061\u308f\u3001\u3086\u304d\u306d\u3053\u3067\u3059\u3002 \u6700\u8fd1vue.js\u306e\u74b0\u5883\u69cb\u7bc9\u3092\u884c\u306a\u3063\u3066\u3044\u305f\u306e\u3067\u9806\u756a\u3092\u307e\u3068\u3081\u3088\u3046\u3068\u601d\u3044\u307e\u3059\u3002\u2026","rel":"","context":"\u305d\u306e\u4ed6\u3082\u308d\u3082\u308d","block_context":{"text":"\u305d\u306e\u4ed6\u3082\u308d\u3082\u308d","link":"https:\/\/snow-cat.net\/?cat=1"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":959,"url":"https:\/\/snow-cat.net\/?p=959","url_meta":{"origin":547,"position":4},"title":"heroku\u306bdocker-compose\u3092\u4f7f\u3063\u3066Laravel\u88fd\u500b\u4eba\u30a2\u30d7\u30ea\u3092\u4f5c\u6210\u3059\u308b\u65b9\u6cd5","author":"hiro","date":"2021\u5e745\u67082\u65e5","format":false,"excerpt":"\u6700\u8fd1\u500b\u4eba\u30a2\u30d7\u30ea\u3092\u958b\u767a\u3057\u3066\u3044\u308b\u306e\u3067\u3059\u304c\u3001\u30a4\u30f3\u30d5\u30e9\u3069\u3046\u3057\u3088\u3046\u304b\u306a\u3068\u601d\u3063\u3066\u3068\u308a\u3042\u3048\u305aheroku\u3067\u884c\u3053\u3046\u3068\u2026","rel":"","context":"heroku","block_context":{"text":"heroku","link":"https:\/\/snow-cat.net\/?cat=21"},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/snow-cat.net\/wp-content\/uploads\/2021\/04\/%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88-2021-04-30-12.40.46.png?resize=350%2C200&ssl=1","width":350,"height":200,"srcset":"https:\/\/i0.wp.com\/snow-cat.net\/wp-content\/uploads\/2021\/04\/%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88-2021-04-30-12.40.46.png?resize=350%2C200&ssl=1 1x, https:\/\/i0.wp.com\/snow-cat.net\/wp-content\/uploads\/2021\/04\/%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88-2021-04-30-12.40.46.png?resize=525%2C300&ssl=1 1.5x, https:\/\/i0.wp.com\/snow-cat.net\/wp-content\/uploads\/2021\/04\/%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88-2021-04-30-12.40.46.png?resize=700%2C400&ssl=1 2x, https:\/\/i0.wp.com\/snow-cat.net\/wp-content\/uploads\/2021\/04\/%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88-2021-04-30-12.40.46.png?resize=1050%2C600&ssl=1 3x, https:\/\/i0.wp.com\/snow-cat.net\/wp-content\/uploads\/2021\/04\/%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88-2021-04-30-12.40.46.png?resize=1400%2C800&ssl=1 4x"},"classes":[]},{"id":1019,"url":"https:\/\/snow-cat.net\/?p=1019","url_meta":{"origin":547,"position":5},"title":"\u6b63\u3057\u304f\u66f8\u3053\u3046PHP\u306e\u95a2\u6570","author":"hiro","date":"2021\u5e745\u670813\u65e5","format":false,"excerpt":"\u6b63\u3057\u304f\u3063\u3066\u4f55\u304c\u6b63\u3057\u3044\u306d\u3093\u3063\u3066\u601d\u3044\u307e\u3059\u304c\u3001\u3068\u308a\u3042\u3048\u305aPHP\u3067\u5b9f\u88c5\u3059\u308b\u969b\u306b\u6c17\u3092\u3064\u3051\u3066\u3044\u308b\u70b9\u3092\u7d39\u4ecb\u3057\u307e\u3059\u3002\u2026","rel":"","context":"PHP","block_context":{"text":"PHP","link":"https:\/\/snow-cat.net\/?cat=20"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]}],"_links":{"self":[{"href":"https:\/\/snow-cat.net\/index.php?rest_route=\/wp\/v2\/posts\/547","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/snow-cat.net\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/snow-cat.net\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/snow-cat.net\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/snow-cat.net\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=547"}],"version-history":[{"count":20,"href":"https:\/\/snow-cat.net\/index.php?rest_route=\/wp\/v2\/posts\/547\/revisions"}],"predecessor-version":[{"id":575,"href":"https:\/\/snow-cat.net\/index.php?rest_route=\/wp\/v2\/posts\/547\/revisions\/575"}],"wp:attachment":[{"href":"https:\/\/snow-cat.net\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=547"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/snow-cat.net\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=547"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/snow-cat.net\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=547"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}