lbordowitz / guide

Screwdriver.cd Documentation

Home Page:http://docs.screwdriver.cd

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Screwdriver Guide

Build Status Open Issues

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.

To start using Screwdriver

For more information about Screwdriver, check out our homepage.

To start contributing to Screwdriver

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.

Standard

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.5.0

Viewing docs locally

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.

Standard

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.

Browse your local guide

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.

Adding docs

Simply add a new markdown document to the folder hierarchy in docs, and add an entry to the tree in docs/_data/menu.yaml

Documentation Structure

  • 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

About

Screwdriver.cd Documentation

http://docs.screwdriver.cd


Languages

Language:Ruby 85.1%Language:Shell 14.9%