Pipelines

The pipeline is the top-level structure defined in your atkins.yml file. It sets the context for all jobs: name, working directory, variables, and environment.

  Pipeline (atkins.yml)
├─ Job: build
│  ├─ Step: run tests
│  └─ Step: compile binary
├─ Job: deploy
│  ├─ Step: push image
│  └─ Step: apply config

Pipeline Fields

Field	Description
`name:`	Pipeline display name
`dir:`	Working directory for the pipeline
`vars:`	Pipeline-level variables available to all jobs
`env:`	Pipeline-level environment variables
`jobs:`	Job definitions (map of name → job)
`tasks:`	Alias for `jobs:` (Taskfile-style)

jobs: and tasks: are interchangeable. Use whichever style you prefer.

Examples

  name: Basic Pipeline

vars:
  version: 1.0.0
  app_name: myapp

jobs:
  build:
    aliases: [default]
    steps:
      - run: echo "Building ${{ app_name }}"
  test:
    steps:
      - run: echo "Testing ${{ app_name }}"

  name: Complete Pipeline
dir: /tmp

vars:
  version: 1.0.0
  app_name: myapp

env:
  vars:
    BUILD_ENV: production

jobs:
  build:
    aliases: [default]
    desc: Build the application
    steps:
      - run: echo "Building ${{ app_name }} v${{ version }}"
      - run: 'echo "Environment: $BUILD_ENV"'
  test:
    desc: Run tests
    steps:
      - run: echo "Testing ${{ app_name }}..."

Pipeline Fields

Examples

See Also