xref: /conch/
Name Date Size #Lines LOC

..03-Dec-2018-

bin/H06-Dec-2018-

dev/H21-Jul-2018-

docker/H16-Feb-2019-

docs/H19-Dec-2018-

etc/H01-Nov-2018-

json-schema/H08-Feb-2019-

lib/H08-Feb-2019-

misc/H06-Feb-2019-

report/H31-Aug-2018-

smf/H21-Jul-2018-

sql/H30-Jan-2019-

t/H08-Feb-2019-

.dockerignoreH A D01-Nov-20186 21

.gitattributesH A D06-Dec-201883 43

.mailmapH A D08-Aug-2018438 87

.perlcriticrcH A D21-Jul-201845 21

.perltidyrcH A D21-Jul-201814 43

DockerfileH A D01-Feb-20191.7 KiB6550

Dockerfile.devH A D01-Feb-20191.5 KiB6348

LICENSEH A D30-Apr-201816.3 KiB374293

MakefileH A D06-Feb-20192.7 KiB8057

README.mdH A D19-Dec-20181.7 KiB6439

conch.conf.distH A D05-Feb-20193.9 KiB10888

cpanfileH A D08-Feb-20193.4 KiB10793

cpanfile.snapshotH A D08-Feb-2019105.7 KiB3,5403,539

schema-loader.yamlH A D01-Nov-2018664 3224

README.md

1# Conch API Server
2
3Conch helps you build and manage datacenters.
4
5Conch's goal is to provide an end-to-end solution for full datacenter resource
6lifecycle: from design to initial power-on to end-of-life for all components of
7all devices.
8
9Conch is open source, licensed under MPL2.
10
11## Caveat Emptor
12
13At the time of writing, the API is not considered to be stable. While we do our
14best to prevent breakage, the core is in considerable flux and we do not
15guarantee fit or function right now. The [conch
16shell](https://github.com/joyent/conch-shell) is our current stable interface.
17
18## Installation
19
20### Operating System Support
21
22We currently support SmartOS 17.4 and FreeBSD 11.2. Being a Perl app, the API
23should run most anywhere but the code is only actively tested on SmartOS and
24FreeBSD.
25
26### Perl Support
27
28The API is only certified to run against Perl 5.26.
29
30### Setup
31
32Below is a list of useful Make commands that can be used to build and run the
33project. All of these should be run in the top level directory.
34
35* `make run` -- Build the project and run it
36* `make test` -- Run tests
37* `make migrate-db` -- Run database migrations
38
39#### Needed Packages
40
41* PostgreSQL 9.6.x
42* Git
43* Perl, 5.26 or above (e.g. via [perlbrew](https://perlbrew.pl/))
44* [Carton](https://metacpan.org/dist/Carton)
45
46#### Configuration
47
48Copy `conch.conf.dist` to `conch.conf`, modifying for any local parameters,
49including database connectivity information.
50
51### Starting Conch
52
53* `make run`
54
55## Licensing
56
57Copyright Joyent, Inc.
58
59This Source Code Form is subject to the terms of the Mozilla Public License,
60v.2.0. If a copy of the MPL was not distributed with this file, You can obtain
61one at http://mozilla.org/MPL/2.0/.
62
63
64