cls3

README

cls3

The description in English is available on the following blog page. -> Blog

The description in Japanese is available on the following blog page. -> Blog

What is

CLI tool to clear (so delete all objects and versions/delete-markers in) Amazon S3 Buckets(AWS). The bucket itself can also be deleted by the option.

This tool allows you to search for bucket names and delete or clear multiple buckets.

Install

• Homebrew

  brew install go-to-k/tap/cls3
  

• Binary
  • Releases
• Git Clone and install(for developers)

  git clone https://github.com/go-to-k/cls3.git
  cd cls3
  make install
  

How to use

cls3 -b <bucketName> [-b <bucketName>] [-p <profile>] [-r <region>] [-f|--force] [-i|--interactive]

• -b, --bucketName: optional
  • Bucket name
    • Must be specified in not interactive mode
    • Otherwise (so in the interactive mode), you can not specify this!
  • Multiple specifications are possible.
    • cls3 -b test1 -b test2
• -p, --profile: optional
  • AWS profile name
• -r, --region: optional(default: ap-northeast-1)
  • AWS Region
  • It is not necessary to be aware of this as it can be used across regions.
• -f, --force: optional
  • ForceMode (Delete the bucket together)
• -i, --interactive: optional
  • Interactive Mode for buckets selection

Interactive Mode

BucketName Selection

In the interactive mode(-i option), you can search bucket names and select buckets.

It is designed to be searchable and deletable across regions, so it can be used without being region-aware.

It can be empty.

❯ cls3 -i
Filter a keyword of bucket names: test-goto

Then you select bucket names in the UI.

? Select buckets.
  [Use arrows to move, space to select, <right> to all, <left> to none, type to filter]
> [x]  test-goto-bucket-1
  [ ]  test-goto-bucket-2
  [x]  test-goto-bucket-3