ContainerImagePushOptions Methods
Class Methods 1 member
Represents options for pushing container images to a registry.
GetFullRemoteImageNameAsync(IContainerRegistry, CancellationToken) Section titled GetFullRemoteImageNameAsync(IContainerRegistry, CancellationToken) Task<string> Gets the full remote image name including registry endpoint and tag.
public sealed class ContainerImagePushOptions{ public Task<string> GetFullRemoteImageNameAsync( IContainerRegistry registry, CancellationToken cancellationToken = default(CancellationToken)) { // ... }}Parameters
registry IContainerRegistry The container registry to use for constructing the full image name. cancellationToken CancellationToken optional The cancellation token. Returns
Task<string> The fully qualified image name in the format "{registryEndpoint}/{repository}/{imageName}:{tag}" or "{registryEndpoint}/{imageName}:{tag}" if no repository is specified. For example: "myregistry.azurecr.io/myapp:v1.0.0" or "docker.io/captainsafia/myapp:latest". Exceptions
InvalidOperationException Thrown when ContainerImagePushOptions.RemoteImageName is null or empty. ArgumentNullException Thrown when registry is null. Remarks
This method retrieves the registry endpoint asynchronously and combines it with the remote image name and tag. If ContainerImagePushOptions.RemoteImageTag is null or empty, "latest" is used as the default tag.
The ContainerImagePushOptions.RemoteImageName value is parsed to determine if it contains an override for the registry host or repository. If the ContainerImagePushOptions.RemoteImageName contains a host component (detected by the presence of a dot in the first segment), that host will be used instead of the registry endpoint. Otherwise, the registry endpoint is used and the IContainerRegistry.Repository (if set) is prepended to the image name.