Working with Artifact Sources

As an Administrator, you manage Artifact Sources to connect to the repository where the Artifacts are stored.

Important! The actions that you can perform depend on your folder permissions, see: Folder Permissions.

About Artifact Sources

Artifact Sources store all properties that are used to connect to the repository where the Artifacts are located. The type of data that is stored depends on the Artifact Source type (for example, URI, user, password). You can define an unlimited number of Artifact Sources in the system.

Artifact Source custom types (for example, HTTP or FPT) can be either manually defined or installed via Action Packs.

Prerequisites

Note the following before working with Artifacts and Artifact Sources:

• CDA Artifacts are only compatible with the following Action Pack versions:

  • PCK.AUTOMIC_BOND 1.2.0 or higher
  • PCK.AUTOMIC_ARTIFACTORY 1.2.0 or higher
  • PCK.AUTOMIC_FTP 1.2.0 or higher
  • PCK.AUTOMIC_HTTP 1.2.0 or higher
  • PCK.AUTOMIC_JBDC 1.3.0 or higher
  • PCK.AUTOMIC_SMB 1.2.0 or higher
  • PCK.AUTOMIC_Tomcat 1.2.0 or higher
  • PCK.AUTOMIC_NEXUS 1.2.0 or higher
  • PCK.AUTOMIC_NEXUS_V3 1.1.0 or higher
  • PCK.AUTOMIC_GIT 1.1.0 or higher

    Note: Changing the Properties of an Artifact - If both the Git Branch Name and Git Commit fields are filled in, the Git Commit property is applied.

  • PCK.AUTOMIC_SCP 1.2.0 or higher
  • PCK.AUTOMIC_SVN 1.2.0 or higher
  • PCK.AUTOMIC_TFS 1.3.0 or higher

  For more information, see Automic Compatibility Matrix.

• PCK.AUTOMIC_BOND must be installed/upgraded first. See: Troubleshooting Installation and Upgrade Errors

Viewing Artifact Sources

1. Open the Release Automation perspective.
2. Click the Artifact Sources tab.

   The Artifact Source list displays a table with all Artifact Sources and the following information:

   • Name: Artifact Source name. The name has to be unique and may only contain alphanumeric characters, blanks, ., -, _, @, $, #.
   • Type: Artifact Source custom type.
   • Folder: folder where the Artifact Source is stored.
   • Owner: current owner of the Artifact Source.

When you select an Artifact Source from the list, you can edit its properties and trigger the most common actions in the sidebar. To access all functionality for an Artifact Source, click the left icon in the table or hover over the entity name in the header of the right sidebar.

Creating Artifact Sources

1. Click the Create button in the toolbar. The Create Artifact Source dialog is displayed.
2. Enter the name of the new Artifact Source. It has to be unique and may only contain alphanumeric characters, blanks, ., -, _, @, $, #.
3. Enter the Artifact Source type. All types for which you have create permissions can be selected.

   Important! The selected type cannot be changed after creation.

4. Enter the name of the folder where you want to store your Artifact Source.
5. Enter the owner of the Artifact Source. You can select the current user or one of the user groups the user belongs to as owner (or one of all active user groups for administrators). To assign a different user, edit the entity after creating it.
6. Click Create.

Editing Artifact Sources

• General

  In the summary panel, you can view and edit the basic properties of an application:

  • Name: Artifact Source name. It has to be unique and may only contain alphanumeric characters, blanks, ., -, _, @, $, #.
  • Type: Artifact Source type.
  • Folder: folder where the Artifact Source is stored.
  • Owner: current owner of the Artifact Source.
  • Times Used: number of times the Artifact has been assigned to a Component Package.

• Description

  The description is limited to 4000 characters.

• Connection/Proxy/Credential

  These properties depend on the custom type of the Artifact Source.

• Settings

  • Preserve File Attributes: if set to yes, the creation/modification times and modes of the original files are preserved.
  • Recursive Download: if set to yes, files and directories are retrieved recursively. If set to no, only the children of the directory are downloaded.

• Actions

  Actions are located in the toolbar. They can be also triggered from the context menu displayed after right-clicking the entity. You can trigger the following actions (depending on your permissions):

  • Duplicate: see Duplicating Artifact Sources
  • Export: exports the entity in CSV format.
  • Delete: see Deleting Artifact Sources.
  • Archive: archives the selected entity. If an entity is archived, Restore is available (see Archiving Entities)

• Errors and Warnings

  This panel shows errors and warnings in the context of the current Artifact Source. If there are no errors or warnings, the panel is not displayed.

• Custom Properties

  The selected object may have more properties and property groups defined by the administrator. When defined, these properties are shown in the sidebar as separate panels and can be edited by you.

• Statistics & History

Duplicating Artifact Sources

1. Select the Artifact Source that you want to duplicate and click the Duplicate button in the toolbar. The Duplicate Artifact Source dialog is displayed.
2. Optionally, enter a new name for the Artifact Source. The name must be unique and it can only contain alphanumeric characters, blanks, ., -, _, @, $, #.
3. Optionally, select a new owner and destination folder.

Important! Passwords are not copied to the new Artifact Source.

Deleting Artifact Sources

• Right-click the entity and select Delete.

Note: You may only delete the entity when you have the appropriate permission on the containing folder (see Security Concept) and all of the listed conditions are met.

Conditions to delete entities of type ArtifactSource

• If an Artifact is assigned: The conditions to delete the Artifacts are fulfilled for all Artifacts that are assigned to the Artifact Source.

See also:

• Working with Components Assigned to a Deployment Package
• Working with Artifacts
• Creating and Assigning Artifacts to Package Components