girar-task-add-git(1)

girar-nmu utils

NAME

girar-task-add-git - girar helper for building a git/gear repository.

SYNOPSIS

[</path/to/gear-repository.git> ...]

DESCRIPTION

girar-task-add-git, girar-task-for-each-git, girar-build-git - girar helper for git/gear repository. It checks if all changes are added to git index, commits them (--commit mode) or checks if all changes are commited (--no-commit mode), (optionally) creates a tag in current git repository, remotely clones gitery:/gears/ repository, pushes the tag to gitery:, and either adds package build with the tag to a specified task with -a option, or current task, with -A option, or builds a package from the tag. It also can remove the remote repository (with -K option).

The scripts differ in their default behaviour depending on their name. girar-task-add-* add the arguments to the specified or to the last task, girar-task-for-each-* create and run separate tasks for each argument, girar-build-* create and run the arguments in one big task.

OPTIONS

Git/Gear repository options.

-c|--commit, --no-edit: Commit. If modified files are found, call gear-commit. If --no-edit is present, call gear-commit with --no-edit option. The modified files should be added to git index. If not, the script will abort to prevent accidental modifications to be commited. --no-commit disables -c|--commit.
-C|--commit-no-edit: Shortcut option. Same as -c|--commit --no-edit above.
-E|--expect-git-branch git branch name: Name of the local git branch. Default is none. If provided, the script will check that we are on the branch and abort if we are not.
-k|--kill-before: Try to kill remote git repository before upload (useful for robotic and nmu builds).
-K|--kill-after: Kill remote git repository after upload (useful for robotic and nmu builds).
--cm|--tag-message tag message: Specifies a message for git tag tag. Default is tag name.
--cm|--commit-message commit message: Specifies a message for git commit. Default is none (git will ask itself).
--gitery-name|--gitery-path name or path on gitery: Specifies a repository name or path on gitery. Sometimes the name on gitery differs from the name of local git repository. It also can be used to run a task from a tag in a repository of another maintainer. Together with -R <alias> it can be used to run task from an alias. Default is to guess from current gear repository. If a path a specified, then git init-db / clone / push is skipped.
-p|--prefix prefix: Prefix to add before gitery repository name. Useful to distinguish among automated and own repositories on gitery. By default prefix is "00-tmp-".
-r|--push-related-tags: Push related tags as well. Push all tags that are ancestors of the current build tag. Useful when intermediate tags, like v@version@, are created. Disabled by default. If enabled in config, is disabled by --no-push-related-tags.
-t|--tag [tag]: Call git tag [tag]. Default is %VERSION-%RELEASE. If -t or -T is not specified then the last commit is expected to be a tag.
-T|--auto-tag: Call git tag %VERSION-%RELEASE. If -t or -T is not specified then the last commit is expected to be a tag. --no-auto-tag disables -T|--auto-tag.
--try-tag: If the auto tag already exists, --try-tag adds .tryN to the tag where N is 2 or more such that tag.tryN does not exist. --no-try-tag disables --try-tag.

Add to task options.

-a|--add-to-task|--task [task ID]: Specifies the girar task to add. Also enables "task add" mode, see below.
-A|--add: Enables "task add" mode. In this mode, the argument(s) are added to the current or the specified task. This disables "for each" mode and stops "build" mode from creating a separate task.
[-B|--before|--before-subtask before_subtask_id]: before_subtask_id is used in the extended format of girar-task add command: girar-task add [<task_id> [<before_subtask_id>]] srpm <filename>

Run task options.

-D|--deps dep1,...,depN: Comma separated list of task dependencies to add.
-S|--share: Create and run a shared task. Disabled by default. Also, --no-share disables it.
--gm|--girar-message|--gyle-message message: Specifies a girar task message.
--test-only: Run task --test-only
--commit|-O|--no-test-only: Do not run task --test-only (default).
--hurry: Run task with --hurry (undocumented girar option)
--no-hurry: Remove --hurry from run command line, --no-hurry option does not set --unhurry.
--unhurry: Run task with --unhurry (undocumented girar option)
--fail-early: Stop building the task after the first error.
--fail-late: Do not stop building the task after the first error.

-b|--branch repository branch: Name of the repository branch. Values: sisyphus|p8|.. Default is sisyphus.
-R|--girar girar(gyle) ssh alias: By default, gyle.altlinux.org account should be configured as girar or gyle in ~/.ssh/config. If you do not follow that convention, use -R <your girar ssh alias> option.
-H|--gitery gitery ssh alias: Alternative gitery or ssh alias for gitery, for example, git.e2k. If not specified, by default, gitery is used where ssh account is required and git.altlinux.org is used where http:// is enough.
-W|--webery tasks web site: Alternative site that hosts girar tasks. If not specified, by default, git.altlinux.org is used.
[--web-tasks-url tasks web site url]: The default URL for web task site is http://tasks web site. See --webery for details. --web-tasks-url overrides this URL.
--dry-run: Echo state-changing commands instead of doing them. An extra safety. Also a bit useful for debugging.
-P|--profile profile: Name of the configuration profile. The profile is loaded as /etc/girar-nmu/profile and $HOME/.config/girar-nmu/profile. Note that default configuration is stored in /etc/girar-nmu/default and $HOME/.config/girar-nmu/default.
-V|--version: Print version and exit.
-v|--verbose: Verbose. Prints extra information. Multiple -v accumulate. -v -v -v set debug mode (set -x).
-q|--quiet: Quiet. Print no warnings.
-h|--help: Display this help and exit.

AUTHOR

Written by Igor Vlasenko <viy@altlinux.org>.

COPYING

This is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

2023-11-08

2.015.3