Pkl

pkl is a configuration as code language with rich validation and tooling.

🚀 Usage

Add the following command to your CI configuration file:

fluentci run --wasm pkl eval config.pkl -f yaml -o config.yaml

Commands

Name	Description
setup	Install pkl.
eval	Render pkl module(s)
test	Run tests within the given module(s)

Code Examples

Add fluentci-pdk crate to your Cargo.toml:

[dependencies]
fluentci-pdk = "0.2.1"

Use the following code to call a module function:

use fluentci_pdk::dag;

// ...

dag().call("https://pkg.fluentci.io/[email protected]?wasm=1", "eval", vec!["config.pkl", "-f", "yaml", "-o", "config.yaml"])?;

CI/CD Integration

The following example demonstrates how to integrate pkl with popular CI providers to render a configuration file using pkl:

Github Actions

ci.yml

name: ci
on:
  push:
    branches:
      - main
jobs:
  tasks:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/testout@v2
      - name: Setup Fluent CI
        uses: fluentci-io/setup-fluentci@v5
        with:
          wasm: true
          plugin: pkl
          args: |
            eval config.pkl -f yaml -o config.yaml
      

GitLab CI

.gitlab-ci.yml

.docker:
  image: denoland/deno:debian-1.42.4
  services:
    - docker:${DOCKER_VERSION}-dind
  variables:
    DOCKER_HOST: tcp://docker:2376
    DOCKER_TLS_VERIFY: "1"
    DOCKER_TLS_CERTDIR: /certs
    DOCKER_CERT_PATH: /certs/client
    DOCKER_DRIVER: overlay2
    DOCKER_VERSION: 20.10.16
    GITLAB_ACCESS_TOKEN: $GITLAB_ACCESS_TOKEN
.fluentci:
  extends: .docker
  before_script:
    - apt-get update
    - apt-get install -y curl tar gzip ca-certificates openssl git unzip libncursesw6
    - deno install -A -r https://cli.fluentci.io -n fluentci 
    - fluentci --version 
    - curl -L https://dl.dagger.io/dagger/install.sh | DAGGER_VERSION=0.12.3 sh 
    - mv bin/dagger /usr/local/bin 
    - dagger version
eval:
  extends: .fluentci
  script: 
    - fluentci run --wasm pkl eval config.pkl -f yaml -o config.yaml

Circle CI

.circleci/config.yml

version: 2.1
jobs:
  job:
    steps:
      - testout
      - run: |
          sudo apt-get update && sudo apt-get install -y curl unzip
          curl -fsSL https://cli.fluentci.io | bash
          fluentci --version
        name: Setup FluentCI
      - run: fluentci run --wasm pkl eval config.pkl -f yaml -o config.yaml
        name: eval
    machine:
      image: ubuntu-2004:2023.07.1
workflows:
  fluentci:
    jobs:
      - job

Azure Pipelines

azure-pipelines.yml

trigger:
  - main
pool:
  vmImage: ubuntu-latest
steps:
  - script: |
      curl -fsSL https://cli.fluentci.io | bash
      fluentci --version
      echo "##vso[task.prependpath]${HOME}/.deno/bin
    displayName: Setup FluentCI
  - script: fluentci run --wasm pkl eval config.pkl -f yaml -o config.yaml
    displayName: eval

AWS CodePipeline

buildspec.yml

version: 0.2
phases:
  install:
    commands:
      - curl -fsSL https://cli.fluentci.io | bash
      - fluentci --version
  build:
    commands:
      - fluentci run --wasm pkl eval config.pkl -f yaml -o config.yaml
  post_build:
    commands:
      - echo Build completed on `date`