serverless

Documentation

Index

• func Deploy(ctx context.Context, cfg *config.NextDeployConfig, ...) error
• func Rollback(ctx context.Context, cfg *config.NextDeployConfig) error
• type AWSProvider
  • func NewAWSProvider() *AWSProvider
  • func (p *AWSProvider) DeployCompute(ctx context.Context, tarballPath string, appCfg *cfgTypes.NextDeployConfig, ...) error
  • func (p *AWSProvider) DeployStatic(ctx context.Context, tarballPath string, appCfg *cfgTypes.NextDeployConfig, ...) error
  • func (p *AWSProvider) Destroy(ctx context.Context, appCfg *cfgTypes.NextDeployConfig) error
  • func (p *AWSProvider) Initialize(ctx context.Context, appCfg *cfgTypes.NextDeployConfig) error
  • func (p *AWSProvider) InvalidateCache(ctx context.Context, appCfg *cfgTypes.NextDeployConfig) error
  • func (p *AWSProvider) Rollback(ctx context.Context, appCfg *cfgTypes.NextDeployConfig) error
  • func (p *AWSProvider) UpdateSecrets(ctx context.Context, appName string, secrets map[string]string) error
• type Provider

Functions

func Deploy

func Deploy(ctx context.Context, cfg *config.NextDeployConfig, meta *nextcore.NextCorePayload) error

Deploy orchestrates the full serverless deployment pipeline:

1. Discovers the build artifact (app.tar.gz)
2. Fetches local secrets via SecretManager and pushes them to the cloud secret store
3. Uploads static assets to CDN/Storage
4. Deploys the compute layer (Lambda, Workers, etc.)
5. Invalidates the CDN cache

func Rollback

func Rollback(ctx context.Context, cfg *config.NextDeployConfig) error

Rollback orchestrates the serverless rollback process.

Types

type AWSProvider

type AWSProvider struct {
	// contains filtered or unexported fields
}

func NewAWSProvider

func NewAWSProvider() *AWSProvider

func (*AWSProvider) DeployCompute

func (p *AWSProvider) DeployCompute(ctx context.Context, tarballPath string, appCfg *cfgTypes.NextDeployConfig, meta *nextcore.NextCorePayload) error

func (*AWSProvider) DeployStatic

func (p *AWSProvider) DeployStatic(ctx context.Context, tarballPath string, appCfg *cfgTypes.NextDeployConfig, meta *nextcore.NextCorePayload) error

func (*AWSProvider) Destroy

func (p *AWSProvider) Destroy(ctx context.Context, appCfg *cfgTypes.NextDeployConfig) error

func (*AWSProvider) Initialize

func (p *AWSProvider) Initialize(ctx context.Context, appCfg *cfgTypes.NextDeployConfig) error

func (*AWSProvider) InvalidateCache

func (p *AWSProvider) InvalidateCache(ctx context.Context, appCfg *cfgTypes.NextDeployConfig) error

func (*AWSProvider) Rollback

func (p *AWSProvider) Rollback(ctx context.Context, appCfg *cfgTypes.NextDeployConfig) error

Rollback reverts the Lambda function to the previous published version.

func (*AWSProvider) UpdateSecrets

func (p *AWSProvider) UpdateSecrets(ctx context.Context, appName string, secrets map[string]string) error

type Provider

type Provider interface {
	// Initialize validates credentials and prepares the environment.
	Initialize(ctx context.Context, cfg *config.NextDeployConfig) error

	// DeployStatic uploads static assets (public/, .next/static/) to a CDN/Storage bucket.
	DeployStatic(ctx context.Context, tarballPath string, cfg *config.NextDeployConfig, meta *nextcore.NextCorePayload) error

	// UpdateSecrets securely injects secrets from the SecretManager into the cloud provider's
	// secret store (e.g., AWS Secrets Manager, Cloudflare Secrets).
	// This ensures raw secrets are never packed into the deployment artifact.
	UpdateSecrets(ctx context.Context, appName string, secrets map[string]string) error

	// DeployCompute packages the standalone build and updates the compute layer
	// (e.g., AWS Lambda + Web Adapter, Cloudflare Workers).
	DeployCompute(ctx context.Context, tarballPath string, cfg *config.NextDeployConfig, meta *nextcore.NextCorePayload) error

	// InvalidateCache clears the CDN cache to ensure fresh assets are served.
	InvalidateCache(ctx context.Context, cfg *config.NextDeployConfig) error

	// Rollback reverts the compute layer to the previous version and
	// invalidates the CDN cache so the old version is served immediately.
	Rollback(ctx context.Context, cfg *config.NextDeployConfig) error

	// Destroy removes all application resources from the cloud provider.
	Destroy(ctx context.Context, cfg *config.NextDeployConfig) error
}

Provider defines the interface for deploying to various serverless platforms (e.g., AWS, Cloudflare, GCP, Azure).