Sandbox 深休眠（文件系统恢复）

功能介绍

使用前提

仅恢复文件系统是 Sandbox 深休眠的扩展功能，使用前需满足以下条件：

1. 已满足深休眠的所有前提条件：包括白名单申请、会话亲和+会话隔离、自定义镜像、CPU 实例等。详见Sandbox 深休眠（暂停与恢复会话）。

2. 额外的白名单申请：仅恢复文件系统功能需要额外申请开通。请通过提交工单申请开通「Sandbox 深休眠——仅恢复文件系统」能力。

功能限制与约束

除Sandbox 深休眠（暂停与恢复会话）的通用限制外，仅恢复文件系统还有以下额外约束：

• 仅恢复文件系统时，内存中的数据不会被恢复。暂停前内存中缓存的变量、对象、连接池等数据将丢失。

• 恢复后实例以全新进程启动，用户应用需要具备自行初始化的能力（如通过容器 ENTRYPOINT 启动服务）。

• 建议将应用设计为可重启的模式，即通过容器镜像的 ENTRYPOINT 即可完成进程初始化，文件系统中的数据在进程启动后可直接使用。

操作步骤

PUT /2023-03-30/functions/{functionName}/sessions/{sessionId}/resume?fileSystemOnly=true

func resumeSessionFileSystemOnly(client *fc.Client, functionName, sessionId *string) (*fc.ResumeSessionResponse, error) {
    return client.ResumeSessionWithOptions(
        functionName,
        sessionId,
        &fc.ResumeSessionRequest{
            FileSystemOnly: tea.Bool(true),
        },
        nil,
        &dara.RuntimeOptions{},
    )
}

// 调用示例
func main() {
    client, err := createClient()
    if err != nil {
        panic(err)
    }

    functionName := tea.String("my-sandbox-function")
    sessionId := tea.String("my-session-id")

    resp, err := resumeSessionFileSystemOnly(client, functionName, sessionId)
    if err != nil {
        fmt.Printf("ResumeSession（仅恢复文件系统）失败: %v\n", err)
        return
    }
    fmt.Printf("ResumeSession 成功，Session 状态: %s\n", tea.StringValue(resp.Body.SessionStatus))
}

func resumeSession(client *fc.Client, functionName, sessionId *string) (*fc.ResumeSessionResponse, error) {
    return client.ResumeSessionWithOptions(
        functionName,
        sessionId,
        &fc.ResumeSessionRequest{},
        nil,
        &dara.RuntimeOptions{},
    )
}

完整使用流程

以下展示使用仅恢复文件系统的完整流程：

1. 创建函数：开启会话亲和+会话隔离，选择自定义镜像。

2. 创建会话：通过 CreateSession 或 InvokeFunction 创建 Session。

3. 使用 Sandbox：安装依赖、下载模型、生成中间文件等。

4. 暂停会话：调用 PauseSession，保存快照并销毁实例。暂停期间不产生 CPU 和内存费用。

5. 仅恢复文件系统：调用 ResumeSession 并设置 fileSystemOnly=true。

6. 验证恢复结果：通过 GetSession 确认状态为 Active，然后通过 InvokeFunction 验证文件系统数据完整。

7. 继续使用：文件系统与暂停前一致，进程为全新启动。如需再次暂停，重复步骤 4~6。

8. 删除会话：使用完毕后调用 DeleteSession 释放资源。

Go SDK 完整示例

package main

import (
    "fmt"
    "os"

    openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
    fc "github.com/alibabacloud-go/fc-20230330/client"
    "github.com/alibabacloud-go/tea/dara"
    "github.com/alibabacloud-go/tea/tea"
)

func main() {
    // 1. 初始化客户端
    client, err := fc.NewClient(&openapi.Config{
        RegionId:        tea.String("cn-shanghai"),
        AccessKeyId:     tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
        AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
        Endpoint:        tea.String("<账号ID>.cn-shanghai.fc.aliyuncs.com"),
    })
    if err != nil {
        panic(err)
    }

    functionName := tea.String("my-sandbox-function")
    headerKey := "x-session-id"

    // 2. 首次调用函数，自动创建 Session
    invokeResp, err := client.InvokeFunctionWithOptions(
        functionName,
        &fc.InvokeFunctionRequest{},
        &fc.InvokeFunctionHeaders{},
        &dara.RuntimeOptions{},
    )
    if err != nil {
        panic(err)
    }
    sessionId := invokeResp.Headers[headerKey]
    fmt.Printf("Session 已创建，Session ID: %s\n", tea.StringValue(sessionId))

    // 3. 在 Sandbox 中进行操作（安装依赖、生成文件等）
    _, err = client.InvokeFunctionWithOptions(
        functionName,
        &fc.InvokeFunctionRequest{},
        &fc.InvokeFunctionHeaders{
            CommonHeaders: map[string]*string{
                headerKey: sessionId,
            },
        },
        &dara.RuntimeOptions{},
    )
    if err != nil {
        panic(err)
    }
    fmt.Println("Sandbox 操作完成（依赖安装、文件生成等）")

    // 4. 暂停会话（保存快照，销毁实例）
    pauseResp, err := client.PauseSessionWithOptions(
        functionName,
        sessionId,
        &fc.PauseSessionRequest{},
        nil,
        &dara.RuntimeOptions{},
    )
    if err != nil {
        panic(err)
    }
    fmt.Printf("PauseSession 成功，状态: %s\n", tea.StringValue(pauseResp.Body.SessionStatus))

    // 5. 仅恢复文件系统
    resumeResp, err := client.ResumeSessionWithOptions(
        functionName,
        sessionId,
        &fc.ResumeSessionRequest{
            FileSystemOnly: tea.Bool(true),
        },
        nil,
        &dara.RuntimeOptions{},
    )
    if err != nil {
        panic(err)
    }
    fmt.Printf("ResumeSession（仅恢复文件系统）成功，状态: %s\n", tea.StringValue(resumeResp.Body.SessionStatus))

    // 6. 继续使用 Sandbox（文件系统已恢复，进程为全新启动）
    _, err = client.InvokeFunctionWithOptions(
        functionName,
        &fc.InvokeFunctionRequest{},
        &fc.InvokeFunctionHeaders{
            CommonHeaders: map[string]*string{
                headerKey: sessionId,
            },
        },
        &dara.RuntimeOptions{},
    )
    if err != nil {
        panic(err)
    }
    fmt.Println("恢复后函数调用成功，文件系统数据与暂停前一致")

    // 7. 使用完毕，删除会话
    _, err = client.DeleteSessionWithOptions(
        functionName,
        sessionId,
        &fc.DeleteSessionRequest{},
        nil,
        &dara.RuntimeOptions{},
    )
    if err != nil {
        panic(err)
    }
    fmt.Println("Session 已删除")
}

常见问题

相关文档

• Sandbox 深休眠（暂停与恢复会话）

• ResumeSession - 恢复会话 API 文档

• PauseSession - 暂停会话 API 文档

• 会话介绍

• 会话生命周期管理

• HeaderField 亲和配置

• 会话亲和通用限制及原理说明