The following topics describe pmgit subcommands and their arguments.
Topics:The following topics describe pmgit subcommands and their arguments.
Topics:This subcommand exports the current policies from the SVN policy repository to a Git policy repository, and has the following arguments:
Alias |
-g |
Type |
string |
Value |
<git-policy-repository-url> |
Default |
N/A |
Description: Sets the URL of the Git policy repository. The policy repository must be an empty bare repository, or Git will reject the operation.
Syntax
--git-url <git-policy-repository-url>
Alias |
-b |
Type: |
string |
Values: |
<branch-of-policy-files> |
Default: |
master |
Description: Sets the Git branch where the policy files are stored. If this argument is not specified, policies are exported to the default branch (master).
Syntax
--branch <branch-of-policy-files>
In this example, the SVN policy repository is exported to the exported_policies.git Git policy repository. The URL to the Git policy repository is https://github.com/user/exported_policies.git, and the policies are exported to the main branch.
pmgit export --git-url https://github.com/user/exported_policies.git --branch main
This subcommand imports policies from an existing Git policy repository and commits the files on top of the trunk in the SVN policy repository.
Alias |
-g |
Type |
string |
Value |
<git-policy-repository-url> |
Default |
N/A |
Description: Sets the URL of the Git policy repository. The policy repository must be an existing repository, containing the policy files.
Syntax
--git-url <git-policy-repository-url>
Alias |
-b |
Type: |
string |
Values: |
<branch-of-policy-files> |
Default: |
master |
Description: Sets the Git branch where the policy files are stored. If this argument is not provided, policies are imported from the default branch (master).
Syntax
--branch <branch-of-policy-files>
In this example, an existing Git policy repository is imported from the URL https://github.com/user/exported_policies.git. The branch in this example is not specified by an argument, so the policies are imported from default (master) branch.
pmgit import --git-url https://github.com/user/policies_to_import.git
This subcommand enables Git policy management. You can no longer edit policies on the policy server.
Alias |
-e |
Type |
string |
Value |
N/A |
Default |
N/A |
Description: Before enabling Git policy management, policies are exported from SVN to an empty Git policy repository. This option cannot be used in conjunction with the -m (--import) option.
Syntax
--export
Alias |
-m |
Type |
string |
Value |
N/A |
Default |
N/A |
Description: Before enabling Git policy management, policies are imported from an existing Git policy repository. This option cannot be used used in conjunction with the -e (--export) option.
Syntax
--import
Alias |
-g |
Type |
string |
Value |
<git-policy-repository-url> |
Default |
N/A |
Description: Sets the URL of the Git policy repository. This option only has an effect when used in conjunction with the -e (--export) or -m (--import) options.
Syntax
--git-url <git-policy-repository-url>
Alias |
-b |
Type: |
string |
Values: |
<branch-of-policy-files> |
Default: |
master |
Description: Sets the Git branch where the policy files are stored. If this argument is not set, the default branch (master) will be used. This option only has an effect when used in conjunction with the -e (--export) or -m (--import) options.
Syntax
--branch <branch-of-policy-files>
Alias |
-u |
Type: |
integer |
Values: |
0-60 (minutes) |
Default: |
5 (minutes) |
Description: Sets the synchronization interval between Git and SVN. This value must be in the [0-60] minutes interval. If this argument is not set, the default value (5 minutes) will be used. If this argument is set to 0, periodic updates will be disabled. For manual update, run the pmgit update command.
Syntax
--update-interval <[0-60]>
Alias |
-a |
Type: |
string |
Values: |
<path-to-script> |
Default: |
N/A |
Description: Sets the path to a user-defined script which is run when the synchronization from Git to SVN fails due to syntax errors. This option only has an effect when used in conjunction with the -e (--export) or -m (--import) options.
Syntax
--alert-script <path-to-script>
In this example, the Git policy management is enabled, the SVN repository is exported to an empty Git policy repository, which has the URL https://github.com/user/exported_policies.git. The name of the branch is main, the update interval is set to 60 minutes, and the path to the alert script is /path/to/script.
pmgit enable pmgit enable -e -g https://github.com/user/exported_policies.git -b main -u 60 -a /path/to/script
© 2024 One Identity LLC. ALL RIGHTS RESERVED. Conditions d’utilisation Confidentialité Cookie Preference Center