|
| 1 | +package stackedoci |
| 2 | + |
| 3 | +import ( |
| 4 | + "context" |
| 5 | + "fmt" |
| 6 | + "os" |
| 7 | + "os/exec" |
| 8 | + "strings" |
| 9 | + "time" |
| 10 | + |
| 11 | + "github.com/gosuri/uitable" |
| 12 | + "github.com/spf13/cobra" |
| 13 | + "go.uber.org/zap" |
| 14 | + "go.uber.org/zap/zapio" |
| 15 | +) |
| 16 | + |
| 17 | +var ( |
| 18 | + debug bool |
| 19 | + baseImage string |
| 20 | + stackedImage string |
| 21 | + insecure bool |
| 22 | + concurrency uint |
| 23 | +) |
| 24 | + |
| 25 | +func NewCommand() *cobra.Command { |
| 26 | + cmd := &cobra.Command{ |
| 27 | + Use: "stacked-oci", |
| 28 | + Short: "benchmark empty and prewarmed Tart homes for stacked OCI pulls", |
| 29 | + Long: "Warm the registry once, then compare an empty Tart home with one whose " + |
| 30 | + "immutable base has already been materialized by tart clone --stacked. " + |
| 31 | + "Every scenario uses a disposable TART_HOME and leaves the user's Tart home untouched.", |
| 32 | + RunE: run, |
| 33 | + } |
| 34 | + |
| 35 | + cmd.Flags().BoolVar(&debug, "debug", false, "enable debug logging") |
| 36 | + cmd.Flags().StringVar(&baseImage, "base-image", "", "remote flat OCI image used as the stacked image's base") |
| 37 | + cmd.Flags().StringVar(&stackedImage, "image", "", "remote stacked OCI image to pull and clone") |
| 38 | + cmd.Flags().BoolVar(&insecure, "insecure", false, "connect to the OCI registry via insecure HTTP") |
| 39 | + cmd.Flags().UintVar(&concurrency, "concurrency", 4, "network concurrency passed to tart pull and clone") |
| 40 | + _ = cmd.MarkFlagRequired("base-image") |
| 41 | + _ = cmd.MarkFlagRequired("image") |
| 42 | + |
| 43 | + return cmd |
| 44 | +} |
| 45 | + |
| 46 | +func run(cmd *cobra.Command, _ []string) error { |
| 47 | + if concurrency < 1 { |
| 48 | + return fmt.Errorf("concurrency cannot be less than 1") |
| 49 | + } |
| 50 | + |
| 51 | + config := zap.NewProductionConfig() |
| 52 | + if debug { |
| 53 | + config.Level = zap.NewAtomicLevelAt(zap.DebugLevel) |
| 54 | + } |
| 55 | + logger, err := config.Build() |
| 56 | + if err != nil { |
| 57 | + return err |
| 58 | + } |
| 59 | + defer func() { _ = logger.Sync() }() |
| 60 | + |
| 61 | + warmupHome, err := os.MkdirTemp("", "tart-stacked-oci-warmup-*") |
| 62 | + if err != nil { |
| 63 | + return err |
| 64 | + } |
| 65 | + defer os.RemoveAll(warmupHome) |
| 66 | + |
| 67 | + emptyHome, err := os.MkdirTemp("", "tart-stacked-oci-empty-*") |
| 68 | + if err != nil { |
| 69 | + return err |
| 70 | + } |
| 71 | + defer os.RemoveAll(emptyHome) |
| 72 | + |
| 73 | + warmHome, err := os.MkdirTemp("", "tart-stacked-oci-warm-*") |
| 74 | + if err != nil { |
| 75 | + return err |
| 76 | + } |
| 77 | + defer os.RemoveAll(warmHome) |
| 78 | + |
| 79 | + table := uitable.New() |
| 80 | + table.AddRow("Scenario", "Operation", "Time") |
| 81 | + |
| 82 | + // Warm registry, CDN, and filesystem caches before either measured |
| 83 | + // scenario so their difference reflects Tart's local base reuse. |
| 84 | + if _, err := timedTart(cmd.Context(), logger, warmupHome, pullArguments(stackedImage)...); err != nil { |
| 85 | + return fmt.Errorf("registry warmup failed: %w", err) |
| 86 | + } |
| 87 | + if err := os.RemoveAll(warmupHome); err != nil { |
| 88 | + return fmt.Errorf("removing registry warmup home: %w", err) |
| 89 | + } |
| 90 | + |
| 91 | + duration, err := timedTart(cmd.Context(), logger, emptyHome, pullArguments(stackedImage)...) |
| 92 | + if err != nil { |
| 93 | + return fmt.Errorf("empty-home stacked pull failed: %w", err) |
| 94 | + } |
| 95 | + table.AddRow("empty", "pull stacked image", duration) |
| 96 | + |
| 97 | + duration, err = timedTart(cmd.Context(), logger, emptyHome, "clone", stackedImage, "empty-clone") |
| 98 | + if err != nil { |
| 99 | + return fmt.Errorf("empty-home stacked clone failed: %w", err) |
| 100 | + } |
| 101 | + table.AddRow("empty", "clone stacked image", duration) |
| 102 | + if err := os.RemoveAll(emptyHome); err != nil { |
| 103 | + return fmt.Errorf("removing empty home: %w", err) |
| 104 | + } |
| 105 | + |
| 106 | + duration, err = timedTart(cmd.Context(), logger, warmHome, cloneBaseArguments(baseImage)...) |
| 107 | + if err != nil { |
| 108 | + return fmt.Errorf("base prewarm failed: %w", err) |
| 109 | + } |
| 110 | + table.AddRow("prewarmed", "clone --stacked base image", duration) |
| 111 | + |
| 112 | + duration, err = timedTart(cmd.Context(), logger, warmHome, pullArguments(stackedImage)...) |
| 113 | + if err != nil { |
| 114 | + return fmt.Errorf("prewarmed stacked pull failed: %w", err) |
| 115 | + } |
| 116 | + table.AddRow("prewarmed", "pull stacked image", duration) |
| 117 | + |
| 118 | + duration, err = timedTart(cmd.Context(), logger, warmHome, "clone", stackedImage, "warm-clone") |
| 119 | + if err != nil { |
| 120 | + return fmt.Errorf("prewarmed stacked clone failed: %w", err) |
| 121 | + } |
| 122 | + table.AddRow("prewarmed", "clone stacked image", duration) |
| 123 | + |
| 124 | + fmt.Println(table.String()) |
| 125 | + return nil |
| 126 | +} |
| 127 | + |
| 128 | +func pullArguments(image string) []string { |
| 129 | + args := []string{"pull", "--concurrency", fmt.Sprint(concurrency)} |
| 130 | + if insecure { |
| 131 | + args = append(args, "--insecure") |
| 132 | + } |
| 133 | + return append(args, image) |
| 134 | +} |
| 135 | + |
| 136 | +func cloneBaseArguments(image string) []string { |
| 137 | + args := []string{"clone", "--stacked", "--concurrency", fmt.Sprint(concurrency)} |
| 138 | + if insecure { |
| 139 | + args = append(args, "--insecure") |
| 140 | + } |
| 141 | + return append(args, image, "prewarmed-base") |
| 142 | +} |
| 143 | + |
| 144 | +func timedTart( |
| 145 | + ctx context.Context, |
| 146 | + logger *zap.Logger, |
| 147 | + tartHome string, |
| 148 | + args ...string, |
| 149 | +) (time.Duration, error) { |
| 150 | + logger.Sugar().Debugf("TART_HOME=%s tart %s", tartHome, strings.Join(args, " ")) |
| 151 | + start := time.Now() |
| 152 | + |
| 153 | + command := exec.CommandContext(ctx, "tart", args...) |
| 154 | + command.Env = append(os.Environ(), "TART_HOME="+tartHome) |
| 155 | + loggerWriter := &zapio.Writer{Log: logger, Level: zap.DebugLevel} |
| 156 | + command.Stdout = loggerWriter |
| 157 | + command.Stderr = loggerWriter |
| 158 | + |
| 159 | + err := command.Run() |
| 160 | + return time.Since(start).Round(time.Millisecond), err |
| 161 | +} |
0 commit comments