Stack.Docker

Run commands in Docker containers

Documentation

cleanup :: HasConfig env => CleanupOpts -> RIO env ()

Clean-up old docker images and containers.

data CleanupOpts

Options for cleanup.

Constructors

CleanupOpts

Fields

• dcAction :: !CleanupAction
• dcRemoveKnownImagesLastUsedDaysAgo :: !(Maybe Integer)
• dcRemoveUnknownImagesCreatedDaysAgo :: !(Maybe Integer)
• dcRemoveDanglingImagesCreatedDaysAgo :: !(Maybe Integer)
• dcRemoveStoppedContainersCreatedDaysAgo :: !(Maybe Integer)
• dcRemoveRunningContainersCreatedDaysAgo :: !(Maybe Integer)

Instances

Show CleanupOpts

Methods

showsPrec :: Int -> CleanupOpts -> ShowS

show :: CleanupOpts -> String

showList :: [CleanupOpts] -> ShowS

data CleanupAction

Cleanup action.

Constructors

CleanupInteractive

CleanupImmediate

CleanupDryRun

Instances

Show CleanupAction

Methods

showsPrec :: Int -> CleanupAction -> ShowS

show :: CleanupAction -> String

showList :: [CleanupAction] -> ShowS

dockerCleanupCmdName :: String

Command-line argument for docker cleanup.

dockerCmdName :: String

Command-line argument for "docker"

dockerHelpOptName :: String

dockerPullCmdName :: String

Command-line argument for docker pull.

entrypoint :: (MonadUnliftIO m, MonadLogger m, MonadThrow m) => Config -> DockerEntrypoint -> m ()

The Docker container "entrypoint": special actions performed when first entering a container, such as switching the UID/GID to the "outside-Docker" user's.

preventInContainer :: MonadIO m => m () -> m ()

Error if running in a container.

pull :: HasConfig env => RIO env ()

Pull latest version of configured Docker image from registry.

reexecWithOptionalContainer :: HasConfig env => Maybe (Path Abs Dir) -> Maybe (RIO env ()) -> IO () -> Maybe (RIO env ()) -> Maybe (RIO env ()) -> RIO env ()

If Docker is enabled, re-runs the currently running OS command in a Docker container. Otherwise, runs the inner action.

This takes an optional release action which should be taken IFF control is transferring away from the current process to the intra-container one. The main use for this is releasing a lock. After launching reexecution, the host process becomes nothing but an manager for the call into docker and thus may not hold the lock.

reset :: (MonadIO m, MonadReader env m, HasConfig env) => Maybe (Path Abs Dir) -> Bool -> m ()

Remove the project's Docker sandbox.

reExecArgName :: String

Command-line option for --internal-re-exec-version.

data StackDockerException

Exceptions thrown by Stack.Docker.

Constructors

DockerMustBeEnabledException

Docker must be enabled to use the command.

OnlyOnHostException

Command must be run on host OS (not in a container).

InspectFailedException String

docker inspect failed.

NotPulledException String

Image does not exist.

InvalidCleanupCommandException String

Input to docker cleanup has invalid command.

InvalidImagesOutputException String

Invalid output from docker images.

InvalidPSOutputException String

Invalid output from docker ps.

InvalidInspectOutputException String

Invalid output from docker inspect.

PullFailedException String

Could not pull a Docker image.

DockerTooOldException Version Version

Installed version of docker below minimum version.

DockerVersionProhibitedException [Version] Version

Installed version of docker is prohibited.

BadDockerVersionException VersionRange Version

Installed version of docker is out of range specified in config file.

InvalidVersionOutputException

Invalid output from docker --version.

HostStackTooOldException Version (Maybe Version)

Version of stack on host is too old for version in image.

ContainerStackTooOldException Version Version

Version of stack in container/image is too old for version on host.

CannotDetermineProjectRootException

Can't determine the project root (where to put docker sandbox).

DockerNotInstalledException

docker --version failed.

UnsupportedStackExeHostPlatformException

Using host stack-exe on unsupported platform.

DockerStackExeParseException String

stack-exe option fails to parse.

Instances

Show StackDockerException

Methods

showsPrec :: Int -> StackDockerException -> ShowS

show :: StackDockerException -> String

showList :: [StackDockerException] -> ShowS

Exception StackDockerException

Methods

toException :: StackDockerException -> SomeException

fromException :: SomeException -> Maybe StackDockerException

displayException :: StackDockerException -> String