mirror of
https://github.com/Expand-sys/awx-on-k3s
synced 2025-12-15 21:42:15 +11:00
docs: add tips to use manual type project
This commit is contained in:
parent
cb2b96fe31
commit
9669f2b9bc
3 changed files with 37 additions and 0 deletions
|
|
@ -283,6 +283,7 @@ Refer [📁 **Back up AWX using AWX Operator**](backup) and [📁 **Restore AWX
|
|||
- [📁 **Use Customized Pod Specification for your Execution Environment**](containergroup)
|
||||
- The guide to use customized Pod of the Execution Environment using **Container Group**.
|
||||
- [📁 **Tips**](tips)
|
||||
- [📝Create "Manual" type project](tips/manual-project.md)
|
||||
- [📝Deploy AWX using external PostgreSQL database](tips/external-db.md)
|
||||
- [📝Trust custom Certificate Authority](tips/trust-custom-ca.md)
|
||||
- [📝Expose `/etc/hosts` to Pods on K3s](tips/expose-hosts.md)
|
||||
|
|
|
|||
|
|
@ -1,5 +1,6 @@
|
|||
# Tips
|
||||
|
||||
- [📝Create "Manual" type project](manual-project.md)
|
||||
- [📝Deploy AWX using external PostgreSQL database](external-db.md)
|
||||
- [📝Trust custom Certificate Authority](trust-custom-ca.md)
|
||||
- [📝Expose `/etc/hosts` to Pods on K3s](expose-hosts.md)
|
||||
|
|
|
|||
35
tips/manual-project.md
Normal file
35
tips/manual-project.md
Normal file
|
|
@ -0,0 +1,35 @@
|
|||
# Create "Manual" type project
|
||||
|
||||
The Git repository is the most preferred place to store your playbooks, and [the guides and resources to deploy Private Git Repository on K3s](../git) are also provided in this repository.
|
||||
|
||||
However, if you don't need such a rich version control system, or need to make frequent iterations of trial and error to develop new playbooks, creating a project with **Manual** type is very helpful.
|
||||
|
||||
## Concepts
|
||||
|
||||
The project directories have to exist under `/var/lib/awx/projects` of AWX, and if you have deployed AWX following the steps described in [the main guide on this repository](../README.md), `/data/projects` on your K3s host is mounted as `/var/lib/awx/projects` in AWX.
|
||||
|
||||
So, to add project directories, simply, just placing it under `/data/projects` on your K3s host.
|
||||
|
||||
## Procedure
|
||||
|
||||
Create new directory under `/data/projects` on your K3s host, and place your playbooks under the directory you created.
|
||||
|
||||
```bash
|
||||
$ tree /data/projects/
|
||||
/data/projects/
|
||||
`-- my-first-manual-project 👈👈👈
|
||||
`-- my-playbook.yaml 👈👈👈
|
||||
```
|
||||
|
||||
Go to `Resources` > `Projects` > `Add` in AWX Web UI, fill `Name` field and select `Manual` as `Source Control Type`.
|
||||
|
||||
Now you can select your project directory (`my-first-manual-project` in this example) as `Playbook Directory`.
|
||||
|
||||
After `Save` the project, your playbooks can be selected in the Job Templates.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
If you got following warning while selecting `Playbook Directory`, try super-reloading your browser (`Shift + F5` or `Ctrl (Cmd) + Shift + R`) to refresh the page without using the cache stored in the browser.
|
||||
|
||||
> ⚠️WARNING:
|
||||
> There are no available playbook directories in /var/lib/awx/projects
|
||||
Loading…
Reference in a new issue