The Chef Server
Erlang Ruby PLpgSQL HTML Shell Lua Other
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.delivery Unpin terraform version Jan 31, 2018
.expeditor Removed deprecated maintainer_group config from expeditor config Aug 1, 2018
.github Add a github PR template Aug 1, 2018
ci Only run smoke tests on s390x Aug 8, 2017
cookbooks/chef-server-deploy Update custom resource in chef-server-deploy. Jul 19, 2018
dev Remove old github changelog generator Aug 15, 2018
doc [SUSTAIN-632] Do not update the users table to contain the public key. Sep 18, 2017
external-deps system gem load support for dvm Aug 21, 2015
inspec/chef-server-smoke InSpec smoke test improvements (#1423) Nov 9, 2017
oc-chef-pedant Merge pull request #1520 from chef/ma/update_version_pins Jul 12, 2018
omnibus Remove old github changelog generator Aug 15, 2018
scripts Update terraform to 0.11.2 Jan 29, 2018
src Update bifrost_sup to use envy instead of application:get_env Aug 13, 2018
terraform Update terraform to 0.11.2 Jan 29, 2018
.gitignore Adding Habitization - supersedes PR#1416 Feb 22, 2018
.mailmap Update Marc's mailmap entry Feb 16, 2017
.travis.yml Pin ci-studio-common to pre-1.0 branch. Jul 17, 2018
CHANGELOG.md Bump version to 12.18.6 by Chef Expeditor Aug 15, 2018
CODE_REVIEW_CHECKLIST.md Enable chef-server in ACC Aug 2, 2017
CONTRIBUTING.md Add a CODE_REVIEW_CHECKLIST.md May 18, 2017
LICENSE Pulled the bootstrap portion out of opscode-test. Nov 3, 2014
MAINTAINERS.md Add Nolan and Prajakta as maintainers Jul 12, 2018
Makefile Use new argument format for veil-env-helper Mar 20, 2017
PRIOR_RELEASE_NOTES.md [release_notes] Move 12.7 release notes to PRIOR_RELEASE_NOTES Jul 6, 2016
README.md clean some items up in prep for primetime Feb 26, 2018
RELEASE_NOTES.md Prepare 12.18 Chef Server release. Jul 24, 2018
RELEASE_PROCESS.md Update the Release Process document Jul 23, 2018
VERSION Bump version to 12.18.6 by Chef Expeditor Aug 15, 2018
docker-compose.yml Expeditor cleanups after review with releng: May 4, 2018
habitat_pkgs_build.sh Cleaning up habitat build and fix chef-server-ctl build and gem loadi… Jul 25, 2018
omnibus_overrides.rb Update Ruby to 2.5.1 Jul 17, 2018

README.md

Chef Server

Build Status

This repository is the central repository for the Chef server.

If you want to file an issue about Chef Server or contribute a change, you're in the right place.

If you need to file an issue against another Chef project, you can find a list of projects and where to file issues in the community contributions section of the Chef docs.

Components of the Chef Server

This repository contains the core services that make up the Chef Server.

|-- oc-chef-pedant: A comprehensive test suite for the Chef Server API
|-- omnibus: Omnibus build configuration for the Chef Server
|-- scripts: Utility scripts
`-- src
    |-- bookshelf: S3-compatible engine for storing cookbook data
    |-- chef-mover: data migration orchestrator used in upgrades
    |-- oc-id: OAuth2 provider for extensions like Analytics or Supermarket
    |-- oc_bifrost: Chef Server's authorization service
    |-- oc_erchef: The core REST API server
    `-- opscode-expander: a service that transforms Chef data before sending it to Solr for indexing

Working on the Chef Server

The quickest way to get a Chef Server development environment is to follow the instructions in the dev directory. This environment is based on Vagrant and features hot reloading of code.

Building a Chef Server package locally:

You can build a Chef Server package locally with vagrant and test-kitchen.

cd omnibus/
make dev dev-build

Once the build is complete, the package should be in omnibus/pkg. By default the dev-build target will create an Ubuntu 10.04 build.

Habitized Chef Server

The following components now exist as Habitat packages and are available here:

  • nginx
  • bookshelf
  • oc_id
  • oc_erchef
  • oc_bifrost
  • chef-server-ctl

To build the packages locally:

./habitat_pkgs_build.sh

A top-level docker-compose.yml file exists for running Chef Server from Habitized Docker images:

docker-compose down && docker system prune --volumes -f && docker-compose up

Running pedant tests:

docker-compose exec chef-server-ctl chef-server-test

Running chef-server-ctl:

docker-compose exec chef-server-ctl chef-server-ctl command (subcommands)

Dependencies contained in other repositories

  • knife-ec-backup, used to ease migrations from Open Source Chef Server 11 (and below)
  • knife-opc, used to provide administrative command-line control to the Chef Server from the console

Major Technologies used in Chef Server

  • Erlang
  • PostgreSQL
  • RabbitMQ
  • Redis
  • Solr4
  • Nginx (openresty with lpeg library addition)
  • Runit for service supervision

If you're looking to contribute to certain parts of the Chef server, familiarity with the following related tools is also beneficial, depending on the area.

  • rebar (used for dependency management in Erlang)
  • sqitch (database migrations)
  • lua (routing rules in openresty)

ACC Pipeline & Chef Expeditor

Chef Software, Inc. leverages an internal Chef Automate installation, commonly referred to as ACC, to "drink our own champagne" and easily test and leverage builds of our products as they are created. The chef/chef-server repository, like many other Chef Software repositories, leverages an internal utility called Chef Expeditor to create a pub-sub model of actions across our various CI/CD utilities.

One of those actions is creating a change in our internal Chef Automate instance every time we successfully generate an omnibus build of Chef Server. This change allows us to easily perform a complex matrix of test suites, followed by a deployment to our internal Chef Server that we use to drive our internal infrastructure. While there is code to support this pipeline in the repository (.delivery/**, terraform/**, and cookbooks/chef-server-deploy/**), this repository does not depend on Chef Automate to handle pull requests.

The resources listed above that drive this pipeline, while open source, are not intended or supported for use outside of ACC as they have dependencies that are unique to Chef Software. However, please feel free to reference them for your own implementations. If you have any questions about these resources, please feel free to reach out in the Chef Community Slack.

Contributing

For information on contributing to this project see https://github.com/chef/chef/blob/master/CONTRIBUTING.md

License & Authors

Copyright: 2008-2018, Chef Software, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.