Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/binocarlos/viking
Docker platform with a node.js vendetta
https://github.com/binocarlos/viking
Last synced: 10 days ago
JSON representation
Docker platform with a node.js vendetta
- Host: GitHub
- URL: https://github.com/binocarlos/viking
- Owner: binocarlos
- Created: 2014-08-04T21:36:00.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2015-05-03T20:16:15.000Z (over 9 years ago)
- Last Synced: 2024-04-14T14:36:48.847Z (7 months ago)
- Language: Shell
- Size: 293 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# viking
Infrastructure management for docker stacks
## developer
First you need to install:
* [git](http://git-scm.com/downloads)
* [virtualbox](https://www.virtualbox.org/wiki/Downloads)
* [vagrant](http://www.vagrantup.com/downloads.html)
Then open a command line (windows or mac or linux).
Then change directory to where you keep projects e.g. `cd projects`.
Then we need to clone the source code:
```
$ git clone https://github.com/binocarlos/viking
$ cd viking
```
### start vm
We use vagrant to start and stop virtualbox vms - to start the VM:
```bash
$ cd viking
$ vagrant up
```
This will start a vagrant box and install dependencies.
### ssh to vm
Once the Vagrant box has started - we need a command line for it so we SSH into the box.
```bash
$ vagrant ssh
```
NOTE: on Windows you will need to install [Putty](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) and use Puttygen (download from the same page) to convert the vagrant public key.
A [guide](https://github.com/Varying-Vagrant-Vagrants/VVV/wiki/Connect-to-Your-Vagrant-Virtual-Machine-with-PuTTY) for how to do this is [here](https://github.com/Varying-Vagrant-Vagrants/VVV/wiki/Connect-to-Your-Vagrant-Virtual-Machine-with-PuTTY)
### cd to /vagrant
Once you have a command line to the box - change directory to where this repo is mounted as a shared folder - `/vagrant`
```bash
$ cd /vagrant
$ ls -la
```
### viking
There is an admin script that will manage the stack for development:
```bash
$ viking help
```
### create
Create a new project at path - this will automatically call configure
```bash
$ viking create
```
### configure
This gets a project configured.
```bash
$ viking configure
```
### vars
You can manually set variables in the .viking file inside the project folder
```bash
$ cat myproject/.viking
API_VERSION=v1
```
### start services
```bash
$ viking up
```
### stop services
```bash
$ viking down
```
### show service status
```bash
$ viking status
```
### view app in browser
A port is mounted onto the host so you can enter `http://127.0.0.1:8080` into a browser once you have started the services.
### build client assets
The client CSS and JS is bundled - use the admin bundle command to rebuild it
```bash
$ viking build
```
## config
You can configure the variables for viking itself by setting values in the `/etc/viking/config` file.
## tests
There are various types of test:
* acceptance tests - test the whole system against cloud instances
* integration tests - test parts of the system working together
* unit tests - test isolated unit of the system
To run the acceptance tests you must have vagrant and virtualbox installed and SSH into the VM:
```bash
$ vagrant up
$ vagrant ssh
vagrant$ cd /vagrant
```
### acceptance tests
To run the acceptance tests - the following variables must be configured:
```bash
cloud provider vars here
```
You can `viking configure` to enter these values.
```bash
$ viking test acceptance
```
will run the acceptance tests
### integration tests
```bash
$ viking test integration
```
### unit tests
```bash
$ viking test unit
```
### all tests
```bash
$ viking test all
```