You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

32 lines
987 B

  1. Getting started
  2. ===============
  3. The easiest way to run the deployement is to use the **kargo-cli** tool.
  4. A complete documentation can be found in its [github repository](https://github.com/kubespray/kargo-cli).
  5. Here is a simple example on AWS:
  6. * Create instances and generate the inventory
  7. ```
  8. kargo aws --instances 3
  9. ```
  10. * Run the deployment
  11. ```
  12. kargo deploy --aws -u centos -n calico
  13. ```
  14. Building your own inventory
  15. ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  16. Ansible inventory can be stored in 3 formats: YAML, JSON, or inifile. There is
  17. an example inventory located
  18. [here](https://github.com/kubernetes-incubator/kargo/blob/master/inventory/inventory.example).
  19. You can use an
  20. [inventory generator](https://github.com/kubernetes-incubator/kargo/blob/master/contrib/inventory_generator/inventory_generator.py)
  21. to create or modify an Ansible inventory. Currently, it is limited in
  22. functionality and is only use for making a basic Kargo cluster, but it does
  23. support creating large clusters.