Chapter 4. Projects

Procedure

1. Log in to the Ansible Automation Platform Dashboard.
2. Navigate to Automation Decisions Projects.
3. Click Create project.

4. Insert the following:

   Name

   Enter project name.

   Description

   This field is optional.

   Source control type

   Git is the only source control type available for use. This field is optional.

   Source control URL

   Enter Git, SSH, or HTTP[S] protocol address of a repository, such as GitHub or GitLab. This required field is editable. See Editing a project to view details of how editing this field impacts rulebook activations.

   Note

   This field accepts SSH private key or private key phrase. To enable the use of these private keys, your project URL must begin with git@.

   Proxy

   This is used to access HTTP or HTTPS servers. This field is optional and editable. See Editing a project to view details of how editing this field impacts rulebook activations.

   Source control branch/tag/commit

   This is the branch to checkout. In addition to branches, you can input tags, commit hashes, and arbitrary refs. Some commit hashes and refs may not be available unless you also provide a custom refspec. This field is optional and editable. See Editing a project to view details of how editing this field impacts rulebook activations.

   Source control refspec

   A refspec to fetch (passed to the Ansible git module). This parameter allows access to references via the branch field not otherwise available. This field is optional and editable. See Editing a project to view details of how editing this field impacts rulebook activations. For more information, see Examples.

   Source control credential

   This is an optional credential used to authenticate with the provided Source control URL.

   Content signature validation credential

   Enable content signing to verify that the content has remained secure when a project is synced. If the content has been tampered with, the job will not run. This field is optional.

   Options

   The Verify SSL option is enabled by default. Enabling this option verifies the SSL with HTTPS when the project is imported.

   Note

   You can disable this option if you have a local repository that uses self-signed certificates.

5. Select Create project.

Procedure

1. From the Projects list view, select the More Actions icon ⋮ next to the desired project. The Edit page is displayed.

2. Edit the desired fields.

   Important

   When you update a project’s Source control URL, Source control branch/tag/commit, or Source control refspec, Event-Driven Ansible automatically triggers a project resync. This process updates the rulebooks available within Event-Driven Ansible controller and can significantly impact existing rulebook activations:

   • Rulebook Content Updates: Running activations continue to use old content when a rulebook’s content changes. To apply the newer content, you must restart the affected rulebook activation. If the rulebook content you update is attached to an activation that uses event streams, you must re-attach the event stream to that activation after the updates are applied and then, restart the activation.
   • New Rulebooks: Any new rulebook added to the repository becomes available in the database after the sync.
   • Deleted Rulebooks: A removed rulebook is deleted from the database upon sync. Its associated activations, however, continue to run and can be restarted. Review and update any activations detached from their source rulebook.
3. Select Save project.

Procedure

1. To delete a project, complete one of the following:

   • From the Projects list view, select the checkbox next to the desired project, and click the More Actions icon ⋮ from the page menu.
   • From the Projects list view, click the More Actions icon ⋮ next to the desired project.
2. Select Delete project.
3. In the Permanently delete projects window, select Yes, I confirm that I want to delete this project.
4. Select Delete project.