Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ChrisMcKenzie/dropship
Super simple deployment tool
https://github.com/ChrisMcKenzie/dropship
automation cd deploy deployment dropship hcl shipit shipping
Last synced: about 2 months ago
JSON representation
Super simple deployment tool
- Host: GitHub
- URL: https://github.com/ChrisMcKenzie/dropship
- Owner: ChrisMcKenzie
- License: apache-2.0
- Created: 2015-09-03T23:09:19.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2018-07-25T21:03:58.000Z (over 6 years ago)
- Last Synced: 2024-10-28T15:45:27.056Z (about 2 months ago)
- Topics: automation, cd, deploy, deployment, dropship, hcl, shipit, shipping
- Language: Go
- Homepage: https://chrismckenzie.io/posts/deploy-anything/
- Size: 17.8 MB
- Stars: 64
- Watchers: 4
- Forks: 12
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go-extra - dropship - 09-03T23:09:19Z|2018-07-25T21:03:58Z| (Go Tools / DevOps Tools)
README
# Dropship [](https://app.wercker.com/project/bykey/5d41eb9b54b132fe61de62acc6ee5f37) [  ](https://bintray.com/chrismckenzie/deb/dropship/_latestVersion) [](https://gitter.im/ChrisMcKenzie/dropship?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
Dropship is a simple tool for installing and updating artifacts from a CDN.
## Features
- Automatically performs md5sum checks of artifact that is on server and remote
and will download automatically
- Distributed sequential updates
- Multiple Artifact Repository Support
## Installation
To install on ubuntu do the following:
```
echo "deb http://dl.bintray.com/chrismckenzie/deb trusty main" >> /etc/apt/sources.list
sudo apt-get update
sudo apt-get install dropship
```
## Configuration
To setup dropship you will need to add/update the following files.
First you will need to tell dropship how to connect to your artifact repository
so you will need to uncomment out the desired repo and fill in its options.
_/etc/dropship.d/dropship.hcl_
```hcl
# vim: set ft=hcl :
# Location that service config will be read from
service_path = "/etc/dropship.d/services"
# Rackspace Repo Config
# =====================
repo "rackspace" {
user = ""
key = ""
region = ""
}
repo "s3" {
accessKey = ""
secret = ""
name = "us-west-1"
endpoint = "https://s3-us-west-1.amazonaws.com"
}
```
You will then have to create a file in the services directory of dropship. this
will tell dropship how to check and install you artifact. You can have multiple
`service` definitions in one file or multiple files.
_/etc/dropship.d/services/my-service.hcl_
```hcl
# vim: set ft=hcl :
service "my-service" {
# Use a semaphore to update one machine at a time
sequentialUpdates = true
# Check for updates every 10s
checkInterval = "10s"
# Run this command before update starts
before "script" {
command = "initctl my-service stop"
}
# Artifact defines what repository to use (rackspace) and where
# your artifact live on that repository
artifact "rackspace" {
bucket = "my-container"
path = "my-service.tar.gz"
destination = "./test/dest"
}
# After successful update send an event to graphite
# this allows you to show deploy annotations in tools like grafana
#
# The graphite hook will automatically add this services name into the
# graphite tags. You also have access to all of the services meta data
# like Name, "current hash", hostname.
after "graphite-event" {
host = "http://"
tags = "deployment"
what = "deployed to {{.Name}} on {{.Hostname}}"
data = "{{.Hash}}"
}
# Run this command after the update finishes
after "script" {
command = "initctl my-service start"
}
}
```
## Building
- install go 1.5.1
- clone repo
- run `go get ./...`
- run `go build -o dropship main.go`
## Roadmap
- [X] Hooks
- [X] Support for Amazon S3
- [ ] Support for different file types docker _(currently only tar.gz, and simple files)_
- [ ] Reporting system
- [ ] Redis, etcd for semaphore