Crossplane Docs - Generator

  • Fri, Mar 15, 2024
  • One-minute read

Table of Contents

What is XDocs?

  • We have XR, XRD, XRC ;) Why not XDocs?
  • Inspired from terraform-docs but for Crossplane
  • Generate markdown based docs for your Compositions, it also includes your linked Resources, XRD and Claim

Installation

XDocs Generator can be installed in several ways to suit your preferences and development environments

Homebrew Tap (macOS & Linux)

If you’re using Homebrew, you can install the tool via our custom Homebrew tap

brew tap Kavinraja-G/tap
brew install crossplane-docs

Standalone Binary

For macOS, Linux, and Windows, standalone binaries are available. Download the appropriate binary for your operating system from the releases page, then move it to a directory in your PATH.

macOS/Linux

# Feel free to change the release/arch names accordingly
curl -Lo crossplane-docs https://github.com/Kavinraja-G/crossplane-docs/releases/download/v0.1.0/crossplane-docs_v0.1.0_darwin_amd64.tar.gz
chmod +x crossplane-docs
sudo mv crossplane-docs /usr/local/bin/

Windows

Download the .exe file and add it to your PATH

Usage

Currently xDocs supports only markdown output, but more in pipeline. To generate markdown docs for your compositions & XRDs

crossplane-docs md [INPUT_PATH|INPUT_FILE] -o [OUTPUT_FILE]

For example:

crossplane-docs md ./samples -o samples/README.md

Check README.md for the output.

Features

  • Discovers Composition & its resources, XR, XRD and Claim names with their references
  • Markdown ouput with tabulation
  • Claim/XRC specifications (WIP)

Limitations

Crossplane compositions with Pipeline composition mode is not supported.

kubernetesgolang