The Conch API as it existed on the day I left Joyent https://github.com/joyent/conch
|Karen Etheridge 49826ec593 Merge pull request #885 from joyent/ether/v3-collapse-validation_result-more||4 months ago|
|bin||4 months ago|
|dev||5 months ago|
|docker||4 months ago|
|docs||4 months ago|
|etc||1 year ago|
|json-schema||4 months ago|
|lib||4 months ago|
|misc||4 months ago|
|report||5 months ago|
|smf||5 months ago|
|sql||4 months ago|
|t||4 months ago|
|templates||4 months ago|
|.dockerignore||5 months ago|
|.gitattributes||5 months ago|
|.gitignore||5 months ago|
|.mailmap||1 year ago|
|.perlcriticrc||1 year ago|
|.perltidyrc||1 year ago|
|CODEOWNERS||5 months ago|
|Dockerfile||5 months ago|
|Dockerfile.dev||5 months ago|
|LICENSE||8 months ago|
|Makefile||4 months ago|
|README.md||4 months ago|
|conch.conf.dist||4 months ago|
|cpanfile||4 months ago|
|cpanfile.snapshot||4 months ago|
|docker-compose.yml||5 months ago|
|schema-loader.yaml||5 months ago|
Conch helps you build and manage datacenters.
Conch's goal is to provide an end-to-end solution for full datacenter resource lifecycle: from design to initial power-on to end-of-life for all components of all devices.
Conch is open source, licensed under MPL2.
The API is in a constant state of flux. Contact the development team before attempting to use it directly. The conch shell is our current stable interface.
We currently support SmartOS 17.4 and Docker/Ubuntu. Being a Perl app, the API should run most anywhere but the code is only actively tested on SmartOS and Docker/Ubuntu.
The API is only certified to run against Perl 5.26.
Below is a list of useful Make commands that can be used to build and run the project. All of these should be run in the top level directory.
make run-- Build the project and run it
make test-- Run tests
make migrate-db-- Run database migrations
conch.conf, modifying for any local parameters,
including database connectivity information.
The most simple way to get going with the Conch API is to use Docker Compose.
First, build the image locally using
conch.conf, modifying for any local parameters.
Specifically search for 'docker' in the comments. Ignore the database
# Edit compose file for desired release docker-compose up -d postgres # initialize the postgres database docker-compose run --rm web bin/conch-db all --username conch --email email@example.com --password kaewee3hipheem8BaiHoo6waed7pha docker-compose run --rm web bin/conch-db create-global-workspace docker-compose up -d
docker-compose down # Edit compose file for desired release docker-compose pull docker-compose up -d postgres docker-compose run --rm web bin/conch-db migrate docker-compose up -d
There may be extra commands to run, depending on the specific release. In that case, the upgrade will look something like:
docker-compose down # Edit compose file for desired release docker-compose pull docker-compose up -d postgres docker-compose run --rm web bin/conch-db migrate docker-compose run --rm web bin/conch upgrade_release_225 docker-compose up -d
Copyright Joyent, Inc.
This Source Code Form is subject to the terms of the Mozilla Public License, v.2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.