Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions Directory.Packages.props
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
<Project>
<PropertyGroup>
<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
<RuntimeVersion>8.0.0-rc.2.23479.6</RuntimeVersion>
<AspNetCoreVersion>8.0.0-rc.2.23480.2</AspNetCoreVersion>
<ExtensionsVersion>8.0.0-rc.2.23510.2</ExtensionsVersion>
<RuntimeVersion>8.0.0-rtm.23511.16</RuntimeVersion>
<AspNetCoreVersion>8.0.0-rtm.23512.10</AspNetCoreVersion>
<ExtensionsVersion>8.0.0-rtm.23511.3</ExtensionsVersion>
</PropertyGroup>
<ItemGroup>
<!-- Azure SDK for .NET dependencies -->
Expand Down
62 changes: 45 additions & 17 deletions docs/getting-started.md
Original file line number Diff line number Diff line change
@@ -1,40 +1,65 @@
# Set up your environment

## Install Visual Studio 2022 Internal Preview
## Install Visual Studio 2022 Internal Preview (dogfood)

1. [Visual Studio 2022 Enterprise IntPreview Setup](https://aka.ms/vs/17/intpreview/vs_enterprise.exe)
- This channel updates nightly. You need a build from 15-Aug-2023 or later.
2. Set an environment variable `VSEnableAspireOrchestrationParameter=1`
3. Add NuGet sources to apply the following feeds
- This channel updates nightly. You need a build from 12-Oct-2023 or later.
2. Add NuGet sources to apply the following feeds
- https://pkgs.dev.azure.com/dnceng/internal/_packaging/dotnet-tools-internal/nuget/v3/index.json
- https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-grpc-pre-release/nuget/v3/index.json
- See [Install and manage packages in Visual Studio](https://learn.microsoft.com/nuget/consume-packages/install-use-packages-visual-studio#package-sources) for instructions.

## Install .NET 8 RC2
## Install .NET 8 RTM nightly SDK

1. Add the NuGet feed for .NET 8 - https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet8/nuget/v3/index.json (https://github.com/dotnet/installer#installers-and-binaries)
2. Install the .NET 8 RC2 SDK version 8.0.100-rc.2.23472.8 or newer.
1. [Windows x64 link](https://dotnetbuilds.azureedge.net/public/Sdk/8.0.100-rc.2.23472.8/dotnet-sdk-8.0.100-rc.2.23472.8-win-x64.exe)
2. [Linux x64 link](https://dotnetbuilds.azureedge.net/public/Sdk/8.0.100-rc.2.23472.8/dotnet-sdk-8.0.100-rc.2.23472.8-linux-x64.tar.gz)
3. [OSX x64 link](https://dotnetbuilds.azureedge.net/public/Sdk/8.0.100-rc.2.23472.8/dotnet-sdk-8.0.100-rc.2.23472.8-osx-x64.tar.gz)
2. Install the .NET 8 RTM nightly SDK version 8.0.100-rtm.23512.3 or newer:
1. [Windows x64 link](https://dotnetbuilds.azureedge.net/public/Sdk/8.0.100-rtm.23512.3/dotnet-sdk-8.0.100-rtm.23512.3-win-x64.exe)
2. [Linux x64 link](https://dotnetbuilds.azureedge.net/public/Sdk/8.0.100-rtm.23512.3/dotnet-sdk-8.0.100-rtm.23512.3-linux-x64.tar.gz)
3. [OSX x64 link](https://dotnetbuilds.azureedge.net/public/Sdk/8.0.100-rtm.23512.3/dotnet-sdk-8.0.100-rtm.23512.3-osx-x64.tar.gz)

## Install the Azure Artifacts Credential Provider for NuGet

See [full setup instructions](https://github.com/microsoft/artifacts-credprovider#setup).

### Installation on Windows

#### Automatic PowerShell script

[PowerShell helper script](https://github.com/microsoft/artifacts-credprovider/blob/master/helpers/installcredprovider.ps1)

- To install netcore, run `installcredprovider.ps1`
- e.g. `iex "& { $(irm https://aka.ms/install-artifacts-credprovider.ps1) }"`
- To install both netfx and netcore, run `installcredprovider.ps1 -AddNetfx`. The netfx version is needed for nuget.exe.
- e.g. `iex "& { $(irm https://aka.ms/install-artifacts-credprovider.ps1) } -AddNetfx"`

### Installation on Linux and Mac

#### Automatic bash script

[Linux or Mac helper script](helpers/installcredprovider.sh)

Examples:
- `wget -qO- https://aka.ms/install-artifacts-credprovider.sh | bash`
- `sh -c "$(curl -fsSL https://aka.ms/install-artifacts-credprovider.sh)"`

> Note: this script only installs the netcore version of the plugin. If you need to have it working with mono msbuild, you will need to download the version with both netcore and netfx binaries following the steps in [Manual installation on Linux and Mac](#installation-on-linux-and-mac)

## Install Docker Desktop

1. https://www.docker.com/

## Install the Aspire dotnet workload

1. The RC2 SDK is aware that the Aspire workload exists, but the real manifest is not installed by default. In order to install it, you'll need to update the workload in a directory that has a NuGet.config[^3] with the right feeds configured[^2] so that it can pull the latest manifest. Once you have created the NuGet.config file in your working directory, then you need to run the following command[^1]:
1. The RTM nightly SDK is aware that the Aspire workload exists, but the real manifest is not installed by default. In order to install it, you'll need to update the workload in a directory that has a NuGet.config[^3] with the right feeds configured[^2] so that it can pull the latest manifest. Once you have created the NuGet.config file in your working directory, then you need to run the following command[^1]:

```shell
```shell
dotnet workload update --skip-sign-check --interactive
```
```

2. The above command will update the Aspire manifest in your RC2 build, meaning it will already be setup for command-line (VS support is coming soon) In-product acquisition (IPA) of the Aspire workload. In order to manually install the workload, you can run the following command[^1]:
2. The above command will update the Aspire manifest in your SDK build, meaning it will already be setup for command-line and Visual Studio in-product acquisition (IPA) of the Aspire workload. In order to manually install the workload, you can run the following command[^1]:

```shell
```shell
dotnet workload install aspire --skip-sign-check --interactive
```
```

[^1]: The `--skip-sign-check` flag is required because the packages we build out of the Aspire repo are not yet signed.
[^2]: If you want to create a separate NuGet.config instead, these are the contents you need:
Expand All @@ -43,7 +68,10 @@
<configuration>
<packageSources>
<clear />
<add key="dotnet8" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet8/nuget/v3/index.json" />
<add key="dotnet-public" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-public/nuget/v3/index.json" />
<add key="dotnet-tools-internal" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/dotnet-tools-internal/nuget/v3/index.json" />
<add key="nuget" value="https://api.nuget.org/v3/index.json" />
</packageSources>
</configuration>
```
Expand All @@ -58,7 +86,7 @@
```C#
var builder = DistributedApplication.CreateBuilder(args);

builder.AddProject<AppHost.Projects.WebApplication22>(); // USE YOUR APP NAME
builder.AddProject<Projects.WebApplication22>(); // USE YOUR APP NAME

await using var app = builder.Build();
return await app.RunAsync();
Expand Down
6 changes: 3 additions & 3 deletions global.json
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
{
"sdk": {
"version": "8.0.100-rc.2.23502.2",
"rollForward": "disable",
"version": "8.0.100-rtm.23512.3",
"rollForward": "latestPatch",
"allowPrerelease": true
},
"tools": {
"dotnet": "8.0.100-rc.2.23502.2"
"dotnet": "8.0.100-rtm.23512.3"
},
"msbuild-sdks": {
"Microsoft.DotNet.Arcade.Sdk": "8.0.0-beta.23505.1",
Expand Down
2 changes: 1 addition & 1 deletion samples/eShopLite/MyFrontend/Program.cs
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@

if (!app.Environment.IsDevelopment())
{
app.UseExceptionHandler("/error");
app.UseExceptionHandler("/error", createScopeForErrors: true);
}

app.UseStaticFiles();
Expand Down
1 change: 0 additions & 1 deletion samples/eShopLite/ServiceDefaults/Extensions.cs
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Diagnostics.HealthChecks;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Http.Resilience;
using Microsoft.Extensions.Logging;
using OpenTelemetry.Logs;
using OpenTelemetry.Metrics;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Diagnostics.HealthChecks;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Http.Resilience;
using Microsoft.Extensions.Logging;
using OpenTelemetry.Logs;
using OpenTelemetry.Metrics;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Diagnostics.HealthChecks;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Http.Resilience;
using Microsoft.Extensions.Logging;
using OpenTelemetry.Logs;
using OpenTelemetry.Metrics;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@

if (!app.Environment.IsDevelopment())
{
app.UseExceptionHandler("/Error");
app.UseExceptionHandler("/Error", createScopeForErrors: true);
}

app.UseStaticFiles();
Expand Down