congo

command module
v0.1.6 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 24, 2022 License: Apache-2.0 Imports: 4 Imported by: 0

README

congo logo img

Easy and unified way to connect from your terminal to AWS EC2 and ECS

🚀 Connect easily to EC2 and ECS using the same tool using an interactive CLI

congo cli example

🚀 Filter to find faster your resources

congo cli filter

🚀 Perfect for small or big AWS accounts

congo cli thousand


Go report card GitHub code size in bytes GitHub go.mod Go version GitHub release (latest by date)


Usage

Congo is really easy to use just run "ec2" or "ecs" and the cli will continue guiding you interactively from there:

congo ec2 [--id]
congo ecs

You can always run the command congo help to get a better understanding of each command.

Installation

  • Using brew:
brew tap PauSabatesC/congo https://github.com/PauSabatesC/congo
brew install congo
  • Install using go:
go install github.com/PauSabatesC/congo
  • Downloading the binaries:

You can install and run it just downloading your desired binary:

platform
macOS ARM
macOS 64 Bit
Linux 32-Bit
Linux ARM
Linux 64 Bit
Windows ARM
Windows 32 Bit
Windows 64 Bit

Then you can add the executable binary file downloaded into your PATH

  • Install the golang package to use it on your project:
go get github.com/PauSabatesC/congo/congo

Prerequisites

  • Congo uses AWS SSM to start a session in a EC2 instance in order to connect to it. So make sure your EC2 and IAM role passes the requisites to allow this secure connection.
  • Also congo uses aws CLI to exec to a container.
  • Congo detects automatically your AWS credentials from environment variables. So even if you exported the AWS key id,secret and token, or you exported you AWS_PROFILE it will work. Make sure though to export the desired AWS_REGION too.

Contributing

All kinds of Pull Requests are welcomed!

Credits

License

Congo is released under the Apache 2.0 license. See LICENSE.txt for more details.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL