在 Go 中導入 cert-manager
cert-manager 是以 Go 撰寫,並使用 Go 模組。您可以將其作為 Go 模組匯入,在某些情況下,這很好,甚至是被鼓勵的,但通常我們建議不要導入 cert-manager。
一般來說,除了下方「您可能導入 cert-manager 的時機」下列出的情況之外,cert-manager 儲存庫中的程式碼不受任何 Go 模組相容性保證的約束。我們可能會進行重大變更,即使是在公開匯出的 Go 程式碼中,甚至在 cert-manager 的次要或修補程式版本中也是如此。我們過去就曾進行過這樣的重大變更。
請注意,這不會影響 cert-manager 的執行。我們對相容性的承諾是不會破壞 cert-manager 的執行時功能,而且我們會認真看待這一點。
如果您確定確實需要將 cert-manager 作為模組匯入,請參閱下方 模組匯入路徑,以了解如何操作的說明。
何時您可能需要匯入 cert-manager
如果您正在編寫 Go 程式碼,在以下情況下您可能需要匯入 cert-manager:
- 使用 cert-manager 自訂資源,因此您想要匯入
pkg/apis
下的內容 - 實作外部 DNS 解析器 webhook,如 webhook-example 範例所示
- 實作外部簽發者,如 sample-external-issuer 範例所示
如果您認為您真的需要匯入程式碼的其他部分,請務必與我們聯繫,讓我們知道此需求!我們將盡力避免任何可能的破壞性變更。
模組匯入路徑
對於所有支援的 cert-manager 版本,模組匯入路徑為 github.com/cert-manager/cert-manager
。
歷史上,cert-manager 儲存庫在 GitHub 上最初是以 https://github.com/jetstack/cert-manager
建立的,後來遷移到 https://github.com/cert-manager/cert-manager
。
這表示如果您嘗試使用較舊版本的 cert-manager,您需要的 Go 模組匯入路徑可能會有所不同。
對於 cert-manager 1.8 及更新版本,請使用上面列出的新路徑。
對於 cert-manager 1.8 之前的版本,請使用舊路徑:github.com/jetstack/cert-manager