logoCloudomation Docs


    class tasks.task_git.TaskGIT

    Run git commands on a repository.

    Note that the git task allows you to interact with your git repository, but does not automatically synchronise the flow scripts in your git repository with your Cloudomation account. To synchronise flow scripts and settings from git into your Cloudomation account, use this git sync flow script available in the public flow script library. Feel free to make a copy and adapt it to your specific use case.

    Two commands are available:

    • get
    • metadata

    get: fetch the specified reference and return the files. The files can either be returned in the outputs of the task or placed in cloudomation using the "files_path" argument.

    metadata: Only get the metadata of the specified reference.


    commandstrThe command you want to execute. Supports "get" and "metadata"
    files_pathstrNoneSave the files of the repository in cloudomation, this is the target directory. In the case of a get command, the contents of the remote repository will be stored here. If not specified or None the output files will exist.
    httpCookiestrNoneAuthentication for some private git repositories is possible via http cookie
    passwordstrNoneThe password to be used for authentication. Can be None. Alternatively, SSH keys can be used.
    refstrdevelopA commit reference, e.g. the commit you want to get. Can be a branch, tag, or git commit SHA
    repository_urlstrThe remote URL of the repository. The url can contain HTTP basic auth credentials
    ssh_hostkeystrNoneThe content of the ssh known hosts file. Can be False to disable host key checking
    ssh_keystrNoneThe content of the ssh private keyfile associated with the repository, currently only works with non-password protected keyfiles
    usernamestrNoneThe username to be used for authentication. Can be None. Alternatively, SSH keys can be used.


    author_emailstrThe email of the commiter of the specified reference
    author_namestrThe name of the commiter of the specified reference
    commit_messagestrThe commit message of the reference
    commit_shastrThe sha of the commit
    datefloatThe date and time of the commit as POSIX timestamp
    date_strstrThe date and time in iso8601 date and time, with zone info
    errorstrThe stderr of the last successful git command
    fileslistA list of dictionaries with two keys: name and content
    outputstrThe stdout of the last successful git command
    short_shastrThe short sha of the commit
    status_codeintThe status code returned by the git command
    execution_idintThe ID of the task execution
    messagestrThe ended message for the task. If the task ended with an error, the message will contain information about what went wrong
    statusstrThe ended status for the task. Either "success" or "error".


    input_list = ['command', 'files_path', 'httpCookie', 'password', 'ref', 'repository_url', 'ssh_hostkey', 'ssh_key', 'username']output_list = ['author_email', 'author_name', 'commit_message', 'commit_sha', 'date', 'date_str', 'error', 'files', 'log', 'output', 'short_sha', 'status_code']version = 1


    run ()


    import flow_api
    def handler(system: flow_api.System, this: flow_api.Execution):
    task = this.task(
    # The url to a public repository
    # Get the reference develop, I could also specify a sha, another branch or a tag
    outputs = task.get('output_value')
    # Note that both the name and content of every file is part of the output
    task2 = this.task(
    outputs = task2.get('output_value')
    # Here there are no files in the output
    # But they are saved to cloudomation:
    files = system.files(dir='flow_library')
    for file in files:
    return this.success('all done')