Aspire och GitHub Codespaces

2025-10-02

GitHub Codespaces erbjuder en molnbaserad utvecklingsmiljö baserad på Visual Studio Code. Den kan nås direkt från en webbläsare eller via Visual Studio Code lokalt, där Visual Studio Code fungerar som en klient som ansluter till en molnbaserad serverdel. Med Aspire 9.1 kommer logik för att bättre stödja GitHub Codespaces, inklusive:

Konfigurera portvidarebefordring automatiskt med rätt protokoll.
Översätt url:er automatiskt på Aspire instrumentpanelen.

Före Aspire 9.1 var det fortfarande möjligt att använda Aspire i ett GitHub codespace, men mer manuell konfiguration krävdes.

GitHub Codespaces jämfört med Dev Containers

GitHub Codespaces bygger på Visual Studio Code och Dev Containers-specifikationen. Förutom stöd för GitHub Codespaces förbättrar Aspire 9.1 stödet för att använda Visual Studio Code och lokalt värdbaserade Dev Containers. Även om upplevelserna är liknande finns det vissa skillnader. Mer information finns i Aspire och Visual Studio Code Dev Containers.

Snabbstart med malllagringsplats

Om du vill konfigurera GitHub Codespaces för Aspireanvänder du filen .devcontainer/devcontainer.json på lagringsplatsen. Det enklaste sättet att komma igång är genom att skapa en ny lagringsplats från vår malllagringsplats. Överväg följande steg:

Skapa en ny lagringsplats med hjälp av vår mall.

När du har angett informationen och valt Skapa lagringsplats skapas lagringsplatsen och visas i GitHub.
Från den nya lagringsplatsen väljer du på knappen Kod och väljer fliken Codespaces och sedan Skapa kodområde på huvudplatsen.

När du har valt Skapa kodområde på main navigerar du till en webbaserad version av Visual Studio Code. Innan du använder Codespace måste den containerbaserade utvecklingsmiljön förberedas. Den här processen sker automatiskt på servern och du kan granska förloppet genom att välja länken Skapa kodområde i meddelandet längst ned till höger i webbläsarfönstret.

När containeravbildningen har skapats visas terminalprompten som signalerar att miljön är redo att interagera med.

Aspire Nu har mallarna installerats och ASP.NET Core utvecklarcertifikatet har lagts till och godkänts.
Skapa ett nytt Aspire projekt med hjälp av startmallen.
```
dotnet new aspire-starter --name HelloAspire
```
Detta resulterar i att många filer och mappar skapas på lagringsplatsen, som visas i Explorer-panelen till vänster i fönstret.
Starta AppHost via filen HelloAspire.AppHost/AppHost.cs genom att välja knappen Kör projekt i det övre högra hörnet i flikfältet.

Efter en stund visas panelen Felsökningskonsol och innehåller en länk till instrumentpanelen Aspire som exponeras på en GitHub Codespaces-slutpunkt med autentiseringstoken.
Aspire Öppna instrumentpanelen genom att välja instrumentpanelens URL i felsökningskonsolen. Då öppnas Aspire instrumentpanelen på en separat flik i webbläsaren.

På instrumentpanelen ser du att alla HTTP/HTTPS-slutpunkter som definierats för resurser har fått sin typiska localhost adress översatt till en unik fullständigt kvalificerad underdomän på domänen app.github.dev .

Trafik till var och en av dessa slutpunkter vidarebefordras automatiskt till den underliggande processen eller containern som körs i Codespace. Detta inkluderar utvecklingstidsverktyg som PgAdmin och Redis Insight.

Anmärkning

Förutom den autentiseringstoken som är inbäddad i URL:en för instrumentpanelslänken i felsökningskonsolen kräver slutpunkter också autentisering via din GitHub identitet för att undvika att portvidarebefordrade slutpunkter blir tillgängliga för alla. Mer information om portvidarebefordring i GitHub Codespaces finns i Vidarebefordra portar i ditt kodområde.
Checka in ändringar i lagringsplatsen GitHub .

