Skip to content

Commit

Permalink
add install instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
jdolitsky committed Jan 13, 2019
1 parent 25ef767 commit c807e38
Showing 1 changed file with 18 additions and 8 deletions.
26 changes: 18 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,16 +4,26 @@

This tool will attempt to detect any charts that may have been uploaded via [this vulnerability](https://need-a-link), affecting all versions of [ChartMuseum](https://github.com/helm/chartmuseum) <= 0.8.0.

## Installation

Install via go get:

```
go get -u github.com/jdolitsky/chart-scanner/cmd/chart-scanner
```

## Usage

Command-line storage options are identical to the ones used in ChartMuseum (the package is imported and re-used).

See all available options with `chart-scanner --help`.

### Using with Amazon S3

Make sure your environment is properly setup to access `my-s3-bucket`

```bash
chart-scanner \
chart-scanner --debug \
--storage="amazon" \
--storage-amazon-bucket="my-s3-bucket" \
--storage-amazon-prefix="" \
Expand Down Expand Up @@ -56,7 +66,7 @@ export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/[FILE_NAME].json"
More info on Google Cloud authentication can be found [here](https://cloud.google.com/docs/authentication/getting-started).

```bash
chart-scanner \
chart-scanner --debug \
--storage="google" \
--storage-google-bucket="my-gcs-bucket" \
--storage-google-prefix=""
Expand All @@ -71,7 +81,7 @@ To do so, you must set the following env vars:
- `AZURE_STORAGE_ACCESS_KEY`

```bash
chart-scanner \
chart-scanner --debug \
--storage="microsoft" \
--storage-microsoft-container="mycontainer" \
--storage-microsoft-prefix=""
Expand All @@ -86,7 +96,7 @@ To do so, you must set the following env vars:
- `ALIBABA_CLOUD_ACCESS_KEY_SECRET`

```bash
chart-scanner \
chart-scanner --debug \
--storage="alibaba" \
--storage-alibaba-bucket="my-oss-bucket" \
--storage-alibaba-prefix="" \
Expand All @@ -105,7 +115,7 @@ To do so, you must set the following env vars (depending on your openstack versi
- `OS_PASSWORD`

```bash
chart-scanner \
chart-scanner --debug \
--storage="openstack" \
--storage-openstack-container="mycontainer" \
--storage-openstack-prefix="" \
Expand All @@ -119,7 +129,7 @@ Make sure your environment is properly setup to access `my-ocs-bucket`.
More info on Oracle Cloud Infrastructure authentication can be found [here](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/apisigningkey.htm).

```bash
chart-scanner \
chart-scanner --debug \
--storage="oracle" \
--storage-oracle-bucket="my-ocs-bucket" \
--storage-oracle-prefix="" \
Expand All @@ -135,7 +145,7 @@ To do so, you must set the following env vars:
- `BAIDU_CLOUD_ACCESS_KEY_SECRET`

```bash
chart-scanner \
chart-scanner --debug \
--storage="baidu" \
--storage-baidu-bucket="my-bos-bucket" \
--storage-baidu-prefix="" \
Expand All @@ -146,7 +156,7 @@ chart-scanner \
Make sure you have read access to `./chartstorage`.

```bash
chart-scanner \
chart-scanner --debug \
--storage="local" \
--storage-local-rootdir="./chartstorage"
```
Expand Down

0 comments on commit c807e38

Please sign in to comment.