TestPackage.EmbeddedReadmeFile 7.0.0

This is embedded readme NuGet Gallery — Where packages are found

This is an implementation of the NuGet Gallery and API. This serves as the back-end and community website for the NuGet client. For information about the NuGet project, visit the Home repository.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Build and Run the Gallery in (arbitrary number) easy steps

1. Prerequisites:

   1. Visual Studio 2017 - Install the following Workloads:
      • ASP.NET and web development
      • Azure development
   2. PowerShell 4.0
   3. SQL Server 2016
      • For development purposes connection strings point to (localdb)\mssqllocaldb, make sure that the DB engine version 13.0 or greater is being used (check by running sqllocaldb info mssqllocaldb in the command line).

2. Clone it!

   PS C:\Code> git clone https://github.com/NuGet/NuGetGallery.git

3. Build it!

   PS C:\Code> cd NuGetGallery
   PS C:\Code\NuGetGallery> .\build
   

4. Set up the website!

   PS C:\Code\NuGetGallery> .\tools\Setup-DevEnvironment.ps1

5. If you would like to configure your gallery instance to use MSA/AAD, please follow the steps listed here.

6. Ensure the NugetGallery project is the StartUp Project and press F5 to run the site! That's it!

When working with the gallery, e-mail messages are saved to the file system (under ~/App_Data). You can use an SMTP server instead by editing src\NuGetGallery\Web.Config and adding a Gallery.SmtpUri setting. Its value should be an SMTP connection string, such as: smtp://user:password@smtpservername:25. You can also turn off e-email confirmations by changing the value of Gallery.ConfirmEmailAddresses to false in the src\NugetGallery\Web.Config file.

Visual Studio may modify the applicationhost.config file. You can force git to ignore changes to this file with:

git update-index --assume-unchanged .vs/config/applicationhost.config

You can undo this with this command:

git update-index --no-assume-unchanged .vs/config/applicationhost.config

This should help prevent unwanted file commits.

Deploy

You will find instructions on how to deploy the Gallery to Azure here.

Contribute

If you find a bug with the gallery, please visit the Issue tracker and create an issue. If you're feeling generous, please search to see if the issue is already logged before creating a new one.

When creating an issue, clearly explain

• What you were trying to do.
• What you expected to happen.
• What actually happened.
• Steps to reproduce the problem.

Also include any information you think is relevant to reproducing the problem such as the browser version you used. Does it happen when you switch browsers. And so on.

Submit a patch

Before starting work on an issue, either create an issue or comment on an existing issue to ensure that we're all communicating. We have a list of items that are up for grabs and you can start working on (but always ping us beforehand).

To contribute to the gallery, make sure to create a fork first. Make your changes in the fork following the Git Workflow. When you are done with your changes, send us a pull request.