Working with Repositories

Important! The Release Automation perspective is only available to Automic Continuous Delivery Automation users; however, as an Automic Automation user, you can execute the same functionality with the REST API. For more information, see: Infrastructure Manager REST API Reference

Repositories contain Terraform templates that can be used for provisioning infrastructure.

Watch the video:

This page includes the following:

Viewing Repositories

  1. Open the Release Automation perspective.
  2. Navigate to Provisioning > Repositories

    The following information is displayed:

    • Name
    • Branch
    • Type: Only GIT is supported.
    • Status

      If the repository connection cannot be established successfully, the repository status is set to Inactive. Otherwise, it is set to Active.

      The Inactive status can be caused by one or more of the following reasons:

      • Connection time-out
      • Invalid credentials
      • Branch not found: The branch provided is not available.

      The Active status contains the following sub-statuses:

      Note: The sub-status is displayed in the message attribute of the response.

      • Initializing repository

        Newly added models.

      • Updating repository

        The repository is executing a pull/fetch.

      • Ready for provisioning

        Infrastructure can be provisioned.

    • Created By
    • Created On
    • Requester

Adding Repositories

Important!

  • Once created, your templates must be stored and managed in a GIT repository. Subfolders are not supported.

    Examples:

    • Valid: aws_myfolder
    • Invalid: aws/myfolder
  • The repository you want to connect to can only contain templates.

To Add Repositories

  1. Open the Release Automation perspective.
  2. Navigate to Provisioning > Repositories
  3. Click Add.
  4. Enter the credentials to connect to the GIT repository.
    • Connect over: connection mode.
      • HTTPS
      • SSH

    • Name: Name of the repository. It must be unique and can only contain alphanumeric characters, blanks, ., -, _, @, $, #.

    • URL: Link to the repository.

      Example: https://github.com/johndoe/terraform.git

    • Branch: Enter the branch of the repository you want to connect to.

      Example: Master

    • (Optional) Username and Password (only for private repositories of HTTPs connections)

    • Private Key: (only for SSH connections)

      Important! The private key file size cannot exceed 100KB.

    • (Optional) Passphrase: (only for private repositories of SSH connections)

      Note: For more information on how to generate GIT SSH keys, see the GIT documentation.

  5. Click Add.

    The Infrastructure Manager connects to the repository, pulls the templates and displays them in the Templates page.

Notes:

  • Credentials are encrypted.
  • If the GIT connection fails, an error message is displayed.

Editing the Properties of Repositories

  1. Open the Release Automation perspective.
  2. Navigate to Provisioning > Repositories
  3. Select a Repository and double-click it to open it.
  4. You can see/change the following properties of the repository:
    • General page: Name
    • Credentials page:
      • Private key (SSH)
      • Username (HTTPS)
  5. Click Save.

Deleting Repositories

  1. Open the Release Automation perspective.
  2. Navigate to Provisioning > Repositories
  3. Select a repository and click the Delete button in the toolbar.
  4. Click Delete in the dialog.

Conditions to delete repositories

  • Not used by any infrastructure.