{"id":423897,"date":"2024-12-03T23:41:20","date_gmt":"2024-12-03T15:41:20","guid":{"rendered":"https:\/\/www.idc.net\/help\/423897\/"},"modified":"2024-12-03T23:41:20","modified_gmt":"2024-12-03T15:41:20","slug":"docker%e4%b8%8eswagger%e9%9b%86%e6%88%90%e5%ae%9e%e7%8e%b0api%e6%96%87%e6%a1%a3%e7%9a%84%e8%87%aa%e5%8a%a8%e7%94%9f%e6%88%90%e4%b8%8e%e7%ae%a1%e7%90%86","status":"publish","type":"post","link":"https:\/\/idc.net\/help\/423897\/","title":{"rendered":"Docker\u4e0eSwagger\u96c6\u6210\u5b9e\u73b0API\u6587\u6863\u7684\u81ea\u52a8\u751f\u6210\u4e0e\u7ba1\u7406"},"content":{"rendered":"<h1 id=\"docker%e4%b8%8eswagger%e9%9b%86%e6%88%90%e5%ae%9e%e7%8e%b0api%e6%96%87%e6%a1%a3%e7%9a%84%e8%87%aa%e5%8a%a8%e7%94%9f%e6%88%90%e4%b8%8e%e7%ae%a1%e7%90%86-hYUXRzxTau\">Docker\u4e0eSwagger\u96c6\u6210\u5b9e\u73b0API\u6587\u6863\u7684\u81ea\u52a8\u751f\u6210\u4e0e\u7ba1\u7406<\/h1>\n<p>\u5728\u73b0\u4ee3\u8f6f\u4ef6\u5f00\u53d1\u4e2d\uff0cAPI\uff08\u5e94\u7528\u7a0b\u5e8f\u7f16\u7a0b\u63a5\u53e3\uff09\u626e\u6f14\u7740\u81f3\u5173\u91cd\u8981\u7684\u89d2\u8272\u3002\u968f\u7740\u5fae\u670d\u52a1\u67b6\u6784\u7684\u666e\u53ca\uff0cAPI\u7684\u6570\u91cf\u4e0d\u65ad\u589e\u52a0\uff0c\u5982\u4f55\u9ad8\u6548\u5730\u7ba1\u7406\u548c\u6587\u6863\u5316\u8fd9\u4e9bAPI\u6210\u4e3a\u4e86\u5f00\u53d1\u8005\u9762\u4e34\u7684\u4e00\u5927\u6311\u6218\u3002Docker\u548cSwagger\u7684\u7ed3\u5408\u4e3a\u8fd9\u4e00\u95ee\u9898\u63d0\u4f9b\u4e86\u6709\u6548\u7684\u89e3\u51b3\u65b9\u6848\u3002\u672c\u6587\u5c06\u63a2\u8ba8\u5982\u4f55\u901a\u8fc7Docker\u4e0eSwagger\u96c6\u6210\uff0c\u5b9e\u73b0API\u6587\u6863\u7684\u81ea\u52a8\u751f\u6210\u4e0e\u7ba1\u7406\u3002<\/p>\n<h2 id=\"%e4%bb%80%e4%b9%88%e6%98%afdocker%ef%bc%9f-hYUXRzxTau\">\u4ec0\u4e48\u662fDocker\uff1f<\/h2>\n<p>Docker\u662f\u4e00\u79cd\u5f00\u6e90\u7684\u5bb9\u5668\u5316\u5e73\u53f0\uff0c\u5141\u8bb8\u5f00\u53d1\u8005\u5c06\u5e94\u7528\u7a0b\u5e8f\u53ca\u5176\u4f9d\u8d56\u9879\u6253\u5305\u5230\u4e00\u4e2a\u8f7b\u91cf\u7ea7\u7684\u5bb9\u5668\u4e2d\u3002\u5bb9\u5668\u53ef\u4ee5\u5728\u4efb\u4f55\u652f\u6301Docker\u7684\u73af\u5883\u4e2d\u8fd0\u884c\uff0c\u786e\u4fdd\u4e86\u5e94\u7528\u7a0b\u5e8f\u7684\u4e00\u81f4\u6027\u548c\u53ef\u79fb\u690d\u6027\u3002Docker\u7684\u4e3b\u8981\u4f18\u52bf\u5305\u62ec\uff1a<\/p>\n<ul>\n<li>\u73af\u5883\u4e00\u81f4\u6027\uff1a\u65e0\u8bba\u5728\u5f00\u53d1\u3001\u6d4b\u8bd5\u8fd8\u662f\u751f\u4ea7\u73af\u5883\u4e2d\uff0cDocker\u5bb9\u5668\u90fd\u80fd\u63d0\u4f9b\u76f8\u540c\u7684\u8fd0\u884c\u73af\u5883\u3002<\/li>\n<li>\u8d44\u6e90\u9694\u79bb\uff1a\u6bcf\u4e2a\u5bb9\u5668\u90fd\u662f\u72ec\u7acb\u7684\uff0c\u907f\u514d\u4e86\u4e0d\u540c\u5e94\u7528\u4e4b\u95f4\u7684\u76f8\u4e92\u5e72\u6270\u3002<\/li>\n<li>\u5feb\u901f\u90e8\u7f72\uff1a\u5bb9\u5668\u7684\u542f\u52a8\u901f\u5ea6\u6781\u5feb\uff0c\u80fd\u591f\u663e\u8457\u63d0\u9ad8\u5f00\u53d1\u548c\u90e8\u7f72\u7684\u6548\u7387\u3002<\/li>\n<\/ul>\n<h2 id=\"%e4%bb%80%e4%b9%88%e6%98%afswagger%ef%bc%9f-hYUXRzxTau\">\u4ec0\u4e48\u662fSwagger\uff1f<\/h2>\n<p>Swagger\u662f\u4e00\u5957\u7528\u4e8eAPI\u6587\u6863\u751f\u6210\u548c\u7ba1\u7406\u7684\u5de5\u5177\u96c6\u3002\u5b83\u5141\u8bb8\u5f00\u53d1\u8005\u901a\u8fc7\u7b80\u5355\u7684\u6ce8\u91ca\u548c\u914d\u7f6e\u6587\u4ef6\uff0c\u81ea\u52a8\u751f\u6210API\u6587\u6863\u3002Swagger\u7684\u4e3b\u8981\u7279\u70b9\u5305\u62ec\uff1a<\/p>\n<ul>\n<li>\u53ef\u89c6\u5316\u754c\u9762\uff1aSwagger UI\u63d0\u4f9b\u4e86\u4e00\u4e2a\u53cb\u597d\u7684\u7528\u6237\u754c\u9762\uff0c\u65b9\u4fbf\u5f00\u53d1\u8005\u548c\u7528\u6237\u67e5\u770b\u548c\u6d4b\u8bd5API\u3002<\/li>\n<li>\u81ea\u52a8\u5316\u6587\u6863\u751f\u6210\uff1a\u901a\u8fc7\u6ce8\u91ca\u548c\u914d\u7f6e\uff0cSwagger\u80fd\u591f\u81ea\u52a8\u751f\u6210API\u6587\u6863\uff0c\u51cf\u5c11\u4e86\u624b\u52a8\u7ef4\u62a4\u7684\u5de5\u4f5c\u91cf\u3002<\/li>\n<li>\u652f\u6301\u591a\u79cd\u8bed\u8a00\uff1aSwagger\u652f\u6301\u591a\u79cd\u7f16\u7a0b\u8bed\u8a00\uff0c\u9002\u7528\u4e8e\u4e0d\u540c\u7684\u5f00\u53d1\u73af\u5883\u3002<\/li>\n<\/ul>\n<h2 id=\"docker%e4%b8%8eswagger%e7%9a%84%e9%9b%86%e6%88%90-hYUXRzxTau\">Docker\u4e0eSwagger\u7684\u96c6\u6210<\/h2>\n<p>\u5c06Docker\u4e0eSwagger\u7ed3\u5408\u4f7f\u7528\uff0c\u53ef\u4ee5\u5b9e\u73b0API\u6587\u6863\u7684\u81ea\u52a8\u751f\u6210\u4e0e\u7ba1\u7406\u3002\u4ee5\u4e0b\u662f\u5b9e\u73b0\u8fd9\u4e00\u96c6\u6210\u7684\u57fa\u672c\u6b65\u9aa4\uff1a<\/p>\n<h3 id=\"%e6%ad%a5%e9%aa%a4%e4%b8%80%ef%bc%9a%e5%88%9b%e5%bb%badockerfile-hYUXRzxTau\">\u6b65\u9aa4\u4e00\uff1a\u521b\u5efaDockerfile<\/h3>\n<p>\u9996\u5148\uff0c\u9700\u8981\u521b\u5efa\u4e00\u4e2aDockerfile\uff0c\u5b9a\u4e49\u5e94\u7528\u7a0b\u5e8f\u7684\u73af\u5883\u548c\u4f9d\u8d56\u9879\u3002\u4ee5\u4e0b\u662f\u4e00\u4e2a\u7b80\u5355\u7684Dockerfile\u793a\u4f8b\uff1a<\/p>\n<pre><code>FROM openjdk:8-jdk-alpine\nVOLUME \/tmp\nCOPY target\/myapp.jar app.jar\nENTRYPOINT [\"java\",\"-jar\",\"\/app.jar\"]<\/code><\/pre>\n<h3 id=\"%e6%ad%a5%e9%aa%a4%e4%ba%8c%ef%bc%9a%e6%b7%bb%e5%8a%a0swagger%e4%be%9d%e8%b5%96-hYUXRzxTau\">\u6b65\u9aa4\u4e8c\uff1a\u6dfb\u52a0Swagger\u4f9d\u8d56<\/h3>\n<p>\u5728\u9879\u76ee\u7684\u6784\u5efa\u6587\u4ef6\u4e2d\uff08\u5982Maven\u6216Gradle\uff09\uff0c\u6dfb\u52a0Swagger\u7684\u4f9d\u8d56\u9879\u3002\u4f8b\u5982\uff0c\u5728Maven\u4e2d\uff0c\u53ef\u4ee5\u5728pom.xml\u4e2d\u6dfb\u52a0\u4ee5\u4e0b\u5185\u5bb9\uff1a<\/p>\n<pre><code>&lt;dependency&gt;\n    &lt;groupId&gt;io.springfox&lt;\/groupId&gt;\n    &lt;artifactId&gt;springfox-swagger2&lt;\/artifactId&gt;\n    &lt;version&gt;2.9.2&lt;\/version&gt;\n&lt;\/dependency&gt;\n&lt;dependency&gt;\n    &lt;groupId&gt;io.springfox&lt;\/groupId&gt;\n    &lt;artifactId&gt;springfox-swagger-ui&lt;\/artifactId&gt;\n    &lt;version&gt;2.9.2&lt;\/version&gt;\n&lt;\/dependency&gt;<\/code><\/pre>\n<h3 id=\"%e6%ad%a5%e9%aa%a4%e4%b8%89%ef%bc%9a%e9%85%8d%e7%bd%aeswagger-hYUXRzxTau\">\u6b65\u9aa4\u4e09\uff1a\u914d\u7f6eSwagger<\/h3>\n<p>\u5728\u5e94\u7528\u7a0b\u5e8f\u4e2d\u914d\u7f6eSwagger\uff0c\u4ee5\u4fbf\u81ea\u52a8\u751f\u6210API\u6587\u6863\u3002\u4ee5\u4e0b\u662f\u4e00\u4e2a\u7b80\u5355\u7684\u914d\u7f6e\u793a\u4f8b\uff1a<\/p>\n<pre><code>@Configuration\n@EnableSwagger2\npublic class SwaggerConfig {\n    @Bean\n    public Docket api() {\n        return new Docket(DocumentationType.SWAGGER_2)\n                .select()\n                .apis(RequestHandlerSelectors.any())\n                .paths(PathSelectors.any())\n                .build();\n    }\n}<\/code><\/pre>\n<h3 id=\"%e6%ad%a5%e9%aa%a4%e5%9b%9b%ef%bc%9a%e6%9e%84%e5%bb%ba%e5%92%8c%e8%bf%90%e8%a1%8cdocker%e5%ae%b9%e5%99%a8-hYUXRzxTau\">\u6b65\u9aa4\u56db\uff1a\u6784\u5efa\u548c\u8fd0\u884cDocker\u5bb9\u5668<\/h3>\n<p>\u5b8c\u6210\u4e0a\u8ff0\u6b65\u9aa4\u540e\uff0c\u53ef\u4ee5\u4f7f\u7528\u4ee5\u4e0b\u547d\u4ee4\u6784\u5efa\u548c\u8fd0\u884cDocker\u5bb9\u5668\uff1a<\/p>\n<pre><code>docker build -t myapp .\ndocker run -p 8080:8080 myapp<\/code><\/pre>\n<p>\u8fd0\u884c\u540e\uff0c\u53ef\u4ee5\u901a\u8fc7\u8bbf\u95ee <code>http:\/\/localhost:8080\/swagger-ui.html<\/code> \u6765\u67e5\u770b\u81ea\u52a8\u751f\u6210\u7684API\u6587\u6863\u3002<\/p>\n<h2 id=\"%e6%80%bb%e7%bb%93-hYUXRzxTau\">\u603b\u7ed3<\/h2>\n<p>\u901a\u8fc7\u5c06Docker\u4e0eSwagger\u96c6\u6210\uff0c\u5f00\u53d1\u8005\u53ef\u4ee5\u5b9e\u73b0API\u6587\u6863\u7684\u81ea\u52a8\u751f\u6210\u4e0e\u7ba1\u7406\uff0c\u6781\u5927\u5730\u63d0\u9ad8\u4e86\u5f00\u53d1\u6548\u7387\u548c\u6587\u6863\u7684\u51c6\u786e\u6027\u3002\u8fd9\u79cd\u65b9\u6cd5\u4e0d\u4ec5\u7b80\u5316\u4e86\u6587\u6863\u7ef4\u62a4\u7684\u8fc7\u7a0b\uff0c\u8fd8\u786e\u4fdd\u4e86API\u7684\u4e00\u81f4\u6027\u548c\u53ef\u7528\u6027\u3002\u5bf9\u4e8e\u9700\u8981\u9ad8\u6548\u7ba1\u7406API\u7684\u56e2\u961f\u6765\u8bf4\uff0c\u8fd9\u79cd\u96c6\u6210\u65e0\u7591\u662f\u4e00\u4e2a\u7406\u60f3\u7684\u89e3\u51b3\u65b9\u6848\u3002<\/p>\n<p>\u5982\u679c\u60a8\u6b63\u5728\u5bfb\u627e\u9ad8\u6027\u4ef7\u6bd4\u7684\u4e91\u670d\u52a1\u89e3\u51b3\u65b9\u6848\uff0c\u540e\u6d6a\u4e91\u63d0\u4f9b\u591a\u79cd\u9009\u62e9\uff0c\u5305\u62ec<a href=\"https:\/\/idc.net\">\u9999\u6e2fvps<\/a>\u3001<a href=\"https:\/\/idc.net\">\u7f8e\u56fd\u670d\u52a1\u5668<\/a>\u7b49\uff0c\u6ee1\u8db3\u4e0d\u540c\u7528\u6237\u7684\u9700\u6c42\u3002\u4e86\u89e3\u66f4\u591a\u4fe1\u606f\uff0c\u8bf7\u8bbf\u95ee\u6211\u4eec\u7684<a href=\"https:\/\/idc.net\">\u7f51\u7ad9<\/a>\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u63a2\u7d22\u5982\u4f55\u901a\u8fc7Docker\u4e0eSwagger\u96c6\u6210\uff0c\u5b9e\u73b0API\u6587\u6863\u7684\u81ea\u52a8\u751f\u6210\u4e0e\u7ba1\u7406\uff0c\u63d0\u9ad8\u5f00\u53d1\u6548\u7387\u4e0e\u6587\u6863\u4e00\u81f4\u6027\u3002<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[202757],"tags":[],"class_list":["post-423897","post","type-post","status-publish","format-standard","hentry","category-docker"],"_links":{"self":[{"href":"https:\/\/idc.net\/help\/wp-json\/wp\/v2\/posts\/423897","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/idc.net\/help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/idc.net\/help\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/idc.net\/help\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/idc.net\/help\/wp-json\/wp\/v2\/comments?post=423897"}],"version-history":[{"count":0,"href":"https:\/\/idc.net\/help\/wp-json\/wp\/v2\/posts\/423897\/revisions"}],"wp:attachment":[{"href":"https:\/\/idc.net\/help\/wp-json\/wp\/v2\/media?parent=423897"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/idc.net\/help\/wp-json\/wp\/v2\/categories?post=423897"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/idc.net\/help\/wp-json\/wp\/v2\/tags?post=423897"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}