deploy¶

                                                                                
 Usage: lftools-uv deploy [OPTIONS] COMMAND [ARGS]...                           
                                                                                
 Deploy files to a Nexus sites repository.                                      
                                                                                
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                                  │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ archives                  Archive files to a Nexus site repository.          │
│ copy-archives             Copy files for archiving.                          │
│ file                      Deploy a file to Nexus using Maven.                │
│ logs                      Deploy logs to a Nexus site repository.            │
│ s3                        Deploy logs and archives to a S3 bucket.           │
│ maven-file                Deploy a file to a Nexus maven2 repository.        │
│ nexus                     Deploy a Maven repository to a specified Nexus     │
│                           repository.                                        │
│ nexus-stage               Deploy a Maven repository to a Nexus staging       │
│                           repository.                                        │
│ nexus-stage-repo-close    Close a Nexus staging repo.                        │
│ nexus-stage-repo-create   Create a Nexus staging repo.                       │
│ nexus-zip                 Deploy zip file containing artifacts to Nexus      │
│                           using cURL.                                        │
╰──────────────────────────────────────────────────────────────────────────────╯
                                                                                
 Deploy commands use ~/.netrc for authentication. This file should be           
 pre-configured with an entry for the Nexus server. Eg.                         
                                                                                
                                                                                
  machine nexus.opendaylight.org login logs_user password logs_password         
                                                                               

Commands¶

archives¶

                                                                                
 Usage: lftools-uv deploy archives [OPTIONS] {nexus_url} {nexus_path}           
                                   {workspace}                                  
                                                                                
 Archive files to a Nexus site repository.                                      
                                                                                
 Provides 2 ways to archive files:                                              
                                                                                
                                                                                
  1) globstar pattern provided by the user.                                     
  2) $WORKSPACE/archives directory provided by the user.                        
                                                                                
                                                                                
 To use this command the Nexus server must have a site repository configured    
 with the name "logs" as this is a hardcoded log path.                          
                                                                                
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ *    nexus_url       <str>  Nexus server URL                                 │
│                             [env var: NEXUS_URL]                             │
│                             [required]                                       │
│ *    nexus_path      <str>  Path on Nexus where files will be deployed       │
│                             [env var: NEXUS_PATH]                            │
│                             [required]                                       │
│ *    workspace       <str>  Workspace directory containing files to deploy   │
│                             [env var: WORKSPACE]                             │
│                             [required]                                       │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --pattern  -p      <str>  Unix glob patterns for files to deploy             │
│ --help                    Show this message and exit.                        │
╰──────────────────────────────────────────────────────────────────────────────╯

copy-archives¶

                                                                                
 Usage: lftools-uv deploy copy-archives [OPTIONS] {workspace} [pattern]...      
                                                                                
 Copy files for archiving.                                                      
                                                                                
 Arguments: workspace: Typically a Jenkins WORKSPACE to copy files from.        
 pattern: Space-separated list of Unix style glob patterns of files to copy for 
 archiving.                                                                     
                                                                                
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ *    workspace      <str>  Workspace directory to copy files from            │
│                            [env var: WORKSPACE]                              │
│                            [required]                                        │
│      pattern        <str>  Unix glob patterns of files to copy for archiving │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                                  │
╰──────────────────────────────────────────────────────────────────────────────╯

logs¶

                                                                                
 Usage: lftools-uv deploy logs [OPTIONS] {nexus_url} {nexus_path} {build_url}   
                                                                                
 Deploy logs to a Nexus site repository.                                        
                                                                                
 This script fetches logs and system information and pushes them to Nexus for   
 log archiving.                                                                 
                                                                                
 To use this script the Nexus server must have a site repository configured     
 with the name "logs" as this is a hardcoded path.                              
                                                                                
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ *    nexus_url       <str>  Nexus server URL                                 │
│                             [env var: NEXUS_URL]                             │
│                             [required]                                       │
│ *    nexus_path      <str>  Path on Nexus where logs will be deployed        │
│                             [env var: NEXUS_PATH]                            │
│                             [required]                                       │
│ *    build_url       <str>  Build URL for log collection                     │
│                             [env var: BUILD_URL]                             │
│                             [required]                                       │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                                  │
╰──────────────────────────────────────────────────────────────────────────────╯

