Documentation
¶
Index ¶
- Constants
- func ConfigurationFromContext(ctx context.Context) *config.Configuration
- func CopyDirectory(src, dst string) error
- func CopyDirectoryWithContext(ctx context.Context, src, dst string) error
- func CopyFileWithMode(src, dst string, mode fs.FileMode) error
- func CopyFileWithModeContext(ctx context.Context, src, dst string, mode fs.FileMode) error
- func ExtractTar(tarFile, extractDir string) error
- func IsCrossDeviceError(err error) bool
- func NormalizeCertificateDomain(domain string) string
- func NormalizeDeploymentDomain(rawDomain string) (canonicalDomain, safeName string, err error)
- func OperationContextError(ctx context.Context) error
- func ParseLeafCertificate(certPath string) (*x509.Certificate, error)
- func PublishDirectoryWithRollback(sourceDir, targetDir string) error
- func PublishDirectoryWithRollbackContext(ctx context.Context, sourceDir, targetDir string) error
- func PublishDirectoryWithValidation(sourceDir, targetDir string, validate func() error) error
- func PublishDirectoryWithValidationContext(ctx context.Context, sourceDir, targetDir string, validate func() error) error
- func RuntimeFromContext(ctx context.Context) *config.Runtime
- func SafeJoinUnderBase(baseDir string, pathElements ...string) (string, error)
- func SanitizeDomain(domain string) string
- func ValidateCertificateFiles(sourceDir, domain string) error
- func ValidateSafeDomainName(safeName string) error
- func WithRuntime(ctx context.Context, runtime *config.Runtime) context.Context
Constants ¶
const (
CertsDir = "certs" // CertsDir 是证书临时存储目录。
)
Variables ¶
This section is empty.
Functions ¶
func ConfigurationFromContext ¶
func ConfigurationFromContext(ctx context.Context) *config.Configuration
ConfigurationFromContext 返回 operation context 中的配置快照。
func CopyDirectoryWithContext ¶
CopyDirectoryWithContext 复制整个目录,并在遍历和文件复制前响应取消。
func CopyFileWithMode ¶
CopyFileWithMode 复制文件并保持权限。
func CopyFileWithModeContext ¶
CopyFileWithModeContext 复制文件并在复制前后响应取消。
func ExtractTar ¶
ExtractTar 解压证书压缩包。 当前证书包标准格式为 tar;这里兼容 tar.gz 和旧版 zip,避免前后端版本短暂不一致时部署失败。
func NormalizeCertificateDomain ¶
NormalizeCertificateDomain 将部署目录使用的安全域名还原为证书校验域名。
func NormalizeDeploymentDomain ¶
NormalizeDeploymentDomain validates a deployment domain and returns its canonical and filesystem-safe forms.
func OperationContextError ¶
OperationContextError 返回部署操作当前的取消或超时状态。
func ParseLeafCertificate ¶
func ParseLeafCertificate(certPath string) (*x509.Certificate, error)
ParseLeafCertificate 读取 PEM 证书文件并解析第一个 CERTIFICATE 块。
func PublishDirectoryWithRollback ¶
PublishDirectoryWithRollback 将新目录发布到目标路径,并在失败时尽量恢复旧目录。
func PublishDirectoryWithRollbackContext ¶
PublishDirectoryWithRollbackContext 原子发布目录,并在取消或失败时恢复旧目录。
func PublishDirectoryWithValidation ¶
PublishDirectoryWithValidation 发布新目录,并在发布后校验失败时恢复旧目录。
func PublishDirectoryWithValidationContext ¶
func PublishDirectoryWithValidationContext(ctx context.Context, sourceDir, targetDir string, validate func() error) error
PublishDirectoryWithValidationContext 原子发布目录,并在发布校验或调用方取消时回滚。
func RuntimeFromContext ¶
RuntimeFromContext 读取 operation context 中的运行时配置。
func SafeJoinUnderBase ¶
SafeJoinUnderBase joins a relative path while ensuring the result remains under baseDir.
func ValidateCertificateFiles ¶
ValidateCertificateFiles 校验证书文件、私钥文件、域名覆盖关系和证书私钥匹配关系。
func ValidateSafeDomainName ¶
ValidateSafeDomainName validates a previously normalized filesystem-safe domain name.
Types ¶
This section is empty.