agnosticd

by redhat-cop

redhat-cop / agnosticd

Documentation: AgnosticD - Ansible Deployer for multiple Cloud Deployers

251 Stars 342 Forks Last release: 5 days ago (rhtr-2020-remediation-lab-test-0.4) GNU General Public License v3.0 5.5K Commits 3.3K Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

== Overview

Ansible Agnostic Deployer, AKA AAD, AKA AgnosticD, is a fully automated 2 Phase deployer for building and deploying everything from basic infrastructure to fully configured running application environments running on either public Cloud Providers or OpenShift clusters.

AgnosticD is not an OpenShift Deployer, though it can and does that, it is however also a deployer that just happens to be used to deploy a lot of OpenShift and OpenShift workloads, amongst other things.

=== Make your first Deployment

Check out this link:https://www.youtube.com/watch?v=lfHYwXJhKB0[Video Introduction to deploying with Ansible AgnosticD]!

Get started and use agnosticd to deploy on OpenStack with link:docs/FirstOSPEnv_walkthrough.adoc[First OSP Environment Walkthrough].

There are many link:./ansible/configs[configs] you can choose from, here are three that you can start with and modify to fit your needs:

  • link:./ansible/configs/just-a-bunch-of-nodes/[Just a bunch of nodes] - Simple, multi-cloud.

  • link:./ansible/configs/three-tier-app/README.adoc[Three Tier App] - Relatively simple environment, which deploys by default just a bunch of Linux hosts ready to be configured.

  • link:./ansible/configs/ocp4-cluster/README.adoc[OCP4 Cluster] - If a fully installed OpenShift Cluster is what you are looking for then take a look here. Deploys onto AWS, OpenStack, etc.

  • link:./ansible/roles/ocp-workload-rhte-mw-api-biz/readme.adoc[API as a Business demo Deployment] - Want to deploy a workload onto your existing OpenShift Cluster? or local instance running on your laptop? 3Scale is an example of one of around 30 OpenShift workloads ready to go.

=== How AgnosticD Deploys

  • For OpenShift Workloads AgnosticD executes an ansible role against an existing OpenShift cluster. Roles can be found link:./ansible/roles/[here] and begin

    ocp(4)-workload-*
    , with or without
    4
    depending on the OpenShift version active at the time of writing them. OpenShift Workloads are not necessarily version-dependent. You can find many workloads in our repository that were written for OpenShift 3 and continue to work in OpenShift 4.
  • For Configs each contain 5 deployment playbooks and supporting files executed in sequence, which combined with Cloud Provider tools like awscli, deploy infrastructure components all the way through to fully configured applications.

image::docs/images/agnosticd_flow.png[width=100%] .AgnosticD deployment workflow

=== Getting Started

The accompanying documentation explains how to achieve all this, extend it and add both your own environments, hereafter called configs and a lot lot more. Well designed configs, can be easily abstracted to allow deployment to multiple different Public and Private Clouds including AWS, Azure, and others.

  • link:./docs/[The Documentation Set] Start Here
  • link:./ansible/[./ansible] The working ansible directory ** link:./ansible/main.yml[main.yml] The main entry point for
    ansible-playbook
  • link:./ansible/roles[Roles directory] Home to the
    ocp-workload-*
    roles
  • link:./ansible/configs[Configs directory] Home to the Configs

The Contributors Guides explore the relevant structures in significantly more detail:

  • link:docs/CreatinganOpenShift_Workload.adoc[Creating an OpenShift Workload Guide]
  • link:docs/Creatingaconfig.adoc[Creating a Config Guide] // * link:docs/Creatingacloud_deployer.adoc[Creating a Cloud Deployer Guide]

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.