Archived repository

This project is no longer under active development. It has been superseded by the cfa-cloudops project, which incorporates code and concepts from azuretools as low-level tooling but also provides a higher level API for certain cloud operations.

The CFA Predict Short-Term Forecasting Team currently handles workflow orchestration in Azure via Dagster. See the cfa-dagster repo for CFA-specific helper tooling. The Team uses cfa-cloudops for lower-level cloud tasks.

STF Azure tools

This repository contains azuretools, a lightweight Python library of helper tooling to enable CFA Predict Short-Term Forecasting team members interact more efficiently with Azure, particularly Azure Batch. It also contains some simple worked examples in the examples/ directory.

Installation

This installation guide assumes you are working on a Debian/Ubuntu family Linux machine or in an equivalent virtual machine (e.g. a WSL2 Ubuntu from Windows). It assumes you are comfortable working at the Unix command line. It assumes you have Python 3 installed as your system python, as well as the standard pip package manager. Confirm this with:

python --version
which pip

You can install azuretools from Github via:

pip install git+https://github.com/cdcgov/cfa-azuretools

Projects that use azuretools

One way to get a sense of azuretools is to look at projects that use it. Here are a few:

Pyrenew-HEW: Multi-signal renewal modeling

• Most relevant python scripts live in the pipelines/batch subdirectory

Wastewater-informed COVID Forecasting

• Relevant scripts live in the batch subdirectory
• That directory's README walks the user through running an analysis on Azure batch (leverging azuretools).

Your project?

• Let us know if you have a project that uses azuretools that you'd like us to showcase here.