Skip to content
 
 

Repository files navigation

Ascender Execution Environment

CI License Base

The default execution environment for Ascender. It is the container image Ascender runs every job inside, built on Rocky Linux 9 with Python 3.12, ansible-core, ansible-runner, and a curated set of collections for the platforms customers automate most.

Requirements

Installation

Pull the published image rather than building it, unless you are changing its contents:

podman pull ghcr.io/ctrliq/ascender-ee:latest

Using the execution environment

Run from the root of this repository:

ansible-builder build -v3 -t ghcr.io/ctrliq/ascender-ee

Add the image in Ascender under Administration then Execution Environments, then select it on a job template.

Configuration

Image contents are declared in execution-environment.yml:

Key Purpose
dependencies.galaxy Collections baked into the image, with pinned versions
dependencies.python Python packages installed into the final image
dependencies.system RPM packages, with [platform:rpm] build markers
additional_build_steps Post-build patches, symlinks, and the ascender user

Included content

  • Base: Rocky Linux 9 with Python 3.12 and dnf as the package manager
  • Ansible: ansible-core 2.16, held below 2.17 to keep EL8 Python 3.6 support
  • Runtime: ansible-runner, plus receptor for Ascender automation mesh
  • 18 collections, including ctrliq.ascender, AWS, Azure, GCP, VMware, and Windows
  • Credential support: Kerberos, CredSSP, WinRM, PSRP, and ansible-sign

Testing

CI builds the image on every pull request, which is the check that matters here.

  • Build: ansible-builder build -v3 -t ghcr.io/ctrliq/ascender-ee
  • Lint: tox

The Ascender ecosystem

Repository Description
ascender The platform itself: web UI, REST API, and task engine
ascender-install Installer for Ascender and Ledger, with Galaxy Proxy support
ascender-k8s-install Kubernetes installer for Ascender, Ledger, and React
ascender-pro-install Enhanced installer adding Reaqt, Registry, and Galaxy Proxy
ascender-operator Kubernetes operator that deploys and manages Ascender
ascender-ee Default execution environment image for Ascender jobs
ascender-kit The ascender command line client and Python API library
ascender-collection The ctrliq.ascender Ansible collection for a controller
ascender-ledger Reporting tool for host facts and playbook changes
ascender-galaxy-proxy Caching proxy for Ansible Galaxy collection downloads
ascender-playbooks Example playbooks for use with Ascender

Contributing

License

Licensed under the Apache License 2.0. See LICENSE.md for the full text.

About

An Ansible Execution Environment for Ascender using Rocky Linux

Resources

Contributing

Security policy

Stars

6 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages