Aspire a GitHub Codespaces

GitHub Codespaces nabízí vývojové prostředí hostované v cloudu založené na Visual Studio Code. Je přístupný přímo z webového prohlížeče nebo prostřednictvím Visual Studio Code místního prostředí, kde funguje jako klient, který Visual Studio Code se připojuje k back-endu hostovaného v cloudu. S Aspire 9.1 přichází logika pro lepší podporu GitHub Codespaces, včetně:

Automaticky nakonfigurujte přesměrování portů se správným protokolem.
Automaticky překládat adresy URL na řídicím panelu Aspire

Před Aspire 9.1 bylo stále možné použít Aspire v codespace GitHub , ale bylo vyžadováno více ruční konfigurace.

GitHub Codespaces vs. Dev Containers

GitHub Codespaces vychází ze Visual Studio Codespecifikace Dev Containers. Kromě podpory GitHub Codespaces Aspire vylepšuje verze 9.1 podporu pro používání Visual Studio Code a místně hostované dev Containers. I když jsou prostředí podobné, existují určité rozdíly. Další informace najdete v tématu Aspire a Visual Studio Code dev Containers.

Rychlý start s využitím úložiště šablon

Ke konfiguraci GitHub Codespaces použijte Aspiresoubor .devcontainer/devcontainer.json ve vašem úložišti. Nejjednodušší způsob, jak začít, je vytvoření nového úložiště z našeho úložiště šablony. Zvažte následující kroky:

Vytvořte nové úložiště pomocí naší šablony.

Jakmile zadáte podrobnosti a vyberete Vytvořit úložiště, vytvoří se úložiště a zobrazí se v GitHubsouboru .
V novém úložišti vyberte na tlačítku Kód a vyberte kartu Codespaces a pak vyberte Create codespace on main.

Po výběru možnosti Create codespace on main přejdete na webovou verzi Visual Studio Code. Před použitím Codespace je potřeba připravit kontejnerizované vývojové prostředí. K tomuto procesu dochází automaticky na serveru a průběh můžete zkontrolovat výběrem odkazu Building codespace v oznámení v pravém dolním rohu okna prohlížeče.

Po dokončení vytváření image kontejneru se zobrazí výzva terminálu , která signalizuje, že prostředí je připravené k interakci.

V tomto okamžiku Aspire byly šablony nainstalovány a ASP.NET Core certifikát vývojáře byl přidán a přijat.
Vytvořte nový Aspire projekt pomocí úvodní šablony.
```
dotnet new aspire-starter --name HelloAspire
```
Výsledkem je vytvoření mnoha souborů a složek v úložišti, které jsou viditelné na panelu Průzkumník na levé straně okna.
Spusťte AppHost prostřednictvím souboru HelloAspire.AppHost/AppHost.cs výběrem tlačítka Spustit projekt v pravém horním rohu panelu karet.

Po chvíli se zobrazí panel konzoly ladění a obsahuje odkaz na Aspire řídicí panel vystavený na koncovém GitHub bodu Codespaces s ověřovacím tokenem.
Aspire Otevřete řídicí panel výběrem adresy URL řídicího panelu v konzole ladění. Tím se Aspire řídicí panel otevře v nové kartě prohlížeče.

Na řídicím panelu si všimnete, že všechny koncové body HTTP/HTTPS definované na prostředcích mají svoji typickou localhost adresu přeloženou na jedinečnou plně kvalifikovanou subdoménu v app.github.dev doméně.

Provoz do každého z těchto koncových bodů se automaticky předává do souvisejícího procesu nebo kontejneru spuštěného v rámci Codespace. To zahrnuje nástroje pro vývoj, jako je PgAdmin a Redis Insight.

Poznámka:

Kromě ověřovacího tokenu vloženého do adresy URL odkazu řídicího panelu konzoly ladění vyžadují koncové body také ověření prostřednictvím vaší GitHub identity, aby se zabránilo přístupnosti přesměrovaných koncových bodů portů všem. Další informace o přesměrování portů v GitHub Codespaces najdete v tématu Přesměrování portů v codespace.
Potvrďte změny v úložišti GitHub .

GitHub Codespaces automaticky nespíše vaše změny do větve, na GitHubkteré pracujete. K rozfázování a potvrzení změn musíte použít panel Správa zdrojového kódu a odeslat je zpět do úložiště.

Práce v GitHub Codespace je podobná práci s Visual Studio Code vlastním počítačem. Můžete rezervovat různé větve a nasdílit změny stejně jako obvykle. Kromě toho můžete snadno spustit více codespaces současně, pokud chcete rychle pracovat na jiné větvi bez přerušení existující ladicí relace. Další informace naleznete v tématu Vývoj v codespace.
Vyčistěte codespace.

GitHub Codespaces jsou dočasná vývojová prostředí a i když je můžete používat po delší dobu, měli byste je považovat za jednorázový prostředek, který podle potřeby znovu vytvoříte (se všemi přizpůsobeními a nastavením obsaženými v devcontainer.json a přidružených konfiguračních souborech).

Pokud chcete odstranit GitHub Codespace, navštivte GitHub stránku Codespaces. Zobrazí se seznam všech vašich prostorů Codespaces. Odsud můžete provádět operace správy pro každý Codespace, včetně jejich odstranění.

GitHub poplatky za použití Codespaces. Další informace najdete v tématu Správa nákladů na GitHub Codespaces ve vaší organizaci.

Poznámka:

Aspire podporuje použití Dev Containers nezávisle Visual Studio Code na GitHub Codespaces. Další informace o tom, jak používat Dev Containers místně, najdete v tématuAspire a Dev Containers v Visual Studio Code.

Ruční konfigurace devcontainer.json

Předchozí názorný postup ukazuje zjednodušený proces vytvoření GitHub Codespace pomocí Aspire šablony Devcontainer. Pokud už máte existující úložiště a chcete využívat funkce Devcontainer s Aspire, přidejte do složky .devcontainer v úložišti soubordevcontainer.json:

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

Úložiště šablony obsahuje kopii souborudevcontainer.json , který můžete použít jako výchozí bod, který by měl být dostatečný pro Aspire. Následující JSON příklad představuje nejnovější verzi souboru .devcontainer/devcontainer.json ze šablony:

// 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": "Aspire",
    // Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
    "image": "mcr.microsoft.com/devcontainers/dotnet:dev-10.0-noble",
    "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"
}

Zrychlení vytváření Codespace

GitHub Vytvoření codespace může nějakou dobu trvat, než připraví základní image kontejneru. Pokud chcete tento proces urychlit, můžete využít předbuildy , abyste výrazně zkrátili dobu vytváření na přibližně 30 až 60 sekund (přesné načasování se může lišit). Další informace o GitHub prebuilds Codespaces naleznete v tématu GitHub Codespaces prebuilds.

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-10-02