在IIS上部署Go API項目

Posted on by

問題場景

我這邊原先的技術棧主要是 .NET(Core), 所以服務器基本上都是 Windows Server + IIS.

這次有個 API 服務用 Go 重寫, 但是部署有點不美, 直接執行黑框框不好看, 也容易丟, 做成服務又不方便更新維護, 想著能不能繼續掛載在 IIS 下.

於是乎…

首先想到的是 IIS 下有個 FastCGI 支持, 以前還在 IIS 下部署過 PHP 項目.

搜到 Go 中有個 net/http/fcgi 庫, 寫個簡單服務驗證一下, 代碼如下:

package main

import (
	"net"
	"net/http"
	"net/http/fcgi"
)

func handler(resp http.ResponseWriter, req *http.Request) {
	resp.Write([]byte("hello"))
}

func main() {
	mux := http.NewServeMux()
	mux.HandleFunc("/", handler)

	l, err := net.Listen("tcp", ":0")
	if err != nil{
		panic(err)
	}
	err = fcgi.Serve(l, mux)
	if err != nil{
		panic(err)
	}
}

執行 go run main.go 命令後, 程序沒有任何異常或輸出直接就結束瞭…

資料搜瞭一圈看到這玩意基本已被遺忘在不知道哪個旮旯裡瞭…

然後搜到 Azure 前些年用 HttpPlatformHandler Module 在 IIS 上支持 Java/Node/… 應用程序.

試瞭下基本也是廢瞭.

解決方案

最後溜達瞭一圈, 發現 HttpPlatformHandler 已被 ASPNETCore Module 宿主模塊取代.

那麼就跟我們在 IIS 上部署 ASP.NET Core 應用程序一樣, 首先下載並安裝 ASP.NET Core Hosting Bundle, 瞭解更多可參閱 ASP.NET Core Module

然後新建對應的站點, 應用程序池調整成 無托管代碼

IIS 這邊已經準備就緒.

來看看我們代碼和配置

// main.go
package main

import (
	"fmt"
	"net"
	"net/http"
	"os"
)

func handler(w http.ResponseWriter, r *http.Request) {
	w.Write([]byte("Go running on IIS"))
}

func main() {
	mux := http.NewServeMux()
	mux.HandleFunc("/", handler)

	// 獲取由 ACNM 設置的環境變量
	port := "0" // default
	envPort := os.Getenv("ASPNETCORE_PORT")
	if envPort != "" {
		port = envPort
		fmt.Println("get env ASPNETCORE_PORT", port)
	}

	l, err := net.Listen("tcp", ":" + port)
	if err != nil{
		panic(err)
	}
	defer l.Close()
	fmt.Println("listening on", l.Addr().String())
	err = http.Serve(l, mux)
	if err != nil{
		panic(err)
	}
}

關鍵點就是代碼中要通過獲取 ACNM 提供的端口環境變量, 也就是 ASPNETCORE_PORT, 熟悉 ASP.NET Core 的小夥伴對這個應該不陌生瞭.

然後構建我們的可執行文件 xxx.exe

go build

然後配置 web.config 內容如下:

<!-- web.config -->
<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath=".\your.exe" arguments="" stdoutLogEnabled="true" stdoutLogFile=".\stdout" />
    </system.webServer>
  </location>
</configuration>

把 xxx.exe 和 web.config 扔到前面新建的站點中即可.

後續更新升級直接替換 exe 即可.

Go 寫的程序體積比較小, 構建後也隻有單個執行文件, 清爽多瞭.

最後來個效果圖

註意事項

如出現以下錯誤信息, 可能是端口號已被占用, 換個端口號試試

[ERROR] listen tcp :8080: bind: An attempt was made to access a socket in a way forbidden by its access permissions.

以上就是這篇文章的全部內容瞭，希望本文的內容對大傢的學習或者工作具有一定的參考學習價值，謝謝大傢對WalkonNet的支持。如果你想瞭解更多相關內容請查看下面相關鏈接

推薦閱讀：