GitHub Codespaces checkar inte automatiskt in dina ändringar i den gren som du arbetar med i GitHub. Du måste använda panelen Källkontroll för att mellanlagra och checka in ändringarna och skicka tillbaka dem till lagringsplatsen.

Att arbeta i ett GitHub codespace liknar att arbeta med Visual Studio Code på din egen dator. Du kan checka ut olika grenar och push-överföra ändringar precis som normalt. Dessutom kan du enkelt starta flera Codespaces samtidigt om du snabbt vill arbeta med en annan gren utan att störa din befintliga felsökningssession. Mer information finns i Utveckla i ett kodområde.
Rensa kodområdet.

GitHub Kodutrymmen är tillfälliga utvecklingsmiljöer och även om du kan använda en under en längre tid bör de betraktas som en disponibel resurs som du återskapar efter behov (med alla anpassningar/installationer som finns i devcontainer.json och associerade konfigurationsfiler).

Om du vill ta bort kodområdet GitHub går du till GitHub sidan Codespaces. Här visas en lista över alla dina codespaces. Härifrån kan du utföra hanteringsåtgärder på varje Kodområde, inklusive att ta bort dem.

GitHub avgifter för användning av Codespaces. Mer information finns i Hantera kostnaden för GitHub codespaces i din organisation.

Anmärkning

Aspire stöder användning av Dev Containers i Visual Studio Code oberoende av GitHub Codespaces. Mer information om hur du använder Dev Containers lokalt Aspire finns i och Dev Containers i Visual Studio Code.

Konfigurera devcontainer.json manuellt

Föregående genomgång visar den effektiva processen att skapa ett GitHub codespace med hjälp av Aspire Devcontainer-mallen. Om du redan har en befintlig lagringsplats och vill använda Devcontainer-funktioner med Aspirelägger du till en devcontainer.json fil i mappen .devcontainer på lagringsplatsen:

└───📂 .devcontainer
     └─── devcontainer.json

Mallförvaret innehåller en kopia av devcontainer.json-filen som du kan använda som utgångspunkt, vilket bör vara tillräckligt för Aspire. Följande JSON representerar den senaste versionen av .devcontainer/devcontainer.json-filen från mallen:

// For format details, see https://aka.ms/devcontainer.json. For config options, see the
// README at: https://github.com/devcontainers/templates/tree/main/src/dotnet
{
    "name": ".NET Aspire",
    // Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
    "image": "mcr.microsoft.com/devcontainers/dotnet:9.0-bookworm",
    "features": {
        "ghcr.io/devcontainers/features/docker-in-docker:2": {},
        "ghcr.io/devcontainers/features/powershell:1": {},
    },

    "hostRequirements": {
        "cpus": 8,
        "memory": "32gb",
        "storage": "64gb"
    },

    // Use 'forwardPorts' to make a list of ports inside the container available locally.
    // "forwardPorts": [5000, 5001],
    // "portsAttributes": {
    //		"5001": {
    //			"protocol": "https"
    //		}
    // }

    // Use 'postCreateCommand' to run commands after the container is created.
    // "postCreateCommand": "dotnet restore",
    "onCreateCommand": "curl -sSL https://aspire.dev/install.sh | bash",
    "postStartCommand": "dotnet dev-certs https --trust",
    "customizations": {
        "vscode": {
            "extensions": [
                "ms-dotnettools.csdevkit",
                "GitHub.copilot-chat",
                "GitHub.copilot"
            ]
        }
    }
    // Configure tool-specific properties.
    // "customizations": {},

    // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
    // "remoteUser": "root"
}

Påskynda skapandet av Codespace

Det kan ta lite tid att skapa ett GitHub Codespace när den förbereder den underliggande containeravbildningen. För att påskynda den här processen kan du använda fördefinierade objekt för att avsevärt minska skapandetiden till cirka 30–60 sekunder (den exakta tidpunkten kan variera). Mer information om GitHub fördefinierade codespaces finns GitHub i Fördefinierade codespaces.

Feedback

Var den här sidan till hjälp?