Metadata-Version: 2.1
Name: cloud-ssh-config
Version: 0.2.0
Summary: cloud_ssh_config generates ssh config file content from given cloud service
Home-page: https://github.com/DmitriyLyalyuev/cloud_ssh_config
Author: Dmitriy Lyalyuev
Author-email: dmitriy@lyalyuev.info
License: MIT
Keywords: ssh aws devops sysadmin
Platform: UNKNOWN
Classifier: Environment :: MacOS X
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
Requires-Dist: boto3
Requires-Dist: python-digitalocean

# Autocomplete SSH hosts for AWS

## Setup autocompletion

To get it working you need to install `bash-completion` and `boto3` python library.

On MacOS X run:

    $ brew install bash-completion

Create symlink to `.bash_autocompletion` file in your home folder:

    $ ln -sf  $(pwd)/.bash_autocompletion ~/

Import `.bash_autocompletion` in your `~/.bashrc`:

    $ echo 'source ~/.bash_autocompletion' >> ~/.bashrc
    $ . ~/.bash.rc

## Installing

The easiest way to install cloud_ssh_config is to use pip:

    $ pip install cloud_ssh_config

or from sources:

    $ git clone https://github.com/DmitriyLyalyuev/cloud_ssh_config.git
    $ cd cloud_ssh_config
    $ python3 setup.py install

## Generating/updating ssh config

Create for ssh `config.d` folder:

    $ mkdir -p ~/.ssh/config.d

To generate or update ssh config for AWS hosts run:

    cloud_ssh_config aws > ~/.ssh/config.d/aws

Use `-h` or `--help` key to get help and options.

## Usage

To test autocompletion enter in terminal:

    $ ssh host_[TAB]


## Supported cloud providers

### AWS

To get it working you need to run:

    $ pip install awscli
    $ aws configure

Enter your credentials to get access to the AWS API.

Or you can use [environment variables](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/configuration.html#environment-variable-configuration).


