Skip to content

Commit ed6559f

Browse files
committed
moving some stuff around
1 parent b5dd2ba commit ed6559f

File tree

7 files changed

+41
-5
lines changed

7 files changed

+41
-5
lines changed

README.md

Lines changed: 35 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -25,13 +25,12 @@ Rabbit is a lightweight service that will build and store your go projects binar
2525

2626
## Documentation
2727

28-
### Installation:
29-
30-
### Config & Run The Application
28+
### Development:
3129

3230
Rabbit uses [Go Modules](https://github.com/golang/go/wiki/Modules) to manage dependencies. First Create a prod config file.
3331

3432
```bash
33+
$ git clone https://github.com/Clivern/Rabbit.git
3534
$ cp config.dist.yml config.prod.yml
3635
```
3736

@@ -125,13 +124,44 @@ $ ./rabbit -config=/custom/path/config.prod.yml
125124
$ go run rabbit.go -config=/custom/path/config.prod.yml
126125
```
127126

128-
Or [download a pre-built Rabbit binary](https://github.com/Clivern/Rabbit/releases) for your operating system.
127+
## Deployment
128+
129+
### On a Linux Server
130+
131+
Make sure you have `git`, `golang 1.12` and `goreleaser` installed, and make goreleaser executable from everywhere.
132+
133+
```bash
134+
# To download the latest goreleaser binary for linux (https://github.com/goreleaser/goreleaser/releases)
135+
$ curl -sL https://github.com/goreleaser/goreleaser/releases/download/v0.108.0/goreleaser_Linux_x86_64.tar.gz | tar xz
136+
```
137+
138+
Also make sure you are able to clone all your repositories in a non-interactive way. Just configure ssh-key and add the remote VCS to your known hosts.
139+
140+
Then download [the latest Rabbit binary.](https://github.com/Clivern/Rabbit/releases)
129141

130142
```bash
131143
$ curl -sL https://github.com/Clivern/Rabbit/releases/download/x.x.x/rabbit_x.x.x_OS.tar.gz | tar xz
132-
$ ./rabbit -config=config.prod.yml
133144
```
134145

146+
Create your config file as explained before on development part and run rabbit with systemd or anything else you prefer.
147+
148+
```
149+
$ ./rabbit -config=/custom/path/config.prod.yml
150+
```
151+
152+
### On Docker
153+
154+
Running rabbit with `docker-compose` is pretty straightforward.
155+
156+
```bash
157+
$ git clone https://github.com/Clivern/Rabbit.git
158+
$ cd Rabbit/deployments/docker-compose
159+
$ docker-compose build
160+
$ docker-compose up -d
161+
```
162+
163+
Docker will mount you host server `~/.ssh` directory in order to be able to clone repositories that need ssh key. Please make sure it has the right permissions and also remote VCS added to known hosts. otherwise rabbit will stuck on git interactive clone.
164+
135165
## Versioning
136166

137167
For transparency into our release cycle and in striving to maintain backward compatibility, Rabbit is maintained under the [Semantic Versioning guidelines](https://semver.org/) and release process is predictable and business-friendly.
File renamed without changes.
File renamed without changes.
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
*
2+
!.gitignore
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
*
2+
!.gitignore
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
*
2+
!.gitignore

0 commit comments

Comments
 (0)