AntHillPro is a build integration tool.
Before you begin
Install an agent that has access to the AntHillPro server.
Procedure
- In IBM UrbanCode™ Deploy, click Components, and then click Create
Component.
- In the Create Component window, specify a name and description for
the component.
- In the Teams fields,
specify the access information for the new component.
- To use a template for the new component,
select a template from the Template list. In this case, the component inherits source configuration, properties,
and processes from the template. For information about templates,
see Component templates.
- In the Source Configuration Type list, select
AntHillPro.
- Specify the following parameters for the component:
- Anthill URL
- The URL of the AntHillPro server, such as
https://anthillrepo.company.com/repository.
- User
- The user name of the AntHillPro-credentialed user.
- Password
- The password of the AntHillPro-credentialed user.
- Project
- The name of the project. AntHillPro projects roughly correspond
to IBM UrbanCode Deploy components.
- Workflow
- The name of the workflow that contains the AntHillPro builds to
import.
- Status
- The status that a build life must have before it can be imported.
The server only imports build lives that contain this status.
- Artifact Sets
- If Copy to CodeStation is checked, type
the list of artifact sets that are resolved in CodeStation. Place
each list item on a new line.
- Import Versions Automatically
- Select this check box to check for new versions periodically and to import new versions
automatically. If you do not import versions automatically, you can import versions manually by
clicking and then clicking Import New Versions.
- Copy to CodeStation
- This option, which is selected by default, creates tamper-protected copies of the artifacts and
stores them in the embedded artifact management system, CodeStation. If the check box is cleared,
only metadata about the artifacts is imported. In most cases, keep this check box selected. The
default for this setting is in the system setting Components copy to CodeStation by
default; see Server settings.
- Default Version Type
- Specify how to import versions into CodeStation:
- Full
- Each version is comprehensive and contains all artifacts.
- Incremental
- Each version contains a subset of artifacts.
- Use the system's default version import agent/tag
- If this parameter is selected, the agent or tag that you specified
on the System Settings page is used to import
component artifacts. Agents must have access to the system where the
artifacts are located. See Server settings
- Import new component versions using a single agent
- If this parameter is selected, use the Agent for Version
Imports field to identify the agent that
is used to import artifacts into the component. The
agent must have access to the system where the artifacts are located.
To import artifacts from where the server is located,
install an agent in the same location and specify
that agent.
- Import new component versions using any agent with
the specified tag
- If this parameter is selected, use the Agent Tag for
Version Imports field to identify the
tag that is used to select agents to import artifacts into the
component. All tagged agents must have access to the
system where the artifacts are located.
- Use Default Artifact Cleanup Settings
- To apply the component version cleanup settings that are specified on the System
Settings page, select the Use Default Artifact Cleanup Settings
check box. If this check box is cleared, you must specify how long to keep component versions. For more information about cleaning up component versions, see Cleaning up component versions.
- Run Process after a Version is Created
- To automatically run a process after versions are
imported, select this check box, and then specify an application process and an environment for the
process. The process runs only when the version is imported automatically, not when you import
versions manually. Similarly, the process does not run when you create versions with the REST API or
the udclient command. If the automatic version import finds multiple versions, the
process runs only once.
- Click Save.
Results
The new component is listed on the
Components page. The Versions tab shows the available
versions of the component. If you selected the
Import Versions
Automatically check box, versions are displayed automatically. Otherwise, click
Import New Versions to show the available versions. Depending on the number
and size of the artifacts, it might take time before the versions are displayed. To see the
artifacts in the component, click a component version.
What to do next
Create processes for the component. See
Creating component processes.