Cinc Zero

Description

Cinc Zero is a simple, easy-install, in-memory Cinc server that can be useful for Cinc Client testing and cinc-solo-like tasks that require a full Cinc Server. It IS intended to be simple, easy to run and fast to start. It is NOT intended to be secure, scalable, performant or persistent. It does NO input validation, authentication or authorization (it will not throw a 400, 401 or 403). It does not save data, and will start up empty each time you start it.

Because Cinc Zero runs in memory, it's super fast and lightweight. This makes it perfect for testing against a "real" Cinc Server without mocking the entire Internet.

Installation

This server can be installed as a Ruby Gem.

$ gem install chef-zero

If you're using bundler, add chef-zero as a development dependency:

group :development do
  gem 'chef-zero'
end

Or in a .gemspec

s.add_development_dependency 'chef-zero'

You can also clone the source repository and install it using rake install.

Usage

One of cinc-zero's primary uses is as a small test server for people writing and testing clients. Here's a simple example of starting it up:

require 'chef_zero/server'
server = ChefZero::Server.new(port: 4000)
server.start

This will create a server instance in the foreground. To stop the server:

server.stop

This is great for debugging and logging requests, but you'll probably want to run this in the background so you have full control of your thread.

To run Cinc Zero in the background, simply issue the start_background command:

require 'chef_zero/server'
server = ChefZero::Server.new(port: 4000)
server.start_background

You can stop the server the same way:

server.stop

Valid Options

You may currently pass the following options to the initializer:

• host - the host to run on (Default: '127.0.0.1')
• port - the port to run on (Default: 8889)
• debug - run in debug mode to see all requests and responses (Default: false)

CLI (Command Line)

If you don't want to use Cinc Zero as a library, you can simply start an instance with the included cinc-zero executable:

$ cinc-zero

Note, this will run in the foreground.

You now have a fully functional (empty) Cinc Server running.

To try it out, go into the cinc-zero/playground directory and run knife. It will behave the same as a normal Cinc Server, and all normal knife commands will work (show, list, delete, from file, upload, download, diff ...). For example, you can upload everything in the repo:

cinc-zero/playground> knife upload .
Created nodes/desktop.json
Created data_bags/dns
Created environments/production.json
Created nodes/lb.json
Created nodes/dns.json
Created nodes/ldap.json
Created nodes/www.json
Created data_bags/dns/services.json
Created environments/staging.json
Created data_bags/passwords
Created data_bags/users
Created data_bags/users/jkeiser.json
Created data_bags/passwords/github.json
Created data_bags/passwords/twitter.json
Created data_bags/users/schisamo.json
Created data_bags/users/sethvargo.json
Created cookbooks/apache2
Created cookbooks/php

cinc-zero/playground> knife environment list
_default
production
staging

To use it in your own repository, create a knife.rb like so:

chef_server_url   'http://127.0.0.1:8889'
node_name         'stickywicket'
client_key        'path_to_any_pem_file.pem'

And use knife like you normally would.

Since Cinc Zero does no authentication, any .pem file will do. The client just needs something to sign requests with (which will be ignored on the server). Even though it's ignored, the .pem must still be a valid format.

Now, stop the Cinc Zero server and all the data is gone!

Run cinc-zero --help to see a list of the supported flags and options:

Usage: cinc-zero [ARGS]
    -H, --host HOST                  Host to bind to (default: 127.0.0.1)
    -p, --port PORT                  Port to listen on (e.g. 8889, or 8500-8600 or 8885,8888)
        --[no-]generate-keys         Whether to generate actual keys or fake it (faster).  Default: false.
    -d, --daemon                     Run as a daemon process
    -l, --log-level LEVEL            Set the output log level
        --log-file FILE              Log to a file
        --enterprise                 Whether to run in enterprise mode
        --multi-org                  Whether to run in multi-org mode
        --file-store PATH            Persist data to files at the given path
        --[no-]ssl                   Use SSL with self-signed certificate(Auto generate before every run).  Default: false.
    -h, --help                       Show this message
        --version                    Show version

Contributing

For information on contributing to this project see https://gitlab.com/cinc-project/chef-zero

License

Copyright:: Chef Software, Inc. and Cinc Project contributors.

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

    https://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.

Copyright

See COPYRIGHT.md.