溫馨提示×

linux swagger怎么安裝

小樊
103
2024-12-28 19:32:14
欄目: 智能運維

在 Linux 上安裝 Swagger,通常是指安裝 Swagger UI 和 Swagger Editor。以下是安裝步驟:

安裝 Swagger UI

  1. 更新包列表

    sudo apt update
    
  2. 安裝必要的依賴

    sudo apt install -y openjdk-11-jre-headless
    
  3. 下載 Swagger UI

    wget https://repo1.maven.org/maven2/io/springfox/springfox-swagger-ui/2.9.2/springfox-swagger-ui-2.9.2.html
    
  4. 解壓 Swagger UI

    unzip springfox-swagger-ui-2.9.2.html
    
  5. 移動解壓后的文件到 Web 服務目錄(例如 /var/www/html):

    sudo mv springfox-swagger-ui-2.9.2 /var/www/html/swagger-ui
    
  6. 配置 Swagger UI: 編輯 /var/www/html/swagger-ui/index.html 文件,找到以下行并進行修改:

    <script>
      window.onload = function() {
        // Begin Swagger UI call region
        const ui = SwaggerUIBundle({
          url: "http://petstore.swagger.io/v2/api-docs",
          dom_id: '#swagger-ui',
          deepLinking: true,
          presets: [
            SwaggerUIBundle.presets.apis,
            SwaggerUIStandalonePreset
          ],
          plugins: [
            SwaggerUIBundle.plugins.DownloadUrl
          ],
          layout: "StandaloneLayout"
        });
    
        // End Swagger UI call region
        window.ui = ui;
      };
    </script>
    
  7. 啟動 Web 服務器(例如 Apache 或 Nginx):

    • Apache
      sudo a2ensite default.conf
      sudo systemctl restart apache2
      
    • Nginx
      sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.bak
      sudo nano /etc/nginx/sites-available/default
      
      修改 server 塊中的 rootindex 指令:
      server {
          listen 80 default_server;
          listen [::]:80 default_server;
      
          root /var/www/html;
          index index.html index.htm;
      
          server_name _;
      
          location / {
              try_files $uri $uri/ =404;
          }
      }
      
      保存并退出編輯器,然后重啟 Nginx:
      sudo systemctl restart nginx
      

安裝 Swagger Editor

  1. 下載 Swagger Editor

    wget https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/3.50.0/swagger-editor.min.js
    wget https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/3.50.0/swagger-editor.min.css
    
  2. 移動文件到 Web 服務目錄(例如 /var/www/html):

    sudo mv swagger-editor.min.js /var/www/html/swagger-editor.js
    sudo mv swagger-editor.min.css /var/www/html/swagger-editor.css
    
  3. 創建一個簡單的 HTML 文件來加載 Swagger Editor

    sudo nano /var/www/html/swagger-editor.html
    

    添加以下內容:

    <!DOCTYPE html>
    <html>
    <head>
      <link rel="stylesheet" type="text/css" href="swagger-editor.css">
    </head>
    <body>
      <div id="swagger-editor"></div>
      <script src="swagger-editor.js"></script>
      <script>
        window.onload = function() {
          const editor = SwaggerEditor({
            url: "https://petstore.swagger.io/v2/api-docs",
            dom_id: '#swagger-editor'
          });
        };
      </script>
    </body>
    </html>
    
  4. 啟動 Web 服務器(例如 Apache 或 Nginx):

    • Apache
      sudo a2ensite default.conf
      sudo systemctl restart apache2
      
    • Nginx
      sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.bak
      sudo nano /etc/nginx/sites-available/default
      
      修改 server 塊中的 rootindex 指令:
      server {
          listen 80 default_server;
          listen [::]:80 default_server;
      
          root /var/www/html;
          index index.html index.htm;
      
          server_name _;
      
          location / {
              try_files $uri $uri/ =404;
          }
      }
      
      保存并退出編輯器,然后重啟 Nginx:
      sudo systemctl restart nginx
      

現在,你應該能夠通過瀏覽器訪問 http://your_server_ip/swagger-uihttp://your_server_ip/swagger-editor 來查看和使用 Swagger UI 和 Swagger Editor。

0
亚洲午夜精品一区二区_中文无码日韩欧免_久久香蕉精品视频_欧美主播一区二区三区美女