|
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
using System.Buffers;
using System.Collections;
using System.IO.Pipelines;
using System.Net.Sockets;
using System.Text;
using Aspire.Dashboard.Utils;
using Aspire.Hosting;
using Aspire.Hosting.ApplicationModel;
using Aspire.Hosting.Dcp.Process;
using Aspire.Hosting.Resources;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Options;
namespace Aspire.Hosting.Dcp;
#pragma warning disable ASPIREINTERACTION001 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
internal sealed class DcpHost
{
private const int LoggingSocketConnectionBacklog = 3;
private readonly DistributedApplicationModel _applicationModel;
private readonly ILoggerFactory _loggerFactory;
private readonly ILogger _logger;
private readonly DcpOptions _dcpOptions;
private readonly IDcpDependencyCheckService _dependencyCheckService;
private readonly IInteractionService _interactionService;
private readonly Locations _locations;
private readonly TimeProvider _timeProvider;
private readonly CancellationTokenSource _shutdownCts = new();
private Task? _logProcessorTask;
// These environment variables should never be inherited by DCP from app host.
private static readonly string[] s_doNotInheritEnvironmentVars =
{
"ASPNETCORE_URLS",
"DOTNET_LAUNCH_PROFILE",
"ASPNETCORE_ENVIRONMENT",
"DOTNET_ENVIRONMENT"
};
public DcpHost(
ILoggerFactory loggerFactory,
IOptions<DcpOptions> dcpOptions,
IDcpDependencyCheckService dependencyCheckService,
IInteractionService interactionService,
Locations locations,
DistributedApplicationModel applicationModel,
TimeProvider timeProvider)
{
_loggerFactory = loggerFactory;
_logger = loggerFactory.CreateLogger<DcpHost>();
_dcpOptions = dcpOptions.Value;
_dependencyCheckService = dependencyCheckService;
_interactionService = interactionService;
_locations = locations;
_applicationModel = applicationModel;
_timeProvider = timeProvider;
}
public async Task StartAsync(CancellationToken cancellationToken)
{
await EnsureDcpContainerRuntimeAsync(cancellationToken).ConfigureAwait(false);
EnsureDcpHostRunning();
}
internal async Task EnsureDcpContainerRuntimeAsync(CancellationToken cancellationToken)
{
// Ensure DCP is installed and has all required dependencies
var dcpInfo = await _dependencyCheckService.GetDcpInfoAsync(cancellationToken: cancellationToken).ConfigureAwait(false);
if (dcpInfo is null)
{
return;
}
// If we don't have any resources that need a container then we
// don't need to check for a healthy container runtime.
if (!_applicationModel.Resources.Any(c => c.IsContainer()))
{
return;
}
AspireEventSource.Instance.ContainerRuntimeHealthCheckStart();
try
{
bool requireContainerRuntimeInitialization = _dcpOptions.ContainerRuntimeInitializationTimeout > TimeSpan.Zero;
if (requireContainerRuntimeInitialization)
{
using var timeoutCancellation = CancellationTokenSource.CreateLinkedTokenSource(cancellationToken);
timeoutCancellation.CancelAfter(_dcpOptions.ContainerRuntimeInitializationTimeout);
try
{
while (dcpInfo is not null && !IsContainerRuntimeHealthy(dcpInfo))
{
await Task.Delay(TimeSpan.FromSeconds(2), timeoutCancellation.Token).ConfigureAwait(false);
dcpInfo = await _dependencyCheckService.GetDcpInfoAsync(force: true, cancellationToken: timeoutCancellation.Token).ConfigureAwait(false);
}
}
catch (OperationCanceledException) when (timeoutCancellation.IsCancellationRequested)
{
// Swallow the cancellation exception and let it bubble up as a more helpful error
// about the container runtime in CheckDcpInfoAndLogErrors.
}
}
if (dcpInfo is not null)
{
DcpDependencyCheck.CheckDcpInfoAndLogErrors(_logger, _dcpOptions, dcpInfo, throwIfUnhealthy: requireContainerRuntimeInitialization);
// Show UI notification if container runtime is unhealthy
TryShowContainerRuntimeNotification(dcpInfo, cancellationToken);
}
}
finally
{
AspireEventSource.Instance?.ContainerRuntimeHealthCheckStop();
}
}
public async Task StopAsync()
{
_shutdownCts.Cancel();
await TaskHelpers.WaitIgnoreCancelAsync(_logProcessorTask, _logger, "Error in logging socket processor.").ConfigureAwait(false);
}
private void EnsureDcpHostRunning()
{
AspireEventSource.Instance.DcpApiServerLaunchStart();
try
{
var dcpProcessSpec = CreateDcpProcessSpec(_locations);
// Enable Unix Domain Socket based log streaming from DCP
try
{
AspireEventSource.Instance.DcpLogSocketCreateStart();
var loggingSocket = CreateLoggingSocket(_locations.DcpLogSocket);
loggingSocket.Listen(LoggingSocketConnectionBacklog);
dcpProcessSpec.EnvironmentVariables.Add("DCP_LOG_SOCKET", _locations.DcpLogSocket);
if (!string.IsNullOrWhiteSpace(_dcpOptions.LogFileNameSuffix))
{
dcpProcessSpec.EnvironmentVariables.Add("DCP_LOG_FILE_NAME_SUFFIX", _dcpOptions.LogFileNameSuffix);
}
_logProcessorTask = Task.Run(() => StartLoggingSocketAsync(loggingSocket));
}
catch (Exception ex)
{
_logger.LogError(ex, "Failed to enable orchestration logging.");
}
finally
{
AspireEventSource.Instance.DcpLogSocketCreateStop();
}
_ = ProcessUtil.Run(dcpProcessSpec);
}
finally
{
AspireEventSource.Instance.DcpApiServerLaunchStop();
}
}
private ProcessSpec CreateDcpProcessSpec(Locations locations)
{
var dcpExePath = _dcpOptions.CliPath;
if (!File.Exists(dcpExePath))
{
throw new FileNotFoundException($"The Developer Control Plane is not installed at \"{dcpExePath}\". The application cannot be run without it.", dcpExePath);
}
var arguments = $"start-apiserver --monitor {Environment.ProcessId} --detach --kubeconfig \"{locations.DcpKubeconfigPath}\"";
if (!string.IsNullOrEmpty(_dcpOptions.ContainerRuntime))
{
arguments += $" --container-runtime \"{_dcpOptions.ContainerRuntime}\"";
}
var dcpProcessSpec = new ProcessSpec(dcpExePath)
{
WorkingDirectory = Directory.GetCurrentDirectory(),
Arguments = arguments,
OnOutputData = Console.Out.Write,
OnErrorData = Console.Error.Write,
InheritEnv = false,
};
_logger.LogInformation("Starting DCP with arguments: {Arguments}", dcpProcessSpec.Arguments);
if (!string.IsNullOrEmpty(_dcpOptions.ExtensionsPath))
{
dcpProcessSpec.EnvironmentVariables.Add("DCP_EXTENSIONS_PATH", _dcpOptions.ExtensionsPath);
}
if (!string.IsNullOrEmpty(_dcpOptions.BinPath))
{
dcpProcessSpec.EnvironmentVariables.Add("DCP_BIN_PATH", _dcpOptions.BinPath);
}
// Set an environment variable to contain session info that should be deleted when DCP is done
// Currently this contains the Unix socket for logging and the kubeconfig
dcpProcessSpec.EnvironmentVariables.Add("DCP_SESSION_FOLDER", locations.DcpSessionDir);
foreach (DictionaryEntry de in Environment.GetEnvironmentVariables())
{
var key = de.Key?.ToString();
var val = de.Value?.ToString();
if (key is not null && val is not null && !s_doNotInheritEnvironmentVars.Contains(key))
{
dcpProcessSpec.EnvironmentVariables[key] = val;
}
}
return dcpProcessSpec;
}
private static Socket CreateLoggingSocket(string socketPath)
{
var directoryName = Path.GetDirectoryName(socketPath);
if (!string.IsNullOrEmpty(directoryName))
{
if (OperatingSystem.IsWindows())
{
Directory.CreateDirectory(directoryName);
}
else
{
Directory.CreateDirectory(directoryName, UnixFileMode.UserExecute | UnixFileMode.UserWrite | UnixFileMode.UserRead);
}
}
var socket = new Socket(AddressFamily.Unix, SocketType.Stream, ProtocolType.Unspecified);
socket.Bind(new UnixDomainSocketEndPoint(socketPath));
return socket;
}
private async Task StartLoggingSocketAsync(Socket socket)
{
List<Task> outputLoggers = [];
while (!_shutdownCts.IsCancellationRequested)
{
try
{
var acceptedSocket = await socket.AcceptAsync(_shutdownCts.Token).ConfigureAwait(false);
outputLoggers.Add(Task.Run(() => LogSocketOutputAsync(acceptedSocket, _shutdownCts.Token)));
}
catch
{
// Suppress exceptions reading logs from DCP controllers
}
}
await Task.WhenAll(outputLoggers).ConfigureAwait(false);
socket.Dispose();
}
private async Task LogSocketOutputAsync(Socket socket, CancellationToken cancellationToken)
{
using var stream = new NetworkStream(socket, ownsSocket: true);
using var _ = cancellationToken.Register(s => ((NetworkStream)s!).Close(), stream);
var reader = PipeReader.Create(stream);
// Logger cache to avoid creating a new string per log line, for a few categories
var loggerCache = new Dictionary<int, ILogger>();
(ILogger, LogLevel, string message) GetLogInfo(ReadOnlySpan<byte> line)
{
// The log format is
// <date>\t<level>\t<category>\t<log message>
// e.g. 2023-09-19T20:40:50.509-0700 info dcpctrl.ServiceReconciler service /apigateway is now in state Ready {"ServiceName": {"name":"apigateway"}}
var tab = line.IndexOf((byte)'\t');
var date = line[..tab];
line = line[(tab + 1)..];
tab = line.IndexOf((byte)'\t');
var level = line[..tab];
line = line[(tab + 1)..];
tab = line.IndexOf((byte)'\t');
var category = line[..tab];
line = line[(tab + 1)..];
// Trim trailing carriage return.
if (line[^1] == '\r')
{
line = line[0..^1];
}
var message = line;
var logLevel = LogLevel.Information;
if (level.SequenceEqual("info"u8))
{
logLevel = LogLevel.Information;
}
else if (level.SequenceEqual("error"u8))
{
logLevel = LogLevel.Error;
}
else if (level.SequenceEqual("warning"u8))
{
logLevel = LogLevel.Warning;
}
else if (level.SequenceEqual("debug"u8))
{
logLevel = LogLevel.Debug;
}
else if (level.SequenceEqual("trace"u8))
{
logLevel = LogLevel.Trace;
}
var hash = new HashCode();
hash.AddBytes(category);
var hashValue = hash.ToHashCode();
if (!loggerCache.TryGetValue(hashValue, out var logger))
{
// loggerFactory.CreateLogger internally caches, but we may as well cache the logger as well as the string
// for the lifetime of this socket
loggerCache[hashValue] = logger = _loggerFactory.CreateLogger($"Aspire.Hosting.Dcp.{Encoding.UTF8.GetString(category)}");
}
return (logger, logLevel, Encoding.UTF8.GetString(message));
}
try
{
void LogLines(in ReadOnlySequence<byte> buffer, out SequencePosition position)
{
var seq = new SequenceReader<byte>(buffer);
while (seq.TryReadTo(out ReadOnlySpan<byte> line, (byte)'\n'))
{
var (logger, logLevel, message) = GetLogInfo(line);
logger.Log(logLevel, 0, message, null, static (value, ex) => value);
}
position = seq.Position;
}
while (!cancellationToken.IsCancellationRequested)
{
var result = await reader.ReadAsync(CancellationToken.None).ConfigureAwait(false);
if (result.IsCompleted || result.IsCanceled)
{
break;
}
LogLines(result.Buffer, out var position);
reader.AdvanceTo(position, result.Buffer.End);
}
}
catch
{
// Suppress exceptions reading logs from DCP controllers
}
finally
{
reader.Complete();
}
}
private void TryShowContainerRuntimeNotification(DcpInfo dcpInfo, CancellationToken cancellationToken)
{
// Check if the interaction service is available (dashboard enabled)
if (!_interactionService.IsAvailable)
{
return;
}
var containerRuntime = _dcpOptions.ContainerRuntime;
if (string.IsNullOrEmpty(containerRuntime))
{
// Default runtime is Docker
containerRuntime = "docker";
}
var installed = dcpInfo.Containers?.Installed ?? false;
var running = dcpInfo.Containers?.Running ?? false;
// Early check: if container runtime is not installed, show notification and return immediately (no polling)
if (!installed)
{
string title = InteractionStrings.ContainerRuntimeNotInstalledTitle;
string message = InteractionStrings.ContainerRuntimeNotInstalledMessage;
var options = new NotificationInteractionOptions
{
Intent = MessageIntent.Error,
LinkText = InteractionStrings.ContainerRuntimeLinkText,
LinkUrl = "https://aka.ms/dotnet/aspire/containers"
};
// Show notification without polling (non-auto-dismiss)
_ = _interactionService.PromptNotificationAsync(title, message, options, cancellationToken);
return;
}
// Only show notification if container runtime is installed but not running
// If not installed, that's usually a more fundamental setup issue that would be addressed differently
if (installed && !running)
{
string title = InteractionStrings.ContainerRuntimeUnhealthyTitle;
var (message, linkUrl) = DcpDependencyCheck.BuildContainerRuntimeUnhealthyMessage(containerRuntime);
var options = new NotificationInteractionOptions
{
Intent = MessageIntent.Error,
LinkText = linkUrl is not null ? InteractionStrings.ContainerRuntimeLinkText : null,
LinkUrl = linkUrl
};
// Create a cancellation token source that can be cancelled when runtime becomes healthy
var notificationCts = CancellationTokenSource.CreateLinkedTokenSource(cancellationToken, _shutdownCts.Token);
// Single background task to show notification and poll for health updates
_ = Task.Run(async () =>
{
try
{
// First, show the notification
var notificationTask = _interactionService.PromptNotificationAsync(title, message, options, notificationCts.Token);
// Then poll for container runtime health updates every 5 seconds
using var timer = new PeriodicTimer(TimeSpan.FromSeconds(5), _timeProvider);
while (await timer.WaitForNextTickAsync(notificationCts.Token).ConfigureAwait(false))
{
try
{
var dcpInfo = await _dependencyCheckService.GetDcpInfoAsync(force: true, cancellationToken: notificationCts.Token).ConfigureAwait(false);
if (dcpInfo is not null && IsContainerRuntimeHealthy(dcpInfo))
{
// Container runtime is now healthy, exit the polling loop
break;
}
}
catch (OperationCanceledException)
{
// Expected when cancellation is requested
break;
}
catch (Exception ex)
{
// Log but continue polling
_logger.LogDebug(ex, "Error while polling container runtime health for notification");
}
}
// Cancel the notification at the end of the loop
notificationCts.Cancel();
// Wait for notification task to complete
try
{
await notificationTask.ConfigureAwait(false);
}
catch (OperationCanceledException)
{
// Expected when notification is cancelled
}
}
catch (OperationCanceledException)
{
// Expected when cancellation is requested
}
catch (Exception ex)
{
// Log but don't propagate notification errors
_logger.LogDebug(ex, "Failed to show container runtime notification or poll for health");
}
finally
{
notificationCts.Dispose();
}
}, cancellationToken);
}
}
private static bool IsContainerRuntimeHealthy(DcpInfo dcpInfo)
{
var installed = dcpInfo.Containers?.Installed ?? false;
var running = dcpInfo.Containers?.Running ?? false;
return installed && running;
}
}
#pragma warning restore ASPIREINTERACTION001 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
|