Repository Management with Nexus

Abstract

Repository Management with Nexus is a book about Sonatype Nexus.


Copyright
Foreword: 0.9
1. Revision History
1.1. Changes in Edition 0.9
1.2. Changes in Edition 0.8
1.3. Changes in Edition 0.7
1.4. Changes in Edition 0.6
1.5. Changes in Edition 0.5
1. Introducing Sonatype Nexus
1.1. Introduction
1.2. History of Nexus
2. Installing and Running Nexus
2.1. Downloading Nexus
2.1.1. Downloading Nexus Open Source
2.1.2. Downloading Nexus Professional
2.2. Installing Nexus
2.3. Upgrading Nexus
2.4. Running Nexus
2.5. Post-Install Checklist
2.6. Startup Scripts for Linux
2.6.1. Add Nexus as a Service on Redhat, Fedora, and CentOS
2.6.2. Add Nexus as a Service on Ubuntu
2.7. Running Nexus Behind a Proxy
2.8. Installing the Nexus WAR
2.8.1. Running the Nexus WAR in Glassfish
2.9. Installing a Nexus Professional License
3. Configuring Maven to Use Nexus
3.1. Introduction
3.2. Configuring Maven to Use a Single Nexus Group
3.3. Adding Custom Repositories for Missing Dependencies
3.4. Adding a New Repository
3.5. Adding a Repository to a Group
4. Using Nexus
4.1. Introduction
4.2. Browsing Repositories
4.3. Browsing Groups
4.4. Searching for Artifacts
4.5. Uploading Artifacts
4.6. Browsing System Feeds
4.7. Log Files and Configuration
4.8. Changing Your Password
5. Configuring
5.1. Configuring Nexus
5.1.1. Customizing Server Configuration
5.1.2. Managing Repositories
5.1.2.1. Selecting Mirrors for Proxy Repositories
5.1.2.2. Adding a Mirror Entry for a Hosted Repository
5.1.3. Managing Groups
5.1.4. Managing Routes
5.1.5. Managing Scheduled Services
5.1.5.1. Managing Configuration Backups with a Scheduled Service
5.1.6. Managing Security
5.1.6.1. Managing Privileges
5.1.6.2. Managing Repository Targets
5.1.6.3. Managing Security Roles
5.1.6.4. Managing Users
5.1.7. Network Configuration
5.1.8. Nexus Logging Configuration
6. Nexus Plugins
6.1. Introduction
6.2. Installing Plugins
6.3. Available Plugins
6.3.1. Nexus Staging Suite
6.3.2. Nexus Procurement Suite
6.3.3. LDAP Authentication
6.3.4. Google Analytics Plugin
7. Nexus LDAP Integration
7.1. Enabling the LDAP Authentication Realm
7.2. Configuring Nexus LDAP Integration
7.3. Connection and Authentication
7.4. User and Group Mapping
7.4.1. Mapping Users and Groups with Active Directory
7.4.2. Mapping Users and Groups with posixAccount
7.5. Mapping Roles to LDAP Users
7.5.1. Mapping Nexus Roles for External Users
7.5.2. Mapping External Roles to Nexus Roles
8. Nexus Procurement Suite
8.1. Introduction
8.1.1. The Stages of Procurement
8.1.2. Two Approaches to Procurement
8.1.2.1. Procured Release Repository
8.1.2.2. Procured Development Repository
8.2. Installing the Procurement Suite
8.3. Setting up a Procured Repository
8.3.1. Enable Remote Index Downloads
8.3.2. Create a Hosted Repository
8.3.3. Configuring Procurement for Hosted Repository
8.4. Administering a Procured Repository
8.4.1. Viewing the Procurement Management Interface
8.4.2. Configuring a Procurement Rule
8.4.3. Managing Procurement Rules
8.4.4. Stopping Procurement
9. Nexus Staging Suite
9.1. Introduction
9.1.1. How the Staging Suite Works
9.2. Installing the Nexus Staging Suite
9.3. Configuring Staging Profiles
9.3.1. Adding the Staging Deployer Role
9.3.2. Configuring a Staging Target
9.3.3. Configuring Staging Profiles
9.4. Performing a Staged Deployment with Maven
9.4.1. Creating a New Project
9.4.2. Update the POM: Deployment Configuration
9.4.3. Update settings.xml with Deployment Credentials
9.4.4. Deploying to a Staged Repository
9.5. Uploading a Staged Deployment in Nexus
9.6. Managing Staging Repositories in Nexus
9.6.1. Closing and Open Repository
9.6.2. Using the Staging Repository
9.6.3. Promoting a Repository
9.7. Managing Staging Repository with the Nexus Maven Plugin
9.7.1. Running the Nexus Maven Plugin
9.7.2. Configuring Nexus Maven Plugin for Staging
9.7.3. Listing Your Open Staging Repositories
9.7.4. Finishing an Open Staging Repository for Your Project
9.7.5. Dropping a Closed Staging Repository
9.7.6. Promoting a Closed Staging Repository
10. Managing Maven Settings
10.1. Introduction
10.2. Manage Maven Settings Templates
10.3. Downloading Maven Settings with the Nexus Maven Plugin
10.3.1. Running the Nexus Maven Plugin
10.3.2. Configuring Nexus Maven Plugin for Settings Management
10.3.3. Downloading Maven Settings
A. Migrating to Nexus from Artifactory
A.1. Introduction
A.2. Creating an Artifactory Backup
A.3. Installation of the Migration Plugin
A.4. Importing an Artifactory System Backup
A.5. Configuring the Artifactory Import
A.5.1. Configuring Artifactory Group Imports
A.5.2. Configuring Artifactory Repository Imports
A.5.3. Configuring Users and Privileges in the Artifactory Import
A.6. Performing the Artifactory Import
A.7. Configuring Artifactory Clients to Use Nexus
Index

List of Figures

2.1. Nexus Login Window (default login/password is admin/admin123)
2.2. Nexus Professional Licensing Panel
2.3. Nexus Professional End-user License Agreement
2.4. License Upload Finished Dialog
2.5. Uninstall License Confirmation Dialog
2.6. License Uninstall Completed Dialog
3.1. Creating a New Nexus Proxy Repository
3.2. Adding a Nexus Repository
3.3. Adding New Repositories to a Nexus Group
4.1. Nexus Interface for Anonymous Users
4.2. Browsing a Nexus Repository
4.3. Browsing a Nexus Group
4.4. Results of an Artifact Search for "maven"
4.5. Artifact Upload Form
4.6. Browsing Nexus System Feeds
4.7. Browsing Nexus Logs and Configuration
4.8. Selecting the Update Frequency when Tailing a Log File
4.9. Changing Your Nexus Password
5.1. Nexus Server Configuration (File, SMTP, and HTTP Config)
5.2. Nexus Server Configuration (Security, App Server, and HTTP Proxy Config)
5.3. Nexus Server Configuration (Security, App Server, and HTTP Proxy Config)
5.4. Configuring PGP Keyserver Preferences
5.5. Repository Configuration Screen for a Proxy Repository
5.6. Repository Configuration Screen for a Proxy Repository
5.7. Configuring Mirrors for Proxy Repositories
5.8. Configuring Mirrors for a Hosted Repository
5.9. Group Configuration Screen in Nexus
5.10. Routes Configuration Screen in Nexus
5.11. Managing Nexus Scheduled Services
5.12. Configuring a Scheduled Backup of Nexus Configuration
5.13. Managing Security Privileges
5.14. Managing Security Privileges
5.15. Managing Repository Targets
5.16. Managing Repository Targets
5.17. Managing Security Roles
5.18. Managing Security Roles
5.19. Managing Security Roles
5.20. Managing Users
5.21. The Log Configuration Panel
6.1. Installing a Nexus Plugin
7.1. Adding the LDAP Authentication Realm to Available Realms
7.2. Move the LDAP Authentication Realm to the Top of Selected Realms
7.3. LDAP Configuration Option in the Nexus Menu
7.4. Connection and Authentication Configuration for LDAP Integration
7.5. Configuring User Mapping for LDAP Integration
7.6. Group Element Mapping with Dynamic Groups Selected
7.7. Checking the User and Group Mapping in LDAP Configuration
7.8. Viewing All Configured Users
7.9. All Default Realm Users
7.10. All LDAP Users
7.11. Search LDAP Users
7.12. Mapping the Deployment Role to an External User
7.13. Selecting External Role Mapping in the Role Management Panel
7.14. Selecting an Externally Managed Role to Map to a Nexus Role
7.15. Mapping an External Role to a Nexus Role
8.1. Procurement to a Certified Release Repository
8.2. Procurement to a Certified Development Repository
8.3. Artifact Procurement in the Nexus Menu
8.4. Enabling Remote Index Downloads for a Proxy Repository
8.5. Verification that the Remote Index has been Downloaded
8.6. Adding a Hosted Repository
8.7. Adding the "Secured" Hosted Repository
8.8. Adding a Procured Repository
8.9. Configuring Procurement for a Hosted Repository
8.10. Hosted Repository is a Proxy Repository while Procurement is Active
8.11. Viewing a Repository in the Artifact Procurement Interface
8.12. Denying Procurement for Everything Under a Group
8.13. Allowing Access to a Single Artifact in a Denied Group
8.14. Viewing the Effect of Composite Procurement Rules on the Tree
8.15. Effective Procurement Rules for a Particular Node
8.16. Stopping Procurement for a Procured Repository
8.17. Stop Procurement Confirmation Dialog
9.1. Without the Nexus Staging Suite
9.2. With Nexus Staging Suite
9.3. Enterprise Menu after Staging Suite Installation
9.4. Assigning the Staging Deployer Role to the deployment user
9.5. Adding a Repository Target for com.sonatype.sample
9.6. Editing a Staging Profile
9.7. Uploading a Staged Deployment in Nexus
9.8. Listing Repositories Associated with a Staging Profile
9.9. Confirmation and Description Dialog for Closing a Staging Repository
9.10. Closed Repository After Selecting Finish
9.11. Staging Repository Added to the End of a Repository Group
9.12. Viewing Nexus Managed Repositories
9.13. Browsing a Staging Repository
9.14. Browsing Repository via Staging Profiles
9.15. Promoting a Staging Repository
9.16. Selecting the Destination Repository for Staged Repository Promotion
9.17. Confirmation Dialog for Repository Promotion
10.1. The Maven Settings Panel
A.1. Creating an Artifactory System Export
A.2. Artifactory Import Panel from the Nexus Migration Plugin
A.3. Specifying the Artifactory System Backup Path
A.4. Configuring the Artifactory Import
A.5. Configuring Artifactory Group Imports
A.6. Configuring Repositories for Artifactory Import
A.7. Merging a Proxy Repository During Artifactory Import
A.8. Configuring Users During Artifactory Import
A.9. Loading Artifactory Configuration Warning
A.10. Artifactory Import Scheduled Dialog
A.11. Viewing the Migration Logs