Skip to content

Fix stop --all to return success when no app hosts are running#17463

Merged
davidfowl merged 1 commit into
mainfrom
fix/stop-all-exit-code-consistency
May 25, 2026
Merged

Fix stop --all to return success when no app hosts are running#17463
davidfowl merged 1 commit into
mainfrom
fix/stop-all-exit-code-consistency

Conversation

@JamesNK
Copy link
Copy Markdown
Member

@JamesNK JamesNK commented May 25, 2026

Description

Make aspire stop --all return exit code 0 (Success) with an informational message when no app hosts are running, consistent with the interactive aspire stop behavior.

Previously, --all returned exit code 7 (FailedToFindProject) and displayed an error, while the interactive path returned Success with an info message. This inconsistency made scripting scenarios fail unnecessarily.

Changes

  • src/Aspire.Cli/Commands/StopCommand.cs: Changed StopAllAppHostsAsync to use DisplayMessage with KnownEmojis.Information and return CliExitCodes.Success when no connections are found (instead of DisplayError + FailedToFindProject).
  • tests/Aspire.Cli.Tests/Commands/StopCommandTests.cs: Added a parameterized [Theory] test covering both the interactive stop and stop --all paths to verify they return success with the expected informational message.

Checklist

  • Is this feature complete?
    • Yes. Ready to ship.
    • No. Follow-up changes expected.
  • Are you including unit tests for the changes and scenario tests if relevant?
    • Yes
    • No
  • Did you add public API?
    • Yes
    • No
  • Does the change make any security assumptions or guarantees?
    • Yes
    • No

Copilot AI review requested due to automatic review settings May 25, 2026 06:42
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 25, 2026

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/microsoft/aspire/main/eng/scripts/get-aspire-cli-pr.sh | bash -s -- 17463

Or

  • Run remotely in PowerShell:
iex "& { $(irm https://raw.githubusercontent.com/microsoft/aspire/main/eng/scripts/get-aspire-cli-pr.ps1) } 17463"

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request updates the Aspire CLI stop command so that aspire stop --all returns exit code 0 (Success) with an informational message when there are no running AppHosts, aligning it with the interactive aspire stop behavior and making scripting scenarios more predictable.

Changes:

  • Adjusted stop --all to display an informational “not running” message and return CliExitCodes.Success when no AppHosts are found.
  • Added a parameterized test covering both stop and stop --all for the “no running AppHosts” scenario.
  • Also removes the “Logs” column from aspire ps table output (plus associated resources/tests), which appears unrelated to the PR’s stated goal.

Reviewed changes

Copilot reviewed 18 out of 19 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
src/Aspire.Cli/Commands/StopCommand.cs Changes stop --all empty-scan behavior to informational + success exit code.
tests/Aspire.Cli.Tests/Commands/StopCommandTests.cs Adds test for success + message when no AppHosts are running.
src/Aspire.Cli/Commands/PsCommand.cs Removes CLI log column from table output rendering.
tests/Aspire.Cli.Tests/Commands/PsCommandTests.cs Removes table-format tests related to the removed “Logs” column.
src/Aspire.Cli/Resources/PsCommandStrings.resx Removes HeaderCliLog resource string.
src/Aspire.Cli/Resources/PsCommandStrings.Designer.cs Removes generated accessor for HeaderCliLog.
src/Aspire.Cli/Resources/xlf/PsCommandStrings.cs.xlf Removes HeaderCliLog localized entry.
src/Aspire.Cli/Resources/xlf/PsCommandStrings.de.xlf Removes HeaderCliLog localized entry.
src/Aspire.Cli/Resources/xlf/PsCommandStrings.es.xlf Removes HeaderCliLog localized entry.
src/Aspire.Cli/Resources/xlf/PsCommandStrings.fr.xlf Removes HeaderCliLog localized entry.
src/Aspire.Cli/Resources/xlf/PsCommandStrings.it.xlf Removes HeaderCliLog localized entry.
src/Aspire.Cli/Resources/xlf/PsCommandStrings.ja.xlf Removes HeaderCliLog localized entry.
src/Aspire.Cli/Resources/xlf/PsCommandStrings.ko.xlf Removes HeaderCliLog localized entry.
src/Aspire.Cli/Resources/xlf/PsCommandStrings.pl.xlf Removes HeaderCliLog localized entry.
src/Aspire.Cli/Resources/xlf/PsCommandStrings.pt-BR.xlf Removes HeaderCliLog localized entry.
src/Aspire.Cli/Resources/xlf/PsCommandStrings.ru.xlf Removes HeaderCliLog localized entry.
src/Aspire.Cli/Resources/xlf/PsCommandStrings.tr.xlf Removes HeaderCliLog localized entry.
src/Aspire.Cli/Resources/xlf/PsCommandStrings.zh-Hans.xlf Removes HeaderCliLog localized entry.
src/Aspire.Cli/Resources/xlf/PsCommandStrings.zh-Hant.xlf Removes HeaderCliLog localized entry.
Files not reviewed (1)
  • src/Aspire.Cli/Resources/PsCommandStrings.Designer.cs: Language not supported

