Stack.Types.Docker

Docker types.

Documentation

data DockerException

Type representing exceptions thrown by functions exported by the Stack.Docker module.

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.

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

Exception DockerException

Defined in Stack.Types.Docker

Methods

toException :: DockerException -> SomeException

fromException :: SomeException -> Maybe DockerException

displayException :: DockerException -> String

Show DockerException

Defined in Stack.Types.Docker

Methods

showsPrec :: Int -> DockerException -> ShowS

show :: DockerException -> String

showList :: [DockerException] -> ShowS

data DockerMonoidRepoOrImage

Options for Docker repository or image.

Constructors

DockerMonoidRepo String

DockerMonoidImage String

Instances

Show DockerMonoidRepoOrImage

Defined in Stack.Types.Docker

Methods

showsPrec :: Int -> DockerMonoidRepoOrImage -> ShowS

show :: DockerMonoidRepoOrImage -> String

showList :: [DockerMonoidRepoOrImage] -> ShowS

data DockerOpts

Docker configuration.

Constructors

DockerOpts

Fields

• dockerEnable :: !Bool

  Is using Docker enabled?

• dockerImage :: !(Either SomeException String)

  Exact Docker image tag or ID. Overrides docker-repo-*/tag.

• dockerRegistryLogin :: !Bool

  Does registry require login for pulls?

• dockerRegistryUsername :: !(Maybe String)

  Optional username for Docker registry.

• dockerRegistryPassword :: !(Maybe String)

  Optional password for Docker registry.

• dockerAutoPull :: !Bool

  Automatically pull new images.

• dockerDetach :: !Bool

  Whether to run a detached container

