Prerequisites
Always review Items' documentation to learn about their specific prerequisites and dependencies.
For hands-on users wishing to deploy, make sure you have covered the basics:
- Access Credentials: Ensure that you have any of the keys, secrets or tokens required by the Item
- Local Prerequisites: Install any tooling needed for deployment, which for instance depending in the item can be:
- Ansible via pypi.org
- Terraform from hashicorp.com
- Helm from helm.sh
ewccli
from github.com
Item Deployment Best-Practices
There are many good practices you can follow to save yourself or your team the effort of dealing with avoidable security risks or downtime (see Best practices for tenancy management). When it comes to Item deployment specifically, we recommend to at least ensure the following:
- Versioning: Always pin Item versions, for stability, to reduce the blast radius of bugs mistakenly introduce as part of new Item releases and facilitate rollbacks.
- Secret management: Use environment variables or secret managers to temporarily make credentials available for deployment tools.
Deployment Guides
Depending on the item, a first deployment could include the following steps:
- Request OpenStack application credentials if you have none, and added them to your working environment (see How to request Openstack Application Credentials and the "Getting Started" section of EWC - OpenStack Command-Line client for more information).
- Create your ssh keypair and import the public key into OpenStack if you have note done so already (see the "Import SSH key" section of EWC - OpenStack Command-Line client for details)
From this point onward, the deployment steps are mostly dependent on the Item Technology. For detailed guidance per specific technology, you can get started with these example:
Deploying an Ansible Playbook
Page under construction
Find out how to run Ansible Playbooks from your local working environment and configure existing compute instances or automate Morpheus UI configuration steps.
Deploying a Terraform Module
Page under construction
Learn how to initialize, plan, and apply Terraform modules for provisioning and managing the state of EWC infrastructure (i.e. OpenStack compute instances, OpenStack networks and security groups, etc.).
Deploying a Docker Container
Page under construction
Learn how to reuse publicly available Docker images to simplify minimize the setup required to run applications, regardless of their software or hardware dependencies.
Deploying a Helm Chart
Page under construction
Learn how to deploy full applications or support systems onto production-like environments hosted on the EWC's own Kubernetes engine.
Deploying new instances and applying Ansible Playbooks on them with the ewccli
Page under construction
The ewccli
is a Linux-native Python-based tool which allows you to interact with a subset of the deployable Items, and deploy them directly into the your EWC tenancy and with minimal setup required on your local working environment.