mirror of
https://github.com/ansible/awx.git
synced 2026-01-10 15:32:07 -03:30
8c4be1c529
* Update docs replacements to AWX (#15349) Update replacements to AWX Signed-off-by: Sandra McCann <samccann@redhat.com> (cherry picked from commit 9979fc659efbf4d54a39f9f36912d5ed7b0fa6cd) * Remove remnants of controller terms from quickstart docs (#15350) Remove remnants of controller terms from quickstart Signed-off-by: Sandra McCann <samccann@redhat.com> (cherry picked from commit 864a30e3d451e6daf39421a598f725419f105101) * Remove references to translated versions of the docs (#15354) remove references to translated versions of the docs Signed-off-by: Sandra McCann <samccann@redhat.com> Co-authored-by: TVo <thavo@redhat.com> (cherry picked from commit 5f42db67e6fbcffa8e5b26553d41273b7730344c) * update terminology (#15357) * update terminology Replace some instances of Tower with AWX and remove some references to enterprise left over from the migration of RST content from the Automation Controller docs. * Update docs/docsite/rst/userguide/overview.rst Co-authored-by: TVo <thavo@redhat.com> --------- Co-authored-by: TVo <thavo@redhat.com> (cherry picked from commit f1448fced1411b9d7cce19a0ad91df992e447014) * Replaced all references of downstream docs to upstream docs (#15388) * Replaced all references of downstream docs to upstream docs. * Update README.md Co-authored-by: Don Naro <dnaro@redhat.com> * Update README.md.j2 Co-authored-by: Don Naro <dnaro@redhat.com> * Update README.md.j2 Co-authored-by: Don Naro <dnaro@redhat.com> * Incorpor'd review feedback from @oraNod and @samccann * Updated with agreed link (for now) until further change is needed. --------- Co-authored-by: Don Naro <dnaro@redhat.com> (cherry picked from commit 018f235a645163ee820ff33b47a70194fabeea66) * Re-do PR #14685 for alt-text inventories. (#15394) (cherry picked from commit 6d0c47fdd0f0ca00c06afb5db5bd49c8da995a50) * Docs: add Communication guide (#15469) * Docs: add Communication guide * Update docs/docsite/rst/contributor/communication.rst Co-authored-by: Don Naro <dnaro@redhat.com> * Update docs/docsite/rst/contributor/communication.rst --------- Co-authored-by: Don Naro <dnaro@redhat.com> (cherry picked from commit 79c1921ea480ae26b0d7faf6e1a8e89b61f76c30) --------- Co-authored-by: Don Naro <dnaro@redhat.com> Co-authored-by: TVo <thavo@redhat.com> Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>
43 lines
2.1 KiB
ReStructuredText
43 lines
2.1 KiB
ReStructuredText
Setting up a Project
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. index::
|
|
single: projects
|
|
|
|
|
|
A Project is a logical collection of Ansible playbooks, represented in AWX.
|
|
|
|
You can manage playbooks and playbook directories by either placing them manually under the Project Base Path on your AWX server, or by placing your playbooks into a source code management (SCM) system supported by AWX, including Git, Subversion, and Mercurial.
|
|
|
|
.. note::
|
|
|
|
It is recommended that, whenever possible, you use source control to manage your playbooks. This type of best practice provides the ability to treat your infrastructure as code and is in line with DevOps ideals. While this Quick Start Guide uses lightweight examples to get you up and running, we suggest using source control to manage your actual playbooks.
|
|
|
|
To review existing projects, click **Projects** from the left navigation bar.
|
|
|
|
|Projects - home|
|
|
|
|
.. |Projects - home| image:: ../common/images/qs-projects-home.png
|
|
|
|
The |at| simplifies the startup process by providing you with a Demo Project to work with initially.
|
|
|
|
Click on **Demo Project** to view its details.
|
|
|
|
|Projects - demo project|
|
|
|
|
.. |Projects - demo project| image:: ../common/images/qs-demo-project-details.png
|
|
|
|
For the purpose of this Quick Start Guide, leave the default demo project as is. But to edit the default project later - from the Details tab, click **Edit**, or from the Projects list view, click the Edit (|edit|) button next to the project name to edit the appropriate details, then save your changes.
|
|
|
|
.. |edit| image:: ../common/images/edit-button.png
|
|
|
|
If you want to fetch the project for latest changes, you can manually start an SCM sync for this project. Update the SCM-based demo project from the Details tab, click **Sync**, or from the Projects list view, click the Sync (|sync|) button next to the project name.
|
|
|
|
.. image:: ../common/images/qs-demo-project-sync-icon-hover.png
|
|
|
|
.. note::
|
|
|
|
Please note that immediately after adding new projects setup to use source control, a "sync" automatically starts that fetches the project details from the configured source control.
|
|
|
|
.. |sync| image:: ../common/images/refresh-button.png
|