Skip to main content

View instance information on all supported cloud providers

Project description

# cloudview
View instance information on all supported cloud providers

## Usage

```
Usage: cloudview [OPTIONS]
Options:
-d, --debug debug mode
-h, --help show this help message and exit
-o, --output text|html|json|JSON output type
-p, --port PORT run a web server on port PORT
-r, --reverse reverse sort
-s, --sort name|time|status sort type
-S, --status stopped|running|all filter by instance status
-T, --time TIME_FORMAT time format as used by strftime(3)
-V, --version show version and exit
Filter options:
--filter-aws NAME VALUE may be specified multiple times
--filter-azure FILTER Filter for Azure
--filter-gcp FILTER Filter for GCP
```

**NOTE**: Use `--output JSON` to dump _all_ available information received from each provider's SDK.

This script is best run with Docker to have all dependencies in just one packages, but it may be run stand-alone on systems with Python 3.4+

## To run stand-alone:

```
pip install --user cloudview
```

**NOTE**: You may need to upgrade `pip` before with `pip install --user --upgrade pip`.

## To run with Docker:

Build image with:
```
docker build -t cloud --pull .
```

Run with:
```
docker run --rm -v ~/.aws:/root/.aws:ro -v "$GOOGLE_APPLICATION_CREDENTIALS:$GOOGLE_APPLICATION_CREDENTIALS:ro" -e AZURE_TENANT_ID -e AZURE_SUBSCRIPTION_ID -e AZURE_CLIENT_SECRET -e AZURE_CLIENT_ID -e GOOGLE_APPLICATION_CREDENTIALS=/root/$(basename $GOOGLE_APPLICATION_CREDENTIALS) cloudview --status all --port 7777
```

To set up a web server showing this information running on port 7777:
```
docker run --rm -d -p 7777:7777 -v ~/.aws:/root/.aws:ro -v "$GOOGLE_APPLICATION_CREDENTIALS:$GOOGLE_APPLICATION_CREDENTIALS:ro" -e AZURE_TENANT_ID -e AZURE_SUBSCRIPTION_ID -e AZURE_CLIENT_SECRET -e AZURE_CLIENT_ID -e GOOGLE_APPLICATION_CREDENTIALS cloudview --status all --port 7777
```

## Run the web server with [Docker Compose](https://docs.docker.com/compose/install/):

```
docker-compose up -d
```

To stop the web server:
```
docker-compose down
```

To rebuild with latest version:
```
docker-compose build --pull
```

## TODO
- Search by tag
- Sort by instance type
- Use apache-libcloud?


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cloudview-0.1.15.tar.gz (7.7 kB view details)

Uploaded Source

Built Distribution

cloudview-0.1.15-py3-none-any.whl (11.3 kB view details)

Uploaded Python 3

File details

Details for the file cloudview-0.1.15.tar.gz.

File metadata

  • Download URL: cloudview-0.1.15.tar.gz
  • Upload date:
  • Size: 7.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.20.1 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.7

File hashes

Hashes for cloudview-0.1.15.tar.gz
Algorithm Hash digest
SHA256 de1c35a70284eb6f46f5a9cafdffe0c3bf1e73ca8edbf984187082acf59bbeca
MD5 44aea48e6f42250394d2ae3aa05b66fc
BLAKE2b-256 70d11b8b11a9d8bccfd5757d1b9968b9289d343f66c82628a77056f08ac1786e

See more details on using hashes here.

File details

Details for the file cloudview-0.1.15-py3-none-any.whl.

File metadata

  • Download URL: cloudview-0.1.15-py3-none-any.whl
  • Upload date:
  • Size: 11.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.20.1 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.7

File hashes

Hashes for cloudview-0.1.15-py3-none-any.whl
Algorithm Hash digest
SHA256 a940feed1162b13c5e166f786886fff0a77f025909d127841de54e53da70668b
MD5 6c2f3f19ff8d233ef9350e79cb4543d6
BLAKE2b-256 87b4c62e63018833c0b46375e14c01a90221dc30549225dd9ef66e796bb46d4d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page