Documentation for the Screwdriver CD service
Screwdriver is a self-contained, pluggable service to help you build, test, and continuously deliver software using the latest containerization technologies.
For more information about Screwdriver, check out our homepage.
Have a look at our guidelines, as well as pointers on where to start making changes, in our contributing guide.
The guide is powered by Jekyll. In order to install Jekyll you'll need Ruby, the Ruby package manager (RubyGems), and bundle to install and run Jekyll. You can check if you have these already installed like so:
$ ruby --version
ruby 2.4.1
$ gem --version
2.6.12
$ bundle --version
Bundler version 1.15.1
Jekyll supports Ruby version 2.1 or above.
To install the jekyll
using bundle, making sure we're in the same directory as the Gemfile
.
Install the jekyll
package using bundler:
bundle install
You should now have the jekyll
command installed on your system. Run bundle exec jekyll --version
to check that everything worked okay.
$ bundle exec jekyll --version
jekyll 3.8.4
There's a single configuration file named _config.yml
, and a folder named docs
that will contain our documentation source files.
Jekyll comes with a built-in webserver that lets you preview your documentation as you work on it. You can start the webserver locally with Jekyll directly.
Jekyll comes with a built-in webserver that lets you preview your documentation as you work on it. We start the webserver by making sure we're in the same directory as the docs
folder, and then running the bundle exec jekyll serve --source docs --destination _site
command:
$ bundle exec jekyll serve --source docs --destination _site
Configuration file: docs/_config.yml
Source: docs
Destination: _site
Incremental build: disabled. Enable with --incremental
Generating...
done in 2.251 seconds.
Auto-regeneration: enabled for 'docs'
Server address: http://127.0.0.1:4000/
Server running... press ctrl-c to stop.
Once you successfully start the webserver, open up http://127.0.0.1:4000/ in your browser. You'll be able to see the index page being displayed. And you'll also be able to see the other language index page open up http://127.0.0.1:4000/:lang/ in your browser. For example, open up http://127.0.0.1:4000/ja/ in your browser, you'll be able to see the Japanese index page being displayed.
Simply add a new markdown document to the folder hierarchy in docs
, and add an entry to the tree in docs/_data/menu.yaml
- Homepage
- What are the sections for
- Cluster Management (for SD owners)
- Overall architecture
- Configuring API
- Scm plugins
- Datastore plugins
- Configuring UI
- Configuring Store
- Logging plugins
- Running locally
- Examples
- Setting up Kubernetes
- Debugging
- User Guide
- Quickstart
- API
- Authentication and Authorization
- Configuration
- Overall YAML
- Metadata
- Secrets
- Templates
- FAQ
- About
- What is SD?
- Appendix
- Domain model
- Execution engines
- Contributing
- Support