maven-file¶

                                                                                
 Usage: lftools-uv deploy maven-file [OPTIONS] {nexus_url} {repo_id}            
                                     {file_name}                                
                                                                                
 Deploy a file to a Nexus maven2 repository.                                    
                                                                                
 Deployment runs through mvn, so the server credentials come from your          
 settings.xml rather than from this command. The Maven default of               
 "~/.m2/settings.xml" applies unless overridden, in the following order:        
                                                                                
                                                                                
  1. Passed through CLI option "-s" ("-gs" for global-settings)                 
  2. Environment variable "$SETTINGS_FILE" ("$GLOBAL_SETTINGS_FILE"             
     for global-settings)                                                       
  3. Maven default "~/.m2/settings.xml".                                        
                                                                                
                                                                                
 If pom-file is passed in via the "-f" option then the Maven GAV parameters are 
 not necessary. pom-file setting overrides the Maven GAV parameters.            
                                                                                
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ *    nexus_url      <str>  Nexus server URL                                  │
│                            [env var: NEXUS_URL]                              │
│                            [required]                                        │
│ *    repo_id        <str>  Server ID as defined in settings.xml              │
│                            [env var: REPO_ID]                                │
│                            [required]                                        │
│ *    file_name      <str>  File name to deploy                               │
│                            [env var: FILE_NAME]                              │
│                            [required]                                        │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --maven-bin        -b       <str>  Path of maven binary.                     │
│                                    [env var: MAVEN_BIN]                      │
│ --global-settings  -gs      <str>  Global settings file.                     │
│                                    [env var: GLOBAL_SETTINGS_FILE]           │
│ --settings         -s       <str>  Settings file.                            │
│                                    [env var: SETTINGS_FILE]                  │
│ --maven-params     -p       <str>  Pass Maven commandline options to the mvn │
│                                    command.                                  │
│ --artifact-id      -a       <str>  Maven Artifact ID.                        │
│ --classifier       -c       <str>  File classifier.                          │
│ --pom-file         -f       <str>  Pom file to extract GAV information from. │
│ --group-id         -g       <str>  Maven Group ID.                           │
│ --version          -v       <str>  Maven artifact version.                   │
│ --help                             Show this message and exit.               │
╰──────────────────────────────────────────────────────────────────────────────╯

nexus¶

                                                                                
 Usage: lftools-uv deploy nexus [OPTIONS] {nexus_repo_url} {deploy_dir}         
                                                                                
 Deploy a Maven repository to a specified Nexus repository.                     
                                                                                
 This script takes a local Maven repository and deploys it to a Nexus           
 repository.                                                                    
                                                                                
 Requires the Nexus Unpack plugin and permission assigned to the upload user.   
                                                                                
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ *    nexus_repo_url      <str>  Nexus repository URL                         │
│                                 [env var: NEXUS_REPO_URL]                    │
│                                 [required]                                   │
│ *    deploy_dir          <str>  Directory containing Maven repository to     │
│                                 deploy                                       │
│                                 [env var: DEPLOY_DIR]                        │
│                                 [required]                                   │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --snapshot  -s        Deploy a snapshot repo.                                │
│ --help                Show this message and exit.                            │
╰──────────────────────────────────────────────────────────────────────────────╯

nexus-stage¶

                                                                                
 Usage: lftools-uv deploy nexus-stage [OPTIONS] {nexus_url}                     
                                      {staging_profile_id} {deploy_dir}         
                                                                                
 Deploy a Maven repository to a Nexus staging repository.                       
                                                                                
 This script takes a local Maven repository and deploys it to a Nexus staging   
 repository as defined by the staging-profile-id.                               
                                                                                
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ *    nexus_url               <str>  Nexus server URL                         │
│                                     [env var: NEXUS_URL]                     │
│                                     [required]                               │
│ *    staging_profile_id      <str>  Nexus staging profile ID                 │
│                                     [env var: STAGING_PROFILE_ID]            │
│                                     [required]                               │
│ *    deploy_dir              <str>  Directory containing Maven repository to │
│                                     deploy                                   │
│                                     [env var: DEPLOY_DIR]                    │
│                                     [required]                               │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                                  │
╰──────────────────────────────────────────────────────────────────────────────╯

nexus-zip¶

                                                                                
 Usage: lftools-uv deploy nexus-zip [OPTIONS] {nexus_url} {nexus_repo}          
                                    {nexus_path} {deploy_zip}                   
                                                                                
 Deploy zip file containing artifacts to Nexus using cURL.                      
                                                                                
 This script simply takes a zip file preformatted in the correct directory for  
 Nexus and uploads to a specified Nexus repo using the content-compressed URL.  
                                                                                
 Requires the Nexus Unpack plugin and permission assigned to the upload user.   
                                                                                
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ *    nexus_url       <str>  Nexus server URL                                 │
│                             [env var: NEXUS_URL]                             │
│                             [required]                                       │
│ *    nexus_repo      <str>  Nexus repository name                            │
│                             [env var: NEXUS_REPO]                            │
│                             [required]                                       │
│ *    nexus_path      <str>  Path on Nexus where zip will be deployed         │
│                             [env var: NEXUS_PATH]                            │
│                             [required]                                       │
│ *    deploy_zip      <str>  Path to zip file to deploy                       │
│                             [env var: DEPLOY_DIR]                            │
│                             [required]                                       │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                                  │
╰──────────────────────────────────────────────────────────────────────────────╯