github.com/qiniu/go-sdk/v7@v7.27.0/examples/sandbox_templates/main.go

package main

import (
	"context"
	"fmt"
	"log"
	"os"
	"time"

	"github.com/qiniu/go-sdk/v7/sandbox"
)

func main() {
	apiKey := os.Getenv("QINIU_API_KEY")
	if apiKey == "" {
		log.Fatal("请设置 QINIU_API_KEY 环境变量")
	}

	apiURL := os.Getenv("QINIU_SANDBOX_API_URL")

	c, err := sandbox.NewClient(&sandbox.Config{
		APIKey:   apiKey,
		Endpoint: apiURL,
	})
	if err != nil {
		log.Fatalf("创建客户端失败: %v", err)
	}

	ctx, cancel := context.WithTimeout(context.Background(), 120*time.Second)
	defer cancel()

	// 1. 列出默认模板
	fmt.Println("=== 列出默认模板 ===")
	defaultTemplates, err := c.ListDefaultTemplates(ctx)
	if err != nil {
		log.Fatalf("列出默认模板失败: %v", err)
	}
	fmt.Printf("共 %d 个默认模板:\n", len(defaultTemplates))
	for _, tmpl := range defaultTemplates {
		fmt.Printf("  - %s (名称: %v, 构建状态: %s)\n",
			tmpl.TemplateID, tmpl.Names, tmpl.BuildStatus)
	}

	// 2. 列出所有模板
	fmt.Println("\n=== 列出模板 ===")
	templates, err := c.ListTemplates(ctx, nil)
	if err != nil {
		log.Fatalf("列出模板失败: %v", err)
	}
	fmt.Printf("共 %d 个模板:\n", len(templates))
	for _, tmpl := range templates {
		names := "-"
		if len(tmpl.Names) > 0 {
			names = fmt.Sprintf("%v", tmpl.Names)
		}
		aliases := "-"
		if len(tmpl.Aliases) > 0 {
			aliases = fmt.Sprintf("%v", tmpl.Aliases)
		}
		fmt.Printf("  - %s\n", tmpl.TemplateID)
		fmt.Printf("    名称: %s, 旧别名: %s, 公开: %v\n", names, aliases, tmpl.Public)
		fmt.Printf("    CPU: %d 核, 内存: %d MB, 磁盘: %d MB, envd: %s\n",
			tmpl.CPUCount, tmpl.MemoryMB, tmpl.DiskSizeMB, tmpl.EnvdVersion)
		fmt.Printf("    构建状态: %s, 构建次数: %d, 使用次数: %d\n",
			tmpl.BuildStatus, tmpl.BuildCount, tmpl.SpawnCount)
		fmt.Printf("    创建时间: %s, 更新时间: %s\n",
			tmpl.CreatedAt.Format(time.RFC3339), tmpl.UpdatedAt.Format(time.RFC3339))
	}

	// 3. 获取单个模板详情
	if len(templates) > 0 {
		fmt.Println("\n=== 获取模板详情 ===")
		detail, err := c.GetTemplate(ctx, templates[0].TemplateID, nil)
		if err != nil {
			log.Fatalf("获取模板详情失败: %v", err)
		}
		fmt.Printf("模板: %s, 名称: %v, 当前用户拥有: %v, 构建数: %d\n",
			detail.TemplateID, detail.Names, detail.IsOwner, len(detail.Builds))
		for i, build := range detail.Builds {
			if i >= 3 {
				fmt.Printf("  ... 省略 %d 条\n", len(detail.Builds)-3)
				break
			}
			fmt.Printf("  - %s (状态: %s, CPU: %d, 内存: %d MB)\n",
				build.BuildID, build.Status, build.CPUCount, build.MemoryMB)
		}
	}

	// 模板创建和构建会消耗云端资源，默认只运行上面的只读示例。
	// 如需继续验证写操作，请显式设置 QINIU_SANDBOX_TEMPLATE_MUTATION_EXAMPLE=true。
	if os.Getenv("QINIU_SANDBOX_TEMPLATE_MUTATION_EXAMPLE") != "true" {
		fmt.Println("\n未启用模板写操作示例，跳过创建、构建和删除流程")
		return
	}

	// 4. 创建模板
	fmt.Println("\n=== 创建模板 ===")
	cpuCount := int32(2)
	memoryMB := int32(512)
	templateName := "sdk-example-template"
	resp, err := c.CreateTemplate(ctx, sandbox.CreateTemplateParams{
		Name:     &templateName,
		CPUCount: &cpuCount,
		MemoryMB: &memoryMB,
	})
	if err != nil {
		log.Fatalf("创建模板失败: %v", err)
	}
	templateID := resp.TemplateID
	buildID := resp.BuildID
	fmt.Printf("模板已创建: %s (构建: %s)\n", templateID, buildID)

	// 确保测试结束时清理
	defer func() {
		fmt.Println("\n=== 删除模板 ===")
		if err := c.DeleteTemplate(context.Background(), templateID); err != nil {
			fmt.Printf("删除模板失败: %v\n", err)
		} else {
			fmt.Printf("模板 %s 已删除\n", templateID)
		}
	}()

	// 5. 更新模板
	fmt.Println("\n=== 更新模板 ===")
	public := true
	if err := c.UpdateTemplate(ctx, templateID, sandbox.UpdateTemplateParams{
		Public: &public,
	}); err != nil {
		log.Fatalf("更新模板失败: %v", err)
	}
	fmt.Println("模板已更新为公开")

	// 6. 获取构建状态
	fmt.Println("\n=== 获取构建状态 ===")
	buildInfo, err := c.GetTemplateBuildStatus(ctx, templateID, buildID, nil)
	if err != nil {
		fmt.Printf("获取构建状态失败: %v\n", err)
	} else {
		fmt.Printf("构建 %s: 状态=%s, 模板=%s\n", buildInfo.BuildID, buildInfo.Status, buildInfo.TemplateID)
	}

	// 7. 获取构建日志
	fmt.Println("\n=== 获取构建日志 ===")
	buildLogs, err := c.GetTemplateBuildLogs(ctx, templateID, buildID, nil)
	if err != nil {
		fmt.Printf("获取构建日志失败: %v\n", err)
	} else {
		fmt.Printf("构建日志 (%d 条):\n", len(buildLogs.Logs))
		for i, entry := range buildLogs.Logs {
			if i >= 5 {
				fmt.Printf("  ... 省略 %d 条\n", len(buildLogs.Logs)-5)
				break
			}
			step := "-"
			if entry.Step != nil {
				step = *entry.Step
			}
			fmt.Printf("  [%s] [%s] %s: %s\n",
				entry.Timestamp.Format(time.RFC3339), entry.Level, step, entry.Message)
		}
	}

	// 8. 分配模板标签（AssignTemplateTags）
	fmt.Println("\n=== 分配模板标签 ===")
	tagResult, err := c.AssignTemplateTags(ctx, sandbox.ManageTagsParams{
		Target: fmt.Sprintf("%s:%s", templateName, "v1"),
		Tags:   []string{"latest", "stable"},
	})
	if err != nil {
		fmt.Printf("管理模板标签失败: %v\n", err)
	} else {
		fmt.Printf("标签已分配, 构建: %s, 标签: %v\n", tagResult.BuildID, tagResult.Tags)
	}

	// 9. 删除模板标签（DeleteTemplateTags）
	fmt.Println("\n=== 删除模板标签 ===")
	if err := c.DeleteTemplateTags(ctx, sandbox.DeleteTagsParams{
		Name: templateName,
		Tags: []string{"stable"},
	}); err != nil {
		fmt.Printf("删除模板标签失败: %v\n", err)
	} else {
		fmt.Println("标签 'stable' 已删除")
	}

	// 10. 通过别名查找模板（GetTemplateByAlias）
	fmt.Println("\n=== 通过别名查找模板 ===")
	if len(templates) > 0 && len(templates[0].Aliases) > 0 {
		alias := templates[0].Aliases[0]
		aliasResp, err := c.GetTemplateByAlias(ctx, alias)
		if err != nil {
			fmt.Printf("通过别名查找模板失败: %v\n", err)
		} else {
			fmt.Printf("别名 '%s' -> 模板: %s (公开: %v)\n", alias, aliasResp.TemplateID, aliasResp.Public)
		}
	} else {
		fmt.Println("没有可用的模板别名，跳过")
	}

	// 11. 获取模板文件上传链接（GetTemplateFiles）
	fmt.Println("\n=== 获取模板文件上传链接 ===")
	fileUpload, err := c.GetTemplateFiles(ctx, templateID, "example-hash-value")
	if err != nil {
		fmt.Printf("获取文件上传链接失败: %v\n", err)
	} else {
		fmt.Printf("文件是否已存在: %v, 已获得上传地址: %v\n", fileUpload.Present, fileUpload.URL != nil)
	}

	// 12. 启动模板构建（StartTemplateBuild）
	fmt.Println("\n=== 启动模板构建 ===")
	fromImage := "ubuntu:latest"
	if err := c.StartTemplateBuild(ctx, templateID, buildID, sandbox.StartTemplateBuildParams{
		FromImage: &fromImage,
	}); err != nil {
		fmt.Printf("启动构建失败（可能已在构建中）: %v\n", err)
	} else {
		fmt.Println("构建已启动")
	}

	// 13. 等待构建完成（WaitForBuild）
	fmt.Println("\n=== 等待构建完成 ===")
	finalBuild, err := c.WaitForBuild(ctx, templateID, buildID, sandbox.WithPollInterval(3*time.Second))
	if err != nil {
		fmt.Printf("等待构建完成失败: %v\n", err)
	} else {
		fmt.Printf("构建已完成: %s (状态: %s)\n", finalBuild.BuildID, finalBuild.Status)
	}

	// 14. 删除模板（通过 defer 执行）
}