sagcc add repository assets flatfile
Add a flat file repository that contains user-created source assets.
Syntax
Command Central syntax:
sagcc add repository assets flatfile name=repoName
[location=flat-file-repo-folder-or-zip-on-server|-i flat-file-repo-zip-on-client]
[registryRoot=URL] [registryNamespacesRoot=URL]
[description=description] [overwrite=true|false][options]
Not supported by Platform Manager.
Arguments and Options
Argument or Option | Description |
name=repoName | Required. A unique name for the flat file repository that you are adding. |
location=flat-file-repo-folder-or-zip-on-server | The path to the directory on the Command Central server that contains the flat file repository or the zip archive of the flat file. |
-i flat-file-repo-zip-on-client | The path to the zip archive of the flat file repository on a client machine. |
[registryRoot=URL] | Optional. A valid URL that points to the location of the registry that stores the metadata for the assets in the flat file repository. The registry is located inside the local directory that stores the flat file repository. For example, if the flat file repository is located in the C:\fileRepo directory and the registry directory is "MyRegistry", you must set this parameter as follows: registryRoot=/MyRegistry |
[registryNamespacesRoot=URL] | Optional. A valid URL that points to the location of the directory that stores the registry namespaces. The namespace directory is located inside the registry directory. For example, if the registry directory is C:\fileRepo, you must set this parameter as follows: registryNamespacesRoot=/MyRegistryNs |
[description=description] | Optional. A description of the asset repository. |
[overwrite=true|false] | Optional. Use this argument when re-posting build artifacts from a Jenkins CI job. When the argument is set to true: If the repository does not exist, Command Central creates the repository. If the repository exists, Command Central removes the existing repository and creates a new one. The default is true. |
[options] | Optional. The command allows all options supported by the Command Line Interface. For a description of the options, see
Common Options. |
Usage Notes
You must specify where the flat file repository is located either using the
location argument, or the
input file option.
If you do not specify values for the
registryRoot and
registryNamespacesRoot arguments, Command Central resolves the directory path to "." and looks for the registry at the root of:
the folder that you specify in the
location argument
in the
Software AG_directory /profiles/CCE/data/flatfile/<repoName> directory. If you specify a zip archive, Command Central unzips the archive in this directory (regardless of whether the archive is located on the server or client).
When creating or updating an asset repository, you can check the progress of the operation and troubleshoot issues using
Jobmanager Jobs Commands or in the Command Central web user interface, go to Stacks > Jobs.
Example When Executing on Command Central
To add a flat file asset repository with name "f1" from a folder on the Command Central server:
sagcc add repository assets flatfile name=f1 location=C:\CommandCentral\AssetRepo
description="Local asset build repository"
To add a flat file asset repository with name "f1" from a zip archive, located on the Command Central server:
sagcc add repository assets flatfile name=f1 location=C:\CommandCentral\AssetRepo.zip
description="Local asset build repository"
To add a flat file asset repository with name "f1" from a zip archive, located on the client:
sagcc add repository assets flatfile name=f1 -i C:\CommandCentral\AssetRepo.zip
description="Local asset build repository"
In this example, registryRoot and registryNamespacesRoot are not included and Command Central resolves them to the default values:
registryRoot="." registryNamespacesRoot="."
To add a flat file asset repository with name "f1" from a zip archive, located on the client, specify "MyRegistry" as the registry directory, and "MyRegistryNs" as the directory for the registry namespaces:
sagcc add repository assets flatfile name=f1
-i C:\CommandCentral\AssetRepo.zip registryRoot="/MyRegistry"
registryNamespacesRoot="/MyRegistryNs" description="Local asset build repository."