LocalStacker

Giới thiệu

LocalStacker là ứng dụng desktop local-first dành cho LocalStack, giúp bạn duyệt và thao tác trực tiếp các tài nguyên AWS đang chạy cục bộ mà không cần gõ lệnh. Ứng dụng hoạt động hoàn toàn trên máy của bạn, kết nối thẳng tới localhost:4566 - không tài khoản đám mây, không telemetry, không dịch vụ bên ngoài.

Tính năng chính

Lưu trữ và hàng đợi

• S3: duyệt bucket theo kiểu thư mục, xem trước object, kéo-thả upload/download, tạo presigned URL.
• SQS: theo dõi độ sâu hàng đợi và số message in-flight theo thời gian thực, gửi message JSON có kiểm tra hợp lệ, xem trước message mà không tiêu thụ, purge, redrive từ dead-letter queue.

Compute và dữ liệu

• Lambda: xem danh sách hàm, inspect cấu hình (runtime, handler, biến môi trường), invoke với test payload rồi xem trạng thái phản hồi, payload và log thực thi, chỉnh sửa biến môi trường.
• DynamoDB: danh sách bảng với key schema (HASH/RANGE) và GSI/LSI, lưới item ảo hóa, Scan & Query theo biểu thức PK/SK, trình soạn thảo JSON, xóa item, clear bảng.
• DynamoDB Streams: bật/tắt stream trên bảng, khám phá shard với record peek không tiêu thụ, xem ảnh New/Old đã giải mã JSON.
• Step Functions: danh sách state machine, xem định nghĩa ASL, chạy execution kèm dòng thời gian event, đồ thị trạng thái trực quan (react-flow).

Bảo mật và cấu hình

• Secrets Manager: liệt kê, tạo/cập nhật secret, xem giá trị đã giải mã, xóa secret (có giải thích yêu cầu auth token Hobby+ của LocalStack).
• SSM Parameter Store: tham số theo phân cấp đường dẫn hoặc dạng phẳng, nhãn kiểu (String, StringList, SecureString), bật/tắt giá trị giải mã, tạo/cập nhật/xóa.
• KMS: danh sách key đối xứng với tạo và xóa theo lịch, quản lý alias, sân chơi encrypt/decrypt (plaintext ↔ base64), xem key policy và trạng thái rotation.
• IAM: liệt kê role, user, policy; inspector quan hệ tin cậy; trình soạn thảo inline policy với JSON hiển thị cú pháp; quản lý access key kèm trợ lý copy .env.
• ACM: kho chứng chỉ với nhãn trạng thái, yêu cầu chứng chỉ xác thực DNS kèm hiển thị token CNAME, import chứng chỉ PEM, drawer chi tiết (subject, issuer, hiệu lực, SANs).

Tích hợp và mạng

• SNS: danh sách topic (standard & FIFO), thuộc tính, danh sách subscription, publish message (payload + attribute), trợ lý subscribe queue SQS.
• EventBridge: khám phá event bus (default & custom) và rule kèm trình xem/chỉnh sửa event pattern, quản lý target (Lambda, SQS, SNS), bật/tắt rule, publisher PutEvents để test.
• EventBridge Scheduler: nhóm lịch, danh sách lịch (rate/cron/at) với bật/tắt, tạo/xóa lịch, inspector target và payload.
• API Gateway: danh sách REST API, cây resource, inspector method, các bản deploy theo stage, Method Test Runner tích hợp sẵn (TestInvokeMethod).
• SES: danh sách email và domain đã xác minh, modal gửi email test, hộp thư Captured Mailbox của LocalStack với các tab HTML, plaintext, raw MIME và attachment.
• Route 53: khám phá hosted zone (public/private), lưới ResourceRecordSets ảo hóa, trình soạn thảo bản ghi DNS (A, AAAA, CNAME, TXT, MX…) với kiểm tra TTL và giá trị; kèm phần Route 53 Resolver endpoints & rules.
• CloudFormation: danh sách stack với nhãn trạng thái, inspector stack (outputs, resources, dòng thời gian event, template viewer), xóa stack.

Quan sát

• CloudWatch Logs: khám phá log group & stream, trình xem log ảo hóa với live tailing và bộ lọc tìm kiếm, deep-link từ trang Lambda.
• CloudWatch Metrics: duyệt metric tùy chỉnh (lọc namespace/dimension) với xem thống kê inline, publisher PutMetricData để test.
• Alarms & STS: tạo/xóa alarm theo ngưỡng với nhãn trạng thái và drawer chi tiết, thẻ caller identity STS trên trang Home.

Quản lý Docker

• Quản lý vòng đời container qua Docker socket cục bộ (thư viện bollard, không cần CLI sidecar): nhận diện và inspect container LocalStack (bao gồm ảnh localstack-persist).
• Start/stop/restart/remove với cảnh báo nhận biết persistence, console log trực tiếp kèm snapshot theo thời gian thực.
• Trình hướng dẫn tạo container với bảng chọn service trực quan (SERVICES), theo dõi tiến trình pull image và tự động kết nối.

Trải nghiệm local-first

• Không cần tài khoản, không telemetry - mọi thứ chạy trên máy bạn.
• Kết nối nhiều profile LocalStack với health badge, kèm bảng trạng thái service trực quan ngay lần chạy đầu (onboarding).
• Giao diện điều hướng bằng bàn phím, tối ưu tốc độ cho vòng lặp phát triển hằng ngày.
• Auto-updater tích hợp: thông báo bản mới và cài đặt cập nhật một chạm.

Cài đặt

Tải bản cài sẵn mới nhất từ GitHub Releases:

• macOS: .dmg (Apple Silicon)
• Windows: .exe (NSIS installer, có auto-update)
• Linux: .AppImage (x86_64, có auto-update)

Phát triển từ mã nguồn (cần Node 22+, pnpm, Rust toolchain, Docker):

pnpm install
pnpm tauri dev

Cách dùng nhanh

Khởi động LocalStack cục bộ:

docker run --rm -p 4566:4566 -v /var/run/docker.sock:/var/run/docker.sock localstack/localstack:4.14.0

Mở LocalStacker - ứng dụng tự nhận diện container (hoặc kết nối qua onboarding) và bạn bắt đầu duyệt tài nguyên ngay. Mount /var/run/docker.sock là bắt buộc để LocalStack chạy runtime của Lambda function.