• dockerPersist :: !Bool

  Create a persistent container (don't remove it when finished). Implied by dockerDetach.

• dockerContainerName :: !(Maybe String)

  Container name to use, only makes sense from command-line with dockerPersist or dockerDetach.

• dockerNetwork :: !(Maybe String)

  The network docker uses.

• dockerRunArgs :: ![String]

  Arguments to pass directly to docker run.

• dockerMount :: ![Mount]

  Volumes to mount in the container.

• dockerMountMode :: !(Maybe String)

  Volume mount mode

• dockerEnv :: ![String]

  Environment variables to set in the container.

• dockerStackExe :: !(Maybe DockerStackExe)

  Location of container-compatible Stack executable

• dockerSetUser :: !(Maybe Bool)

  Set in-container user to match host's

• dockerRequireDockerVersion :: !VersionRange

  Require a version of Docker within this range.

Instances

Show DockerOpts

Defined in Stack.Types.Docker

Methods

showsPrec :: Int -> DockerOpts -> ShowS

show :: DockerOpts -> String

showList :: [DockerOpts] -> ShowS

data DockerOptsMonoid

An uninterpreted representation of docker options. Configurations may be "cascaded" using mappend (left-biased).

Constructors

DockerOptsMonoid

Fields

• dockerMonoidDefaultEnable :: !Any

  Should Docker be defaulted to enabled (does docker: section exist in the config)?

• dockerMonoidEnable :: !(First Bool)

  Is using Docker enabled?

• dockerMonoidRepoOrImage :: !(First DockerMonoidRepoOrImage)

  Docker repository name (e.g. fpco/stack-build or fpco/stack-full:lts-2.8)

• dockerMonoidRegistryLogin :: !(First Bool)

  Does registry require login for pulls?

• dockerMonoidRegistryUsername :: !(First String)

  Optional username for Docker registry.

• dockerMonoidRegistryPassword :: !(First String)

  Optional password for Docker registry.

• dockerMonoidAutoPull :: !FirstTrue

  Automatically pull new images.

• dockerMonoidDetach :: !FirstFalse

  Whether to run a detached container

• dockerMonoidPersist :: !FirstFalse

  Create a persistent container (don't remove it when finished). Implied by -- dockerDetach.

• dockerMonoidContainerName :: !(First String)

  Container name to use, only makes sense from command-line with dockerPersist or dockerDetach.

• dockerMonoidNetwork :: !(First String)

  See: dockerNetwork

• dockerMonoidRunArgs :: ![String]

  Arguments to pass directly to docker run

• dockerMonoidMount :: ![Mount]

  Volumes to mount in the container

• dockerMonoidMountMode :: !(First String)

  Volume mount mode

• dockerMonoidEnv :: ![String]

  Environment variables to set in the container

• dockerMonoidStackExe :: !(First DockerStackExe)

  Location of container-compatible Stack executable

• dockerMonoidSetUser :: !(First Bool)

  Set in-container user to match host's

• dockerMonoidRequireDockerVersion :: !IntersectingVersionRange

  See: dockerRequireDockerVersion

Instances

Monoid DockerOptsMonoid

Left-biased combine Docker options

Defined in Stack.Types.Docker

Methods

mempty :: DockerOptsMonoid

mappend :: DockerOptsMonoid -> DockerOptsMonoid -> DockerOptsMonoid

mconcat :: [DockerOptsMonoid] -> DockerOptsMonoid

Semigroup DockerOptsMonoid

Left-biased combine Docker options

Defined in Stack.Types.Docker

Methods

(<>) :: DockerOptsMonoid -> DockerOptsMonoid -> DockerOptsMonoid

sconcat :: NonEmpty DockerOptsMonoid -> DockerOptsMonoid

stimes :: Integral b => b -> DockerOptsMonoid -> DockerOptsMonoid

Generic DockerOptsMonoid

Defined in Stack.Types.Docker

Associated Types

type Rep DockerOptsMonoid :: Type -> Type

Methods

from :: DockerOptsMonoid -> Rep DockerOptsMonoid x

to :: Rep DockerOptsMonoid x -> DockerOptsMonoid

Show DockerOptsMonoid

Defined in Stack.Types.Docker

Methods

showsPrec :: Int -> DockerOptsMonoid -> ShowS

show :: DockerOptsMonoid -> String

showList :: [DockerOptsMonoid] -> ShowS

FromJSON (WithJSONWarnings DockerOptsMonoid)

Decode uninterpreted docker options from JSON/YAML.

Defined in Stack.Types.Docker

Methods

parseJSON :: Value -> Parser (WithJSONWarnings DockerOptsMonoid)

parseJSONList :: Value -> Parser [WithJSONWarnings DockerOptsMonoid]

type Rep DockerOptsMonoid

Defined in Stack.Types.Docker

type Rep DockerOptsMonoid = D1 ('MetaData "DockerOptsMonoid" "Stack.Types.Docker" "stack-2.14.0-CKI3CqdNSm89Q6MbWoYM52" 'False) (C1 ('MetaCons "DockerOptsMonoid" 'PrefixI 'True) ((((S1 ('MetaSel ('Just "dockerMonoidDefaultEnable") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 Any) :*: S1 ('MetaSel ('Just "dockerMonoidEnable") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 (First Bool))) :*: (S1 ('MetaSel ('Just "dockerMonoidRepoOrImage") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 (First DockerMonoidRepoOrImage)) :*: S1 ('MetaSel ('Just "dockerMonoidRegistryLogin") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 (First Bool)))) :*: ((S1 ('MetaSel ('Just "dockerMonoidRegistryUsername") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 (First String)) :*: S1 ('MetaSel ('Just "dockerMonoidRegistryPassword") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 (First String))) :*: (S1 ('MetaSel ('Just "dockerMonoidAutoPull") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 FirstTrue) :*: (S1 ('MetaSel ('Just "dockerMonoidDetach") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 FirstFalse) :*: S1 ('MetaSel ('Just "dockerMonoidPersist") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 FirstFalse))))) :*: (((S1 ('MetaSel ('Just "dockerMonoidContainerName") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 (First String)) :*: S1 ('MetaSel ('Just "dockerMonoidNetwork") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 (First String))) :*: (S1 ('MetaSel ('Just "dockerMonoidRunArgs") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 [String]) :*: S1 ('MetaSel ('Just "dockerMonoidMount") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 [Mount]))) :*: ((S1 ('MetaSel ('Just "dockerMonoidMountMode") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 (First String)) :*: S1 ('MetaSel ('Just "dockerMonoidEnv") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 [String])) :*: (S1 ('MetaSel ('Just "dockerMonoidStackExe") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 (First DockerStackExe)) :*: (S1 ('MetaSel ('Just "dockerMonoidSetUser") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 (First Bool)) :*: S1 ('MetaSel ('Just "dockerMonoidRequireDockerVersion") 'NoSourceUnpackedness 'SourceStrict 'DecidedStrict) (Rec0 IntersectingVersionRange)))))))

data DockerStackExe

Where to get the stack executable to run in Docker containers

Constructors

DockerStackExeDownload

Download from official bindist

DockerStackExeHost

Host's stack (linux-x86_64 only)

DockerStackExeImage

Docker image's stack (versions must match)

DockerStackExePath (Path Abs File)

Executable at given path

Instances

FromJSON DockerStackExe

Defined in Stack.Types.Docker

Methods

parseJSON :: Value -> Parser DockerStackExe

parseJSONList :: Value -> Parser [DockerStackExe]

Show DockerStackExe

Defined in Stack.Types.Docker

Methods

showsPrec :: Int -> DockerStackExe -> ShowS

show :: DockerStackExe -> String

showList :: [DockerStackExe] -> ShowS

data Mount

Docker volume mount.

Constructors

Mount String String

Instances

FromJSON Mount

For YAML.

Defined in Stack.Types.Docker

Methods

parseJSON :: Value -> Parser Mount

parseJSONList :: Value -> Parser [Mount]

Read Mount

For optparse-applicative.

Defined in Stack.Types.Docker

Methods

readsPrec :: Int -> ReadS Mount

readList :: ReadS [Mount]

readPrec :: ReadPrec Mount

readListPrec :: ReadPrec [Mount]

Show Mount

Show instance.

Defined in Stack.Types.Docker

Methods

showsPrec :: Int -> Mount -> ShowS

show :: Mount -> String

showList :: [Mount] -> ShowS

newtype VersionRangeJSON

Newtype for non-orphan FromJSON instance.

Constructors

VersionRangeJSON

Fields

• unVersionRangeJSON :: VersionRange

Instances

FromJSON VersionRangeJSON

Parse VersionRange.

Defined in Stack.Types.Docker

Methods

parseJSON :: Value -> Parser VersionRangeJSON

parseJSONList :: Value -> Parser [VersionRangeJSON]

dockerAutoPullArgName :: Text

Docker auto-pull argument name.

dockerCmdName :: String

Command-line argument for "docker"

dockerContainerNameArgName :: Text

Docker container name argument name.

dockerContainerPlatform :: Platform

Platform that Docker containers run

dockerDetachArgName :: Text

Docker detach argument name.

dockerEnableArgName :: Text

Docker enable argument name.

dockerEntrypointArgName :: String

Argument name used to pass docker entrypoint data (only used internally)

dockerEnvArgName :: Text

Docker environment variable argument name.

dockerHelpOptName :: String

dockerImageArgName :: Text

Docker image argument name.

dockerMountArgName :: Text

Docker mount argument name.

dockerMountModeArgName :: Text

Docker mount mode argument name.

dockerNetworkArgName :: Text

Docker container name argument name.

dockerPersistArgName :: Text

Docker persist argument name.

dockerPullCmdName :: String

Command-line argument for docker pull.

dockerRegistryLoginArgName :: Text

Docker registry login argument name.

dockerRegistryPasswordArgName :: Text

Docker registry password argument name.

dockerRegistryUsernameArgName :: Text

Docker registry username argument name.

dockerRepoArgName :: Text

Docker repo arg argument name.

dockerRequireDockerVersionArgName :: Text

Docker require-version argument name

dockerRunArgsArgName :: Text

Docker run args argument name.

dockerSetUserArgName :: Text

Docker set-user argument name

dockerStackExeArgName :: Text

Docker Stack executable argument name.

dockerStackExeDownloadVal :: String

Value for --docker-stack-exe=download

dockerStackExeHostVal :: String

Value for --docker-stack-exe=host

dockerStackExeImageVal :: String

Value for --docker-stack-exe=image

parseDockerStackExe :: MonadThrow m => String -> m DockerStackExe

Parse DockerStackExe.

reExecArgName :: String

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