shared

package
v0.7.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 18, 2026 License: Apache-2.0 Imports: 27 Imported by: 0

Documentation

Index

Constants

View Source
const (
	CertsDir = "certs" // CertsDir 是证书临时存储目录。

)

Variables

This section is empty.

Functions

func ConfigurationFromContext

func ConfigurationFromContext(ctx context.Context) *config.Configuration

ConfigurationFromContext 返回 operation context 中的配置快照。

func CopyDirectory

func CopyDirectory(src, dst string) error

CopyDirectory 复制整个目录,兼容入口不绑定调用方生命周期。

func CopyDirectoryWithContext

func CopyDirectoryWithContext(ctx context.Context, src, dst string) error

CopyDirectoryWithContext 复制整个目录,并在遍历和文件复制前响应取消。

func CopyFileWithMode

func CopyFileWithMode(src, dst string, mode fs.FileMode) error

CopyFileWithMode 复制文件并保持权限。

func CopyFileWithModeContext

func CopyFileWithModeContext(ctx context.Context, src, dst string, mode fs.FileMode) error

CopyFileWithModeContext 复制文件并在复制前后响应取消。

func ExtractTar

func ExtractTar(tarFile, extractDir string) error

ExtractTar 解压证书压缩包。 当前证书包标准格式为 tar;这里兼容 tar.gz 和旧版 zip,避免前后端版本短暂不一致时部署失败。

func IsCrossDeviceError

func IsCrossDeviceError(err error) bool

IsCrossDeviceError 检测是否为跨设备移动错误

func NormalizeCertificateDomain

func NormalizeCertificateDomain(domain string) string

NormalizeCertificateDomain 将部署目录使用的安全域名还原为证书校验域名。

func NormalizeDeploymentDomain

func NormalizeDeploymentDomain(rawDomain string) (canonicalDomain, safeName string, err error)

NormalizeDeploymentDomain validates a deployment domain and returns its canonical and filesystem-safe forms.

func OperationContextError

func OperationContextError(ctx context.Context) error

OperationContextError 返回部署操作当前的取消或超时状态。

func ParseLeafCertificate

func ParseLeafCertificate(certPath string) (*x509.Certificate, error)

ParseLeafCertificate 读取 PEM 证书文件并解析第一个 CERTIFICATE 块。

func PublishDirectoryWithRollback

func PublishDirectoryWithRollback(sourceDir, targetDir string) error

PublishDirectoryWithRollback 将新目录发布到目标路径,并在失败时尽量恢复旧目录。

func PublishDirectoryWithRollbackContext

func PublishDirectoryWithRollbackContext(ctx context.Context, sourceDir, targetDir string) error

PublishDirectoryWithRollbackContext 原子发布目录,并在取消或失败时恢复旧目录。

func PublishDirectoryWithValidation

func PublishDirectoryWithValidation(sourceDir, targetDir string, validate func() error) error

PublishDirectoryWithValidation 发布新目录,并在发布后校验失败时恢复旧目录。

func PublishDirectoryWithValidationContext

func PublishDirectoryWithValidationContext(ctx context.Context, sourceDir, targetDir string, validate func() error) error

PublishDirectoryWithValidationContext 原子发布目录,并在发布校验或调用方取消时回滚。

func RuntimeFromContext

func RuntimeFromContext(ctx context.Context) *config.Runtime

RuntimeFromContext 读取 operation context 中的运行时配置。

func SafeJoinUnderBase

func SafeJoinUnderBase(baseDir string, pathElements ...string) (string, error)

SafeJoinUnderBase joins a relative path while ensuring the result remains under baseDir.

func SanitizeDomain

func SanitizeDomain(domain string) string

SanitizeDomain 返回有效部署域名对应的文件系统安全名称。

func ValidateCertificateFiles

func ValidateCertificateFiles(sourceDir, domain string) error

ValidateCertificateFiles 校验证书文件、私钥文件、域名覆盖关系和证书私钥匹配关系。

func ValidateSafeDomainName

func ValidateSafeDomainName(safeName string) error

ValidateSafeDomainName validates a previously normalized filesystem-safe domain name.

func WithRuntime

func WithRuntime(ctx context.Context, runtime *config.Runtime) context.Context

WithRuntime 将运行时配置附加到一次本地部署 operation context。

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL