Organize your chickens: NuGet for the enterprise

Organize your chickens
NuGet for the Enterprise

Who are we?
Maarten Balliauw
Antwerp, Belgium
www.realdolmen.com
Focus on web
ASP.NET, ASP.NET MVC, PHP, Azure, …
MVP Windows Azure (formerly ASP.NET)
http://blog.maartenballiauw.be
@maartenballiauw

Who are we?
Xavier Decoster
Antwerp, Belgium
www.realdolmen.com
Focus on web/ALM
Visual Studio, TFS, Scrum, ...
Silverlight, ASP.NET, ASP.NET MVC, …
http://www.xavierdecoster.com
@xavierdecoster

Agenda
Chickens?
NuGet
Scenarios
Host your own NuGet repository
Continuous (Package) Integration
(Ab)usingNuGet
Conclusion

Welcome to Dll Hell
Dependency Hell

WelcometoDependency Hell
“A term for the frustrationof software users who have installedsoftware packageswhich have dependencieson specificversionsof other software packages.”
Source: Wikipedia

Causeand Effect
Reinventing the wheel
We don’tneedthatdependency
“If they can do it, we can do it, but better”
Marketing does the versioning
People are waitingfor v2 tobuy
Let’s call it v4 Platform Update SP3 November Edition KB2348063 RTW Refresh
 Whathappenedtoreuse of components?
 We lost ownership of AssemblyVersion ?

Package Management
Using NuGet

Package Management
NuGet to the Rescue!
“NuGet is a Visual Studio extension that makes it easy to install and update open source libraries and tools in Visual Studio.”

Package What?
Package Management
Simple concept
Find Packages
(Re)Use Packages
Produce Packages
“…a collection of software tools to automate the process of installing, upgrading, configuring, and removingsoftware packages…”
Wikipedia

GettingStarted
Tooling:
NuGet Package Manager (http://nuget.org)
NuGet Package Explorer (http://npe.codeplex.com)
Install-Package NuGetPowerTools
Install-Package NuGet.CommandLine
Guidanceanddocumentation
http://docs.nuget.org

Consuming Packages
Simple as adding a reference

Onedialogtorulethemall…
Install-Package
Update-Package
Uninstall-Package
Settings
Package Sources
Local (offline) Cache location
Also: Manage packages on solution level!
Right-click solution > Manage NuGet Packages…

NuGet Package Manager Console
PowerShellenabled!
Extensible!
Scaffolding, NuGetPowerTools, …
%UserProfile%DocumentsWindowsPowerShellNuGet_profile.ps1

Configurable Package Sources
Configurablethrough…
NuGet Library Package Manager (VS add-in)
NuGet.config (in %APPDATA%RoamingNuGetNuGet.config)
NuGet.settings.targets (MSBUILD file part of NuGetPowerTools)

Creating Packages
What’s a package?
Just a zip-filecontaining:
… content and source code (tobeinjectedinto target project)
… PowerShell scripts andexecutables
… configuration file and source code transformations
http://docs.nuget.org/docs/creating-packages/Configuration-File-and-Source-Code-Transformations

Package Conventions
Conventions
http://docs.nuget.org/docs/creating-packages/Package-Conventions
Folder structure
Tools (init.ps1, install.ps1, uninstall.ps1)
Content
Manifest (.nuspec file)
Lib

NuGet Manifest Specification
NuSpec manifest
XML file (with XSD available)
Package metadata

Semantic Versioning
Think about your versioning! (semver.org)
Always specifylowerbound
Use a version range (lowerbound + upperbound) whenversioning of package youdepend on is messed up

Advanced usage scenarios
Host your own NuGet repository
(Ab)using NuGet

Hosting your own repository
Those chickens are mine!

Hosting your own repository
NuGet = public feed
Privacy
Intellectual property
NuGet maintained by package authors
Author removes v1.0.45 and you depend on it

Solutions
Folder / File share
Orchard Gallery (or NuGet Gallery)
NuGet.Server package
MyGet

NuGet.Server Demo
Install-Package NuGet.Server

NuGet.Serverlimitations
Only 1 feed per installation
No UI: up toyoutobuildit
No granular security: only 1 API-keyforentire feed
Conclusion: requiresyoutodevelopifyou want something more useful

Meet MyGet
www.myget.org
NaaS
Register and off you go! (no dev)
Supports Enterprise scenarios
Granular security
Package mirroring

MyGet Demo
Log in to www.myget.org and get started

Fetch the chickens when you need them

Typical source control...
Contains /References (if you are lucky)
...and also Project/_bin_deployable_assemblies
...and also /References/old
...and also /..././../.././References
Usually references GAC-ed assemblies

Dependencies
Software has dependencies. Deal with it.
But are those YOUR intellectual property?
YOUR reason to build software?
YOUR product?
No. They are dependencies. And they don’t belong in source control.

Can I get rid of all these referencedassembliesduplicatedall-over my source control system?
Yes!
Do I needtoinstallandmaintainNuGet on allmybuildagents?
No!

NuGetPowerTools Demo
Organize your build chickens!

3rd partiesdon’tbelong in your SCM
Source control bloatedwiththird-party binaries?
Replacethem with NuGet packages
Commitpackages.config/repositories.config files
Preferablynot the packages
Use NuGetPowerTools
Enable-PackageRestore

Problem!
NuGet feed is subject to change...
PackageSourceMSBuild property to the rescue
NuGet.settings.targets in $(SolutionDir).nuget folder
Nowwhat...
Host yourown feed andmirrorthird-party packages
InternalNuGet.Server
Network Share
Or useMyGetforthat

Organizeyourchickens
Feed structuring
Scopedbyquality: Build, QA, Production, …
Scopedbyaudience: public, restricted access
Other:
Scopedby product version, milestone…
Scopedby target platform

(Ab)using NuGet

Guidance
Publishing a package bringsgreatresponsibility
Breakingchanges in your packages shouldbeversionedaccordingly!
Consumersmightchooseto no longerconsumeany packages youpublished

Guidance
Package Integration ≠ Integration Testing
CI buildsreflect output of source control input
Same input alwaysproducessame output
Do not auto-update packages duringautomatedbuilds!

(Ab)using NuGet?
Change of perspective
NuGet as a package manager
NuGet as a protocol for distributing packages

ExtendingNuGet
Scaffolding, CmdLets, Plug-ins, …

Scaffolding
T4, Mvc, …
CreateyourownPowerShellcmdlets
Automate Visual Studio (access to DTE)

Automate deployments
Build results in .nupkg
Octopus deploys to its tentacles
Test tentacles
Staging tentacles
Production tentacles
www.octopusdeploy.com

NuGet command line plug-ins
Extend NuGet.exe
Custom Commands
How?
Build class library
Reference NuGet.exe
Inherit Command
Deploy your dll to %LocalAppData%NuGetCommands

Chocolatey
NuGet
developer library packages
Chocolatey
applications and tools packager
“yum” or “apt-get” for Windows
www.chocolatey.org

Chocolatey Demo
NuGet desert

Orchard / WebMatrix / …
NuGetnotboundto VS
Orchard CMS: modules & themes
WebMatrix: install page helpers on the fly
Yourapp: offer pluginsthrough a repo

Conclusion

Dependencies & people are chickens
Deal with them! NuGet can help
Set up your own NuGet repository for various reasons
Continuous package integration
NuGet is a package manager
NuGet is a protocol
Conclusion

Thank you!
Any questions?
http://blog.maartenballiauw.be
@maartenballiauw
http://www.xavierdecoster.com
@xavierdecoster

http://www.xavierdecoster.com	631
http://paper.li	34
http://localhost	28
http://blogs.realdolmen.com	19
http://127.0.0.1	16
http://www.linkedin.com	7
http://rdtabletbackend.appspot.com	3
http://a0.twimg.com	2
http://us-w1.rockmelt.com	1

Organize your chickens: NuGet for the enterprise

by Maarten Balliauw on Oct 10, 2011

Accessibility

Categories

Tags

Upload Details

Usage Rights

9 Embeds 741

Statistics

Organize your chickens: NuGet for the enterprise — Presentation Transcript