Add ecsta cp command

.github/workflows/release.yml

@@ -17,6 +17,14 @@ jobs:
         uses: actions/setup-go@v5
         with:
           go-version: "1.23"
+          go-version-file: ./go.mod
+          cache: true
+      - name: download
+        run: |
+          go mod download
+          make download-assets
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       - name: Run GoReleaser
         uses: goreleaser/goreleaser-action@v6
         with:

.github/workflows/test.yml

@@ -10,17 +10,21 @@ jobs:
     name: Build
     runs-on: ubuntu-latest
     steps:
+      - name: Check out code into the Go module directory
+        uses: actions/checkout@v4
+
       - name: Set up Go
         uses: actions/setup-go@v5
         with:
           go-version: ${{ matrix.go }}
-        id: go
-
-      - name: Check out code into the Go module directory
-        uses: actions/checkout@v4
+          go-version-file: ./go.mod
+          cache: true
 
       - name: Build & Test
         run: |
+          go mod download
+          make download-assets
           go test -race -v ./...
         env:
           TZ: Asia/Tokyo # for time.Local
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Makefile

@@ -1,5 +1,7 @@
 .PHONY: test install clean
 
+TNCL_VERSION=v0.0.4
+
 test:
 	TZ=Asia/Tokyo go test ./...
 
@@ -10,4 +12,10 @@ dist/:
 	goreleaser build --snapshot --rm-dist
 
 clean:
-	rm -fr dist/
+	rm -fr dist/ assets/*
+
+download-assets:
+	cd assets && \
+	gh release download $(TNCL_VERSION) \
+		--repo fujiwara/tncl \
+		--pattern 'tncl-*-linux-musl'

README.md

@@ -222,6 +222,54 @@ Flags:
 
 When `--start-time` and `--follow` is specified both, `--start-time` may not work correctly.
 
+### copy files
+
+```console
+Usage: ecsta cp <src> <dest> [flags]
+
+Copy files from/to a task
+
+Arguments:
+  <src>     Source
+  <dest>    Destination
+
+Flags:
+      --port=12345          port number for file transfer
+      --[no-]progress       show progress bar
+      --id=STRING           task ID
+      --container=STRING    container name
+      --family=FAMILY       task definition family name
+      --service=SERVICE     ECS service name
+```
+
+Example:
+
+```console
+$ ecsta cp /path/to/file.txt _:/tmp/file.txt  # copy file to a task(_ is the selected task)
+$ ecsta cp 75dc060ef49b4ba1b2a33581dc5b876f:/tmp/file.txt /path/to/file.txt  # copy file from the task.
+```
+
+`ecsta cp` copies files from/to a task.
+
+#### How to work `ecsta cp`
+
+`ecsta cp` works as below.
+
+1. `ecsta` starts a temporary TCP server on the task vie ECS Exec.
+   - The server listens on the specified port (default is 12345).
+   - [tncl](https://github.com/fujiwara/tncl) is used as the server. It is a tiny TCP server that like `nc -l` command.
+   - The server is terminated when the file transfer is completed.
+2. `ecsta` starts a port forwarding to the temporary server.
+3. `ecsta` connects to the temporary server via the port forwarding.
+4. `ecsta` sends or receives a file via the connection.
+
+Requirements:
+- The task must have the ECS Exec feature enabled.
+- The task must have `sh`, `base64`, and `chmod` commands.
+
+Limitations:
+- Multiple files and directories are not supported.
+
 ### `--task-format-query(-q)` option
 
 This option provides a formatter by [jq](https://stedolan.github.io/jq/) query. The query processes tasks JSON (that output equals to ecsta describe) in task selector outputs.

assets/.gitignore

@@ -0,0 +1 @@
+*

cli.go

@@ -3,6 +3,7 @@ package ecsta
 import (
 	"context"
 	"fmt"
+	"log/slog"
 	"strings"
 
 	"github.com/alecthomas/kong"
@@ -13,6 +14,7 @@ type CLI struct {
 	Region          string `help:"AWS region" short:"r" env:"AWS_REGION"`
 	Output          string `help:"output format (table, tsv, json)" short:"o" default:"table" enum:"table,tsv,json" env:"ECSTA_OUTPUT"`
 	TaskFormatQuery string `help:"A jq query to format task in selector" short:"q" env:"ECSTA_TASK_FORMAT_QUERY"`
+	Debug           bool   `help:"enable debug output" env:"ECSTA_DEBUG"`
 
 	Configure   *ConfigureOption   `cmd:"" help:"Create a configuration file of ecsta"`
 	Describe    *DescribeOption    `cmd:"" help:"Describe tasks"`
@@ -22,6 +24,7 @@ type CLI struct {
 	Portforward *PortforwardOption `cmd:"" help:"Forward a port of a task"`
 	Stop        *StopOption        `cmd:"" help:"Stop a task"`
 	Trace       *TraceOption       `cmd:"" help:"Trace a task"`
+	CP          *CpOption          `cmd:"" help:"Copy files from/to a task"`
 	Version     struct{}           `cmd:"" help:"Show version"`
 }
 
@@ -35,6 +38,12 @@ func RunCLI(ctx context.Context, args []string) error {
 	if err != nil {
 		return err
 	}
+	if cli.Debug {
+		slog.SetLogLoggerLevel(slog.LevelDebug)
+	} else {
+		slog.SetLogLoggerLevel(slog.LevelInfo)
+	}
+
 	app, err := New(ctx, cli.Region, cli.Cluster)
 	if err != nil {
 		return err
@@ -62,6 +71,8 @@ func (app *Ecsta) Dispatch(ctx context.Context, command string, cli *CLI) error
 		return app.RunStop(ctx, cli.Stop)
 	case "trace":
 		return app.RunTrace(ctx, cli.Trace)
+	case "cp":
+		return app.RunCp(ctx, cli.CP)
 	case "version":
 		fmt.Printf("ecsta %s\n", Version)
 		return nil