README
¶
Automated OpenShift Installation for AWS
Prerequisites
- Docker Container Engine (Version: >= 17.09)
Supported OS
- Linux
- MacOS
It should work properly with Docker for Windows, nevertheless it is not supported or tested.
Quick Start
Configuration
Available Scripts
There are three bash scripts available which make life easier.
Building the application
All parts of the application can be build using a provided script. The following dependencies are required:
- Docker
- Git
There are no more dependencies, compilation will take place inside a docker image.
./build.sh
Creating a cluster
./run.sh -name="Test Cluster"
Required Parameters
AWS Keys
| Parameter | Description |
|---|---|
| -aws-key | AWS access key id. If empty the credentials used for AWS CLI will be loaded |
| -aws-secret | AWS secret key. If empty the credentials used for AWS CLI will be loaded |
Optional Parameters
| Parameter | Description |
|---|---|
| -skip-terraform | Skip terraform invocation. This should be used if there is an already existing infrastructure. |
| -skip-config | Skip generation of configuration files. This is useful when there are already configuration files and only the installer should be run. Nevertheless recreating the configuration files would not harm the system. |
| -skip-pre | Skip prerequisites playbooks of OpenShift installer. This is useful when restarting the installer due to a previous failure. |
| -verbose | Enables Ansible -vvv verbose mode |
Destroying a cluster
If you want to delete a previously created cluster, simply run
./destroy.sh
It is important that the files generated during creation are still available. At least the Terraform state (terraform.tfstate) and the Terraform configuration (configuration.tfvars) must be available.
Attention: After a successful destruction the terraform state and the old SSH key will be removed automatically.
Directories
Click to show internal directories.
Click to hide internal directories.