Note: GitHub Packages is currently in beta for GitHub Enterprise Server 2.22. To join the beta for your GitHub Enterprise Server instance, use the sign-up form.
Note: When installing or publishing a docker image, GitHub Packages does not currently support foreign layers, such as Windows images.
Bei GitHub Packages authentifizieren
You need an access token to publish, install, and delete packages.
You can use a personal access token (PAT) to authenticate to GitHub Packages or the GitHub API. When you create a personal access token, you can assign the token different scopes depending on your needs. For more information about packages-related scopes for a PAT, see "About permissions for GitHub Packages."
To authenticate to a GitHub Packages registry within a GitHub Actions workflow, you can use:
GITHUB_TOKEN
to publish packages associated with the workflow repository.- a PAT to install packages associated with other private repositories (which
GITHUB_TOKEN
can't access).
Authenticating with GITHUB_TOKEN
in GitHub Actions
Use the following command to authenticate to GitHub Packages in a GitHub Actions workflow using the GITHUB_TOKEN
instead of hardcoding a token in a nuget.config file in the repository:
dotnet nuget add source --username USERNAME --password ${{ secrets.GITHUB_TOKEN }} --store-password-in-clear-text --name github "https://nuget.HOSTNAME/OWNER/index.json"
For more information about GITHUB_TOKEN
used in GitHub Actions workflows, see "Authentication in a workflow."
Authenticating with a personal access token
Du musst ein persönliches Zugriffstoken mit dem entsprechenden Geltungsbereich verwenden, um Pakete in GitHub Packages zu veröffentlichen und zu installieren. Weitere Informationen findest Du unter „Über GitHub Packages."
To authenticate to GitHub Packages with the dotnet
command-line interface (CLI), create a nuget.config file in your project directory specifying GitHub Packages as a source under packageSources
for the dotnet
CLI client.
You must replace:
USERNAME
with the name of your user account on GitHub.TOKEN
with your personal access token.OWNER
with the name of the user or organization account that owns the repository containing your project.HOSTNAME
with the host name for your GitHub Enterprise Server instance.
If your instance has subdomain isolation enabled:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<packageSources>
<clear />
<add key="github" value="https://nuget.HOSTNAME/OWNER/index.json" />
</packageSources>
<packageSourceCredentials>
<github>
<add key="Username" value="USERNAME" />
<add key="ClearTextPassword" value="TOKEN" />
</github>
</packageSourceCredentials>
</configuration>
If your instance has subdomain isolation disabled:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>netcoreapp3.0</TargetFramework>
<PackageId>OctodogApp</PackageId>
<Version>1.0.0</Version>
<Authors>Octodog</Authors>
<Company>GitHub</Company>
<PackageDescription>This package adds an Octodog!</PackageDescription>
<RepositoryUrl>https://github.com/octo-org/octo-cats-and-dogs</RepositoryUrl>
</PropertyGroup>
</Project>
Ein Paket veröffentlichen
You can publish a package to GitHub Packages by authenticating with a nuget.config file.
Publishing a package using a nuget.config file
When publishing, you need to use the same value for OWNER
in your csproj file that you use in your nuget.config authentication file. Specify or increment the version number in your .csproj file, then use the dotnet pack
command to create a .nuspec file for that version. For more information on creating your package, see "Create and publish a package" in the Microsoft documentation.
-
Authentifizieren bei GitHub Packages. Weitere Informationen findest Du unter „Bei GitHub Packages authentifizieren“.
-
Create a new project.
dotnet new console --name OctocatApp
-
Add your project's specific information to your project's file, which ends in .csproj. You must replace:
OWNER
with the name of the user or organization account that owns the repository containing your project.REPOSITORY
with the name of the repository containing the package you want to publish.1.0.0
with the version number of the package.HOSTNAME
with the host name for your GitHub Enterprise Server instance.
<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <OutputType>Exe</OutputType> <TargetFramework>netcoreapp3.0</TargetFramework> <PackageId>OctocatApp</PackageId> <Version>1.0.0</Version> <Authors>Octocat</Authors> <Company>GitHub</Company> <PackageDescription>This package adds an Octocat!</PackageDescription> <RepositoryUrl>https://HOSTNAME/OWNER/REPOSITORY</RepositoryUrl> </PropertyGroup> </Project>
-
Package the project.
dotnet pack --configuration Release
-
Publish the package using the
key
you specified in the nuget.config file.dotnet nuget push "bin/Release/OctocatApp.1.0.0.nupkg" --source "github"
Nachdem Du ein Paket veröffentlicht hast, kannst Du das Paket auf GitHub ansehen. Weitere Informationen findest Du unter „Anzeigen von Paketen."
Publishing multiple packages to the same repository
To publish multiple packages to the same repository, you can include the same GitHub repository URL in the RepositoryURL
fields in all .csproj project files. GitHub matches the repository based on that field.
For example, the OctodogApp and OctocatApp projects will publish to the same repository:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>netcoreapp3.0</TargetFramework>
<PackageId>OctodogApp</PackageId>
<Version>1.0.0</Version>
<Authors>Octodog</Authors>
<Company>GitHub</Company>
<PackageDescription>This package adds an Octodog!</PackageDescription>
<RepositoryUrl>https://HOSTNAME/octo-org/octo-cats-and-dogs</RepositoryUrl>
</PropertyGroup>
</Project>
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>netcoreapp3.0</TargetFramework>
<PackageId>OctocatApp</PackageId>
<Version>1.0.0</Version>
<Authors>Octocat</Authors>
<Company>GitHub</Company>
<PackageDescription>This package adds an Octocat!</PackageDescription>
<RepositoryUrl>https://HOSTNAME/octo-org/octo-cats-and-dogs</RepositoryUrl>
</PropertyGroup>
</Project>
Ein Paket installieren
Using packages from GitHub in your project is similar to using packages from nuget.org. Add your package dependencies to your .csproj file, specifying the package name and version. For more information on using a .csproj file in your project, see "Working with NuGet packages" in the Microsoft documentation.
-
Authentifizieren bei GitHub Packages. Weitere Informationen findest Du unter „Bei GitHub Packages authentifizieren“.
-
To use a package, add
ItemGroup
and configure thePackageReference
field in the .csproj project file, replacing theOctokittenApp
package with your package dependency and1.0.0
with the version you want to use:<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <OutputType>Exe</OutputType> <TargetFramework>netcoreapp3.0</TargetFramework> <PackageId>OctocatApp</PackageId> <Version>1.0.0</Version> <Authors>Octocat</Authors> <Company>GitHub</Company> <PackageDescription>This package adds an Octocat!</PackageDescription> <RepositoryUrl>https://HOSTNAME/OWNER/REPOSITORY</RepositoryUrl> </PropertyGroup> <ItemGroup> <PackageReference Include="OctokittenApp" Version="12.0.2" /> </ItemGroup> </Project>
-
Install the packages with the
restore
command.dotnet restore
Problemlösungen
Your NuGet package may fail to push if the RepositoryUrl
in .csproj is not set to the expected repository .