Infrastructure as Code /
Run a template
You can run a template manually from either your account templates page or a project templates page. Only templates related to the project will appear in the project templates view, you can see all your templates in an account from the account templates page.
Open the template you want to use and click run to start a template run. In the project view the run button appears in the header, and in your account view it will appear in the template form.
When you run a template it will be scheduled to run, and enter the
It will shortly enter the
running state, where it will begin running through the workflows defined in the template. You can see the status of each template, as well as the repository and file if GitOps is enabled.
Each of your individual templates contains a list of template runs that display the project the template is related to, the status of the template run, the commit hash (if the template run was triggered by a commit to a repository), and the time the template run was triggered.
View template run
You can click on a template run to view the status of the components of your template, including creating/updating the project, overall workflows, and resources within individual workflows. Each node will indicate the state it is in, which can help you debug templates that are taking longer than expected to complete, or failing.
Each node can be expanded to view the template JSON for
running nodes, and
failed nodes will also contain a
response object from the Northflank API. Nodes can also receive a
retries object, detailing the number of attempts and the time of the next attempt.
Template node states
Workflows and nodes can have the following states:
Pending: the node or workflow will run when previous steps are executed successfully
Running: the node or workflow is currently being executed
Waiting: the node is waiting for an action to be completed, will eventually timeout unless it receives a successful response
Retrying: the node has failed on previous runs, but is being executed again (up to 3 attempts)
Success: the node or workflow has completed successfully
Failed: the node or workflow has failed to execute, or exceeded 3 retries
You can enable run a template automatically so that any changes made to the template made in the Northflank application, API, or the template in a repository (if GitOps is enabled) will trigger a template run.