Comment thread src/Aspire.Cli/Commands/PsCommand.cs
Make 'aspire stop --all' return exit code 0 (Success) with an
informational message when no app hosts are running, consistent with
the interactive 'aspire stop' behavior.

Previously, --all returned exit code 7 (FailedToFindProject) and
displayed an error, while the interactive path returned Success with
an info message. This inconsistency made scripting scenarios fail
unnecessarily.

Also adds a parameterized test covering both the interactive and
--all paths.
@JamesNK JamesNK force-pushed the fix/stop-all-exit-code-consistency branch from 6955f62 to a131586 Compare May 25, 2026 06:54
@github-actions
Copy link
Copy Markdown
Contributor

CLI E2E Tests unknown — 96 passed, 0 failed, 5 unknown (commit a131586)

View all recordings
Status Test Recording
AddPackageInteractiveWhileAppHostRunningDetached ▶️ View recording
AddPackageWhileAppHostRunningDetached ▶️ View recording
AgentCommands_AllHelpOutputs_AreCorrect ▶️ View recording
AgentInitCommand_DefaultSelection_InstallsDefaultSkills ▶️ View recording
AgentInitCommand_MigratesDeprecatedConfig ▶️ View recording
AgentMcpListStructuredLogsFromStarterAppCore ▶️ View recording
AllPublishMethodsBuildDockerImages ▶️ View recording
AspireAddPackageVersionToDirectoryPackagesProps ▶️ View recording
AspireInitSingleFileAppHostRunsViaDotnetRunAppHost ▶️ View recording
AspireInitWithExistingAppHostDirRecreatesMissingNuGetConfigAndPreservesFiles ▶️ View recording
AspireInitWithSolutionFileGeneratesAppHostThatBuildsAgainstChannelHive ▶️ View recording
AspireStartUpdatesStaleTypeScriptAppHostPath ▶️ View recording
AspireUpdateRemovesAppHostPackageVersionFromDirectoryPackagesProps ▶️ View recording
AspireUpdateRemovesOrphanAppHostPackageVersionWhenSdkAlreadyCurrent ▶️ View recording
Banner_DisplayedOnFirstRun ▶️ View recording
Banner_DisplayedWithExplicitFlag ▶️ View recording
Banner_NotDisplayedWithNoLogoFlag ▶️ View recording
CertificatesClean_RemovesCertificates ▶️ View recording
CertificatesTrust_WithNoCert_CreatesAndTrustsCertificate ▶️ View recording
CertificatesTrust_WithUntrustedCert_TrustsCertificate ▶️ View recording
ConfigSetGet_CreatesNestedJsonFormat ▶️ View recording
CreateAndRunAspireStarterProject ▶️ View recording
CreateAndRunAspireStarterProjectWithBundle ▶️ View recording
CreateAndRunEmptyAppHostProject ▶️ View recording
CreateAndRunJavaEmptyAppHostProject ▶️ View recording
CreateAndRunJsReactProject ▶️ View recording
CreateAndRunPythonReactProject ▶️ View recording
CreateAndRunTypeScriptEmptyAppHostProject ▶️ View recording
CreateAndRunTypeScriptStarterProject ▶️ View recording
CreateJavaAppHostWithViteApp ▶️ View recording
CreateTypeScriptAppHostWithViteApp_UsesConfiguredToolchain ▶️ View recording
DashboardRunWithAgentMcpCore ▶️ View recording
DashboardRunWithOtelTracesReturnsNoTracesCore ▶️ View recording
DeployK8sBasicApiService ▶️ View recording
DeployK8sWithExternalHelmChart ▶️ View recording
DeployK8sWithGarnet ▶️ View recording
DeployK8sWithMongoDB ▶️ View recording
DeployK8sWithMySql ▶️ View recording
DeployK8sWithPostgres ▶️ View recording
DeployK8sWithRabbitMQ ▶️ View recording
DeployK8sWithRedis ▶️ View recording
DeployK8sWithSqlServer ▶️ View recording
DeployK8sWithValkey ▶️ View recording
DeployTypeScriptAppToKubernetes ▶️ View recording
DescribeCommandResolvesReplicaNames ▶️ View recording
DescribeCommandShowsRunningResources ▶️ View recording
DetachFormatJsonProducesValidJson ▶️ View recording
DetachFormatJsonProducesValidJsonWhenRestartingExistingInstance ▶️ View recording
DoListStepsShowsPipelineSteps ▶️ View recording
DocsCommand_RendersInteractiveMarkdownFromLocalSource ▶️ View recording
DoctorCommand_DetectsDeprecatedAgentConfig ▶️ View recording
DoctorCommand_TypeScriptAppHostReportsMissingConfiguredToolchain ▶️ View recording
DoctorCommand_WithSslCertDir_ShowsTrusted ▶️ View recording
DoctorCommand_WithoutSslCertDir_ShowsPartiallyTrusted ▶️ View recording
GeneratedAspireDevScript_StartsWatchMode_WithConfiguredToolchain ▶️ View recording
GlobalMigration_HandlesCommentsAndTrailingCommas ▶️ View recording
GlobalMigration_HandlesMalformedLegacyJson ▶️ View recording
GlobalMigration_PreservesAllValueTypes ▶️ View recording
GlobalMigration_SkipsWhenNewConfigExists ▶️ View recording
GlobalSettings_MigratedFromLegacyFormat ▶️ View recording
InitTypeScriptAppHost_AugmentsExistingViteRepoAtRoot ▶️ View recording
InteractiveCSharpInitCreatesExpectedFiles ▶️ View recording
InvalidAppHostPathWithComments_IsHealedOnRun ▶️ View recording
JavaScriptHostingApisRunFromTypeScriptAppHost ▶️ View recording
LatestCliCanStartStableChannelAppHost ▶️ View recording
LatestCliCanStartStableChannelTypeScriptAppHost ▶️ View recording
LegacySettingsMigration_AdjustsRelativeAppHostPath ▶️ View recording
LogLevelTrace_ProducesTraceEntriesInCliLogFile ▶️ View recording
LogsCommandShowsResourceLogs ▶️ View recording
OtelLogsReturnsStructuredLogsFromStarterApp ▶️ View recording
OtelLogsReturnsStructuredLogsFromStarterAppIsolated ▶️ View recording
PsCommandListsRunningAppHost ▶️ View recording
PsFormatJsonOutputsOnlyJsonToStdout ▶️ View recording
PublishJavaScriptPatternsGeneratesExpectedDockerComposeArtifacts ▶️ View recording
PublishWithConfigureEnvFileUpdatesEnvOutput ▶️ View recording
PublishWithDockerComposeServiceCallbackSucceeds ▶️ View recording
PublishWithoutOutputPathUsesAppHostDirectoryDefault ▶️ View recording
ResourceCommand_FailedExecution_DisplaysAppHostLogPathAndLogContainsEntries ▶️ View recording
ResourceCommand_FailsWhenInteractionServiceIsRequired ▶️ View recording
ResourceCommand_SetAndDeleteParameterUpdatesDescribeOutput ▶️ View recording
RestoreGeneratesSdkFiles ▶️ View recording
RestoreGeneratesSdkFiles_WithConfiguredToolchain ▶️ View recording
RestoreRefreshesGeneratedSdkAfterAddingIntegration ▶️ View recording
RestoreSupportsConfigOnlyHelperPackageAndCrossPackageTypes ▶️ View recording
RunFromParentDirectory_UsesExistingConfigNearAppHost ▶️ View recording
RunPublishFailureScenarioAsync ▶️ View recording
RunReportsSyntaxErrorsForDotNetAppHost ▶️ View recording
RunReportsSyntaxErrorsForTypeScriptAppHost ▶️ View recording
SecretCrudOnDotNetAppHost ▶️ View recording
SecretCrudOnTypeScriptAppHost ▶️ View recording
StagingChannel_ConfigureAndVerifySettings_ThenSwitchChannels ▶️ View recording
StartAndWaitForTypeScriptSqlServerAppHostWithNativeAssets ▶️ View recording
StartReportsSyntaxErrorsForDotNetAppHost ▶️ View recording
StartReportsSyntaxErrorsForTypeScriptAppHost ▶️ View recording
StopAllAppHostsFromAppHostDirectory ▶️ View recording
StopJavaPolyglotAppHostUsingApphostDirectory ▶️ View recording
StopNonInteractiveSingleAppHost ▶️ View recording
StopTypeScriptPolyglotAppHostUsingApphostDirectory ▶️ View recording
StopWithNoRunningAppHostExitsSuccessfully ▶️ View recording
UnAwaitedChainsCompileWithAutoResolvePromises ▶️ View recording
UpdateProjectChannelToStable_TypeScript_PicksUpStablePackages ▶️ View recording

📹 Recordings uploaded automatically from CI run #26387671296

@davidfowl davidfowl merged commit e8d5767 into main May 25, 2026
311 checks passed
@microsoft-github-policy-service microsoft-github-policy-service Bot added this to the 13.4 milestone May 25, 2026
@aspire-repo-bot
Copy link
Copy Markdown
Contributor

✅ No documentation update needed.

A documentation update was prepared for microsoft/aspire.dev on branch release/13.4 but could not be submitted as a draft PR due to a workspace configuration issue (the primary $GITHUB_WORKSPACE contains microsoft/aspire rather than microsoft/aspire.dev, so create_pull_request could not detect the committed changes).

Triggered signals: cli_command_file_changed (src/Aspire.Cli/Commands/StopCommand.cs), pr_body_has_cli_flag_mention (--all).

Prepared change: Updated the --all option description in src/frontend/src/content/docs/reference/cli/commands/aspire-stop.mdx to document that when no AppHosts are running, aspire stop --all exits with code 0 (success) and an informational message rather than returning exit code 7 (error), making it safe for automation scripts.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants