Skip to content

Latest commit

 

History

History
82 lines (58 loc) · 4.17 KB

File metadata and controls

82 lines (58 loc) · 4.17 KB

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.