Kubernetes Pipelines
Updated 2 years ago
by
Admin
This tutorial will help you create and execute a simple Kubernetes pipeline. Please see our pipeline documentation for detailed usage instructions.
Step 1: Authenticate
First, navigate to your Drone server URL in your browser. If you are not already authenticated, Drone will redirect you to GitHub to login.
After login you are redirected back to your Drone dashboard. If this is your first time using Drone your dashboard will be empty for a few seconds while Drone synchronizes your repository list with GitHub.
Step 2: Enable your Repository
Next, search for your repository and click the Enable button. Clicking the enable button adds a webhook to your repository to notify Drone every time you push code. Please note you must have admin privileges to the repository to enable.
Step 3: Configure your Pipeline
Next, you need to configure a pipeline by creating a .drone.yml file to the root of your git repository. In this file we define a series of steps that are executed every time a webhook is received.
kind: pipeline
type: kubernetes
name: default
steps:
- name: greeting
image: alpine
commands:
- echo hello
- echo world
Here is a quick overview of the variables used in this example:
- kind
The kind attribute defines the kind of object. This example defines a pipeline object. Other kinds of object are secret and signature objects.
- type
The type attribute defines the type of pipeline. This example defines a Kubernetes pipeline where each pipeline step is executed inside a Pod. Drone supports different types of pipeline execution environments.
- name
The name attribute defines a name for your pipeline. You can define one or many pipelines for your project.
- steps
The steps section defines an array of pipeline steps that are executed serially. If any step in the pipeline fails, the pipeline exits immediately.- name
The name attribute defines the name of the pipeline step.
- image
The image attribute defines a container image in which the shell commands are executed. You can use any image in your pipeline from any registry, including private registries.
- commands
The commands attribute defines a list of shell commands that are executed inside a container as the entrypoint. If any command returns a non-zero exit code the pipeline step fails.
- name
Please see our pipeline documentation for a full list of configuration options.
Additional Examples
- You can add multiple steps to your pipeline:
kind: pipeline
type: kubernetes
name: greeting
steps:
- name: en
image: alpine
commands:
- echo hello world
- name: fr
image: alpine
commands:
- echo bonjour monde - You can limit pipeline steps based on branch or webhook event:
kind: pipeline
type: kubernetes
name: greeting
steps:
- name: en
image: alpine
commands:
- echo hello world
- name: fr
image: alpine
commands:
- echo bonjour monde
when:
branch:
- develop - You can even define multiple pipelines:
kind: pipeline
type: kubernetes
name: en
steps:
- name: greeting
image: alpine
commands:
- echo hello world
---
kind: pipeline
type: kubernetes
name: fr
steps:
- name: greeting
image: alpine
commands:
- echo bonjour monde - You can use any image in any container registry:
kind: pipeline
type: kubernetes
name: default
steps:
- name: test
image: golang:1.13
commands:
- go build
- go test -v
Step 4: Execute your Pipeline
The final step is to commit your .drone.yml to your repository and push your changes. When you push code, GitHub sends a webhook to Drone which in turn executes your pipeline.
