Skip to content

Get started

allez is a Python package. Installing it brings its dependencies with it, the Fabric CLI ms-fabric-cli among them.

Prerequisites

  • Python 3.10+ and pip.
  • git on PATH. allez reads the current branch from it, and teardown --orphans uses git ls-remote.
  • A Fabric identity: your own account on a laptop, a service principal in a pipeline.

Installation

python -m pip install allez

Sign in

fab auth login

Credentials

allez has no credential code of its own. Every Fabric call goes through fab, as whoever fab is signed in as: you on a laptop, a service principal in a pipeline (pipeline setup).

Next

The guides add allez to a fabric-cicd repo one feature at a time. Read them in order; stop when you have what you need.

  • 1. Migrate from fabric-cicd

    Keep your config.yml and parameter.yml. Add a root allez.yml with the deployment order, then preview it.

    Migrate from fabric-cicd

  • 2. Hooks and overlays

    Run a notebook or refresh a model around a publish, and split one workspace's publish into ordered parts.

    Hooks and overlays

  • 3. Branch workspaces

    One workspace per sub-folder for each feature branch, created, filled, connected to git and deleted after the merge.

    Branch workspaces

  • 4. Cross-workspace references

    Name another workspace by its folder with a $allez.* token, and check every id with allez audit.

    Cross-workspace references