https://github.com/controlplaneio/grafeas-docker

Dockerfiles and compose file for containerised Grafeas
https://github.com/controlplaneio/grafeas-docker

Last synced: 11 days ago
JSON representation

Dockerfiles and compose file for containerised Grafeas

• Host: GitHub
• URL: https://github.com/controlplaneio/grafeas-docker
• Owner: controlplaneio
• License: mit
• Created: 2018-05-03T13:34:10.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2018-08-19T16:08:30.000Z (over 6 years ago)
• Last Synced: 2024-11-18T04:47:40.850Z (2 months ago)
• Language: Shell
• Size: 8.71 MB
• Stars: 3
• Watchers: 7
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# grafeas-docker

This is a Docker Compose project to provide a self contained instance of Google's [Grafeas](https://grafeas.io/) server using a Postgres SQL as the persistence layer.

## Getting Started

The quickest way to get started, if you just want a Grafeas server to

experiment with, is the Docker Compose method, below.

There is also a Makefile, which is working towards something that can be used

in production, but it isn't working yet.

### Prerequisites

You will require a current version of Docker and Docker Compose, and a means to

test the Grafeas server such as their

[Python](https://github.com/grafeas/client-python) or

[Go](https://github.com/grafeas/client-go) client libraries. Using cURL may be

sufficient for your needs, too..

### Installing

#### Using the Docker Compose Method

The Docker Compose file requires an environment file to pass in the passwords

for Postgres and Grafeas. They will get configured on first execution of the

application, and then used thereafter.

Create the `.env` file and generate passwords like so:

```

tee .env > /dev/null < make build

* If you have not set up the Grafeas network run:

> make run-prod-network

* To run the Grafeas server and the Postgres database run: 

> make run

There is also a utility script called 'run_local_postgres.sh' that will do the following:

1. Run the Postgres image locally (as 'postgres_local') and expose port 5432 on the Grafeas network.

2. Run the very useful [PGAdmin](https://www.pgadmin.org/) tool on port 8888 to allow debugging of Grafeas database transactions. 

## Built With

This software was built and tested on MacOS High Sierra using:

* Docker for Mac 18.03 CE

* Docker Compose 1.21

Subsequent modifications were built and tested on **Arch Linux** using:

* Docker 18.05.0-ce

* Docker Compose 1.22.0

...and used in workshop on CentOS 7 using:

* Docker 17.06.02

* Docker Compose 1.11.2

## Dependencies

* The official [Grafeas](https://github.com/grafeas/grafeas) project

## Contributing

Pull requests and suggestions are welcome; please submit via GitHub.

## Versioning

No release version exists yet, use the 'master' branch.

## Authors

Colin Domoney [@colindomoney](https://twitter.com/colindomoney?lang=en)

Luke Bond [@lukebond](https://twitter.com/lukebond?lang=en)

## License

This software is released under the

[MIT licence](https://github.com/controlplaneio/grafeas-docker/blob/master/LICENSE)

## Acknowledgments