blsmith/dc-deployments-automation
1
0
Fork 0
mirror of https://bitbucket.org/atlassian/dc-deployments-automation.git synced 2025-12-14 08:53:07 -06:00
Code Issues Packages Projects Releases Wiki Activity

More edits

Browse Source
This commit is contained in:
Don Domingo
2019-11-21 05:59:41 +00:00
parent d534a15c03
commit 2e3db07637
1 changed files with 21 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
README.md
View File

@@ -9,7 +9,7 @@ cloud environments.
## Usage ## Usage
### Cloud DC-node deployment playbooks ### Configuring Data Center nodes on cloud deployments
The usual scenario for usage as part of a cloud deployment is to invoke the The usual scenario for usage as part of a cloud deployment is to invoke the
script as part of post-creation actions invoked while a new product node is script as part of post-creation actions invoked while a new product node is
@@ -60,38 +60,34 @@ them in the `Custom command-line parameters for Ansible` field:
-e atl_product_download_url=http://s3.amazon.com/atlassian/jira-9.0.0-PRE-TEST.tar.gz -e atl_use_system_jdk=true -e atl_download_format=tarball -e atl_product_download_url=http://s3.amazon.com/atlassian/jira-9.0.0-PRE-TEST.tar.gz -e atl_use_system_jdk=true -e atl_download_format=tarball
#### Parameters you can override #### Other customizable parameters
The following files contain many of the most common system configuration parameters Consult the following files for clues on other parameters you can customize for your deployment:
you can override for your deployment:
- `[/roles/product_install/defaults/main.yml](roles/product_install/defaults/main.yml)` - `[/roles/product_install/defaults/main.yml](roles/product_install/defaults/main.yml)`
- `[/group_vars/aws_node_local.yml](group_vars/aws_node_local.yml)` - `[/group_vars/aws_node_local.yml](group_vars/aws_node_local.yml)`
## Reporting issues More customizable parameters are defined in specific roles -- specifically, in the
role's `defaults/main.yml` file. Most of these parameters use the `atl_` prefix. You can
use the following [Bitbucket code search query](https://confluence.atlassian.com/bitbucket/search-873876782.html) to find them:
If you find any bugs in this repository, or have feature requests or use cases repo:dc-deployments-automation repo:dc-deployments-automation path:*/defaults/main.yml atl
for us, please raise them in our [public Jira project](https://jira.atlassian.com/projects/SCALE/summary).
## Development ## Development
### Development philosophy ### Development philosophy
The suite is intended to consist of a number of small, composable roles that can The suite is intended to consist of a number of small, composable roles that can
be combined together into playbooks. Wherever possible the roles should be be combined together into playbooks. Wherever possible, roles should be product-agnostic
platform-agnostic as possible, with platform-specific functionality broken out (e.g. downloads) and platform-agnostic. Functions that are product-specific or
into more specific roles. platform-specific are split off into separate roles.
Where possible the roles are also product-agnostic (e.g. downloads), with more
specific functionality added in later product-specific roles.
Roles should be reasonably self-contained, with sensible defaults configured in Roles should be reasonably self-contained, with sensible defaults configured in
`/roles/<role>/defaults/main.yml`. Like all playbook parameters, you can override `/roles/<role>/defaults/main.yml`. Like all playbook parameters, you can override
them at runtime (see them at runtime.
and overridden by the playbook at runtime. Roles may Some roles implicitly depend on other variables beind defined elsewhere.
implicitly depend on variables being defined elsewhere where they cannot define For example, the `jira_config` role depends on the `atl_cluster_node_id`
them natively. For example, the `jira_config` role depends on the `atl_cluster_node_id`
var being defined; on AWS this is provided by the `aws_common` role, which var being defined; on AWS this is provided by the `aws_common` role, which
should be run first. should be run first.
@@ -107,15 +103,18 @@ environment and running tests.
information. information.
* Inventory files are under `inv/`. For AWS `cfn-init` the inventory * Inventory files are under `inv/`. For AWS `cfn-init` the inventory
`inv/aws_node_local` inventory is probably what you want. `inv/aws_node_local` inventory is probably what you want.
* Note that this expects the environment to be setup with infrastructure * Note that this expects the environment to be setup with infrastructure information (refer to the _Usage_ section above).
information; see _Usage_ above.
* Global group vars loaded automatically from `group_vars/<group>.yml`. In * Global group vars loaded automatically from `group_vars/<group>.yml`. In
particular note `group_vars/aws_node_local.yml` which loads infrastructure particular note `group_vars/aws_node_local.yml` which loads infrastructure
information from the environment. information from the environment.
* Roles are under `roles/` * Roles are under `roles/`
* Platform specific roles start with `<platform-shortname>_...`, * Platform specific roles start with `<platform-shortname>_...`, e.g. `roles/aws_common/`.
e.g. `roles/aws_common/`. * Similarly, product-specific roles should start with `<product>_...`.
* Similarly, product-specific roles should start with `<product>_...`.
## Reporting issues
If you find any bugs in this repository, or have feature requests or use cases
for us, please raise them in our [public Jira project](https://jira.atlassian.com/projects/SCALE/summary).
## License ## License