Help and FAQ
Where To Start?
If you are overwhelmed by the docs or not sure where to begin you should try out the Quickstart guide. It uses step-by-step questions with interactive fields/buttons to help customize Komodo Import for your machine.
Further Help with Komodo Import
If the Quickstart guide and Usage docs do not cover what you want to do with Komodo Import or you do not fully understand how to use it please search the repository's Github Discussions and if your question is not answered then open a New Discussion.
Found a Bug or Error?
If Komodo Import is not behaving as you expect it to or is outputting errors that break functionality please search Github Issues and open a New Issue if you cannot find a solution to your problem.
FAQ
How do I change/fix created Stacks?
Komodo computes differences between what is described in a Sync Resource and what is currently deployed in Komodo. With this ability, you can make changes to a Sync and Execute it to make Komodo automatically update the deployed Resource of the same name(s). This makes it easy to "fix" Stacks without having to start from scratch. The approaches below all describe ways to update your existing Sync Resource.
Edit Manually
If the change you want to make is small (only a few Stacks need to change) or is for a setting Komodo Import does not support yet, you can manually edit the Resoure Files/Info section of the Sync yourself. After Saving, Execute the Sync to make the changes propogate into Komodo.
Or, alternatively, update the Stack directly.
Bulk Update using Komodo Import
Using API Output
With API Output, add this to your Komodo Import environment:
EXISTING_SYNC=overwrite
and re-run Komodo Import. This will make Komodo Import overwrite the contents of the existing Sync with the updated, generated Stacks. Then, Verify and Execute Sync as normal to make Komodo propogate the changes.
Using Console Output
With Console Output, copy the new output from Komodo Import and replace the contents of your existing Sync (in the Resoure Files/Info section). Verify and Execute Sync as normal to make Komodo propogate the changes.
How do I delete created Stacks?
If you are trying to re-create the Stack with new settings because the existing ones are wrong try change/fixing the stacks instead.
The easiest way to delete stacks in bulk is from the Stacks list page in Komodo (Stacks in sidebar). Toggle the checkbox for all Stacks to delete and click Group Actions -> Delete.
Using Sync Resource (Advanced)
Stacks can also be deleted using a separate Sync Resource with Delete Unmatched Resources option enabled. This option will make Komodo delete any Resources that are not described in the Sync Resource.
Be careful with this method and double check the contents before using. You could accidentially delete Servers (hosts connected with Periphery), Variables, etc... if they are not included.
Steps:
- Create a new Sync with Managed option enabled, if you don't already have one
- Commit/Refresh the Sync so that the Resoure Files/Info section includes ALL Resources in Komodo.
- Verify this! It should include
[[server]]
sections and other Resources, besides just Stacks.
- Verify this! It should include
- In Resoure Files/Info section remove all
[[stack]]
, with proceeding data, sections you want to delete. Then Save - In the config for the Sync enable Delete Unmatched Resources and Save
- Switch to the Execute tab and Execute Change to delete all undesired Stacks
At this point the Sync can be used as a "good rollback state" for Komodo like so:
- Use Komodo Import to create Stacks in another Sync, Execute...stacks are created
- Don't like how Stacks were created or something is wrong and can't use update method? Execute Change on your "rollback state" Sync to one-click return Komodo to where it was before using Komodo Import.