Skip to content

necatiarslan/aws-s3

Repository files navigation

AWS S3 Extension for Visual Studio Code

screenshoot

The AWS S3 extension for Visual Studio Code empowers users to seamlessly browse and manage their Amazon S3 buckets, files, and folders directly within the VS Code editor.

Features

With this extension, you can efficiently perform a wide range of tasks, including:

  • File Management:

    • Rename, copy, move, delete, upload, and download files.
  • Folder Management:

    • Create, rename, copy, move, delete, and download folders.
  • Enhanced Copying Options:

    • Copy file names (with or without extensions), keys, ARNs, URLs, and S3 URIs.
  • Shortcuts:

    • Add shortcuts to frequently accessed files and folders for quick access.
  • Advanced Search:

    • Search across all buckets using file names, extensions, folders, or keys.
  • Endpoint & Region Customization:

    • Configure AWS endpoint URLs for flexibility.
    • Set Aws Region if you need. Some custom S3 compatible cloud providers may need it.
  • Localstack Support:

    • Work with Localstack to emulate S3 for development and testing.
    • All s3 compatible cloud providers and emulators works with the extension.

Why Use It?

Whether you’re a developer, data scientist, or system administrator, the AWS S3 extension simplifies your workflow with an intuitive, user-friendly interface designed to make S3 resource management faster and more convenient.

Sponsor Me

If you find this extension useful, you can sponsor me on GitHub.

Survey

Please take this survey to help me make the extension better.
https://bit.ly/s3-extension-survey

Explorer

Explorer is the main view of the extension. It lists all the files and folders in the selected bucket. screenshoot

Search Function

Search for files and folders by name and extension listed in the explorer. Subfolders are not searched. Search is case insensitive. screenshoot

Buckets & Shortcuts

To add a bucket click on the + button. Then enter part of your bucket name or leave it empty to get all your buckets. Then select buckets to add and click Add. You can add a shortcut for frequently accessed files or folders. screenshoot

File View

screenshoot

Folder View

screenshoot

Search View

You can search for files including subfolders. you can use file/folder name, extension or key to search. By clicking the item on the results, you can go to the s3 explorer. To open search view click on the Search button on the explorer or magnify icon on the treeview bucket item. You can search for the entire bucket or a specific folder. screenshoot

Edit Menu

screenshoot

Copy Menu

screenshoot

Endpoint Url

You can change your aws endpoint url here. To connect your localstack use the following url: http://localhost:4566 screenshoot

Aws Credentials Setup

To Access Aws, you need to configure aws credentials.

For more detail on aws credentials
https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html
https://www.youtube.com/watch?v=SON8sY1iOBU

Extension supports all types of credentials. It searches for aws credentials in the following order:

  • Environment Variables:

    • AWS_ACCESS_KEY_ID
    • AWS_SECRET_ACCESS_KEY
    • AWS_SESSION_TOKEN (optional, for temporary credentials)
  • Shared Credentials File:

    • ~/.aws/credentials (default profile or a named profile)
    • ~/.aws/config (for region settings)
  • Amazon EC2 Instance Metadata Service (IMDS):

  • Amazon ECS Container Credentials:

    • When running in an ECS task, the SDK retrieves credentials from the container metadata URI (provided by ECS agent).
  • SSO Credentials:

    • If you've configured SSO using the AWS CLI, the SDK will attempt to retrieve credentials from your SSO login session.
  • Web Identity Token (IAM Roles for Service Accounts):

    • For federated identity access, such as AWS IAM roles for Kubernetes (EKS).

Bug Report

To report your bugs or request new features, use link below
https://github.com/necatiarslan/aws-s3/issues/new

Todo

  • S3 Select Support
  • Stick to Profile or Workspace
  • Add "Calculate Folder Size" Button but folder view and show folder size and object count
  • Show warning when item is more then 1000
  • Drag/Drop files and folders to upload
  • Show progressbar when uploading, downloading, deleting etc
  • (node:59796) NOTE: The AWS SDK for JavaScript (v2) is in maintenance mode. SDK releases are limited to address critical bug fixes and security issues only. Please migrate your code to use AWS SDK for JavaScript (v3). For more information, check the blog post at https://a.co/cUPnyil (Use Code Helper (Plugin) --trace-warnings ... to show where the warning was created)
  • Sunsetting the Webview UI Toolkit, migrate to alternative
  • NoSuchBucket: The specified bucket does not exist handle error and show error message

Nice To Have

  • Use vscode icons for files and folders
  • Auto refresh option
  • Paging (now max 1000)
  • Sort By Name / Type
  • Write Selected File and Folder count to the bottom
  • Filter by Date/Size
  • Multiple S3 Explorer
  • Highlight Icons On Hover
  • Freeze top bar
  • Fix: Cannot read properties of null (reading '_panel')
  • S3.getBucketAcl to get permissions and enable/disable command buttons
  • Local folder sync

Follow me on linkedin to get latest news
https://www.linkedin.com/in/necati-arslan/

Thanks,
Necati ARSLAN
[email protected]

Other Extensions

About

Aws S3 Extension for VsCode

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published