如何通過Swagger在Linux上實現API自動化測試

在Linux系統上，通過Swagger實現API自動化測試可以大大提高測試效率和準確性。以下是一個詳細的步驟指南：

1. 安裝和配置Swagger

使用Docker容器安裝Swagger

• 安裝Docker：如果你還沒有安裝Docker，請先安裝它?？梢詤⒖?a >Docker官方文檔進行安裝。
• 拉取Swagger鏡像：

  docker pull swaggerapi/swagger-editor:v4.6.0
  docker pull swaggerapi/swagger-ui:v4.15.5
  

• 運行Swagger容器：

  docker run -d -p 38080:8080 swaggerapi/swagger-editor:v4.6.0
  docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5
  

  這樣，你就可以通過訪問 http://localhost:38080 來使用Swagger Editor，通過訪問 http://localhost:38081 來使用Swagger UI。

手動安裝Swagger

• 安裝Node.js和npm：

  sudo apt update
  sudo apt install -y openjdk-11-jre-headless
  

• 下載并解壓Swagger Editor和Swagger UI：

  wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v4.6.0.tar.gz
  tar -xvf swagger-editor-4.6.0.tar.gz
  cd swagger-editor-4.6.0
  

• 啟動Swagger Editor：

  npm install
  nohup npm start &
  

• 訪問Swagger Editor：打開瀏覽器，訪問 http://your_server_ip:8080 即可使用Swagger Editor。

2. 生成測試腳本

• 使用Swagger Codegen生成測試腳本：

  curl https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.29/swagger-codegen-cli-2.4.29.jar --output swagger-codegen-cli-2.4.29.jar
  java -jar swagger-codegen-cli-2.4.29.jar generate -i swagger.json -l java -o my-test-project
  

  這將生成Java測試腳本。

3. 編寫自動化測試用例

• 使用Python和pytest進行自動化測試：
  • 安裝必要的庫：

    pip install requests pytest
    

  • 編寫測試用例：

    import requests
    import pytest
    
    BASE_URL = 'http://localhost:5000/api'
    
    def test_get_users():
        response = requests.get(f'{BASE_URL}/users')
        assert response.status_code == 200
        assert response.json() is not None
    
    def test_create_user():
        user_data = {
            "name": "John Doe",
            "email": "johndoe@example.com"
        }
        response = requests.post(f'{BASE_URL}/users', json=user_data)
        assert response.status_code == 201
        assert response.json()['name'] == "John Doe"
    

  • 運行測試用例：

    pytest test_api.py
    

4. 集成到持續集成工具（如Jenkins）

• 配置Jenkins：
  • 在Jenkins中新建一個項目。
  • 配置項目的構建步驟，運行自動化測試腳本。例如：

    pytest /path/to/your/test_api.py
    

通過以上步驟，你可以在Linux系統上成功部署Swagger，并使用Swagger進行API自動化測試，從而提高開發和測試效率。