ALOps Docker Wait¶

Wait for a Business Central Docker container to become ready.

Property	Value
Task name (Azure DevOps)	`ALOpsDockerWait@3`
Action name (GitHub)	`alops-dockerwait`
Version	`3.0.0`
Category	Utility
OS requirement	Both
Preview	yes

Wait for a Business Central Docker container to become ready by polling its logs. Extracts connection info (IP, hostname, web client URL, admin credentials) and optionally copies the workspace into the container.

Inputs¶

container¶

Name	Type	Required	Default	Platform	Description
`fixed_tag`	Text	no	(empty)	Both	Fixed container label. When set, the container is identified by this value instead of the build ID.

polling¶

Name	Type	Required	Default	Platform	Description
`search_string`	MultiLine	yes	`Ready for connections!`	Both	Log line(s) that indicate the container is ready. One pattern per line.
`warning_string`	MultiLine	no	(empty)	Both	Log line(s) that trigger a warning. One pattern per line.
`error_string`	MultiLine	no	(empty)	Both	Log line(s) that trigger an immediate failure. One pattern per line.
`printlogs`	Boolean	no	`true`	Both	Print container log lines to the build output while polling.

workspace¶

Name	Type	Required	Default	Platform	Description
`setup_working_folder`	Boolean	no	`true`	Both	Copy the workspace into the container after it becomes ready.
`usecompression`	Boolean	no	`true`	Both	Compress the workspace before copying into the container. Faster for large workspaces.
`exclude_git_folder`	Boolean	no	`false`	Both	Exclude the .git folder when copying the workspace into the container.

Outputs¶

Name	Description
`container_id`	The Docker container ID.
`container_ipaddress`	The container's IP address.
`container_hostname`	The container's hostname.
`container_dnsname`	The container's DNS name.
`container_webclient`	The Business Central web client URL.
`container_vsix`	The AL Language VSIX download URL.
`container_certificate`	The container's certificate thumbprint.
`container_adminuser`	The container's admin username.
`container_adminpassword`	The container's admin password.
`container_navserverinstance`	The NAV/BC server instance name.

Usage¶

Azure DevOpsGitHub Actions

- task: ALOpsDockerWait@3
  displayName: 'ALOps Docker Wait'
  inputs:
    fixed_tag:                             # Fixed container label. When set, the container is identified by this value instead of the build ID. $(fixed_tag)
    search_string: Ready for connections!  # Log line(s) that indicate the container is ready. One pattern per line. $(search_string)
    warning_string:                        # Log line(s) that trigger a warning. One pattern per line. $(warning_string)
    error_string:                          # Log line(s) that trigger an immediate failure. One pattern per line. $(error_string)
    printlogs: True                        # Print container log lines to the build output while polling. $(printlogs)
    setup_working_folder: True             # Copy the workspace into the container after it becomes ready. $(setup_working_folder)
    usecompression: True                   # Compress the workspace before copying into the container. Faster for large workspaces. $(usecompression)
    exclude_git_folder: False              # Exclude the .git folder when copying the workspace into the container. $(exclude_git_folder)

- name: ALOps Docker Wait
  uses: HodorNV/ALOps-V3/alops-dockerwait@v3   <!-- TODO: confirm action repo path -->
  with:
    fixed_tag: ''
    search_string: 'Ready for connections!'
    warning_string: ''
    error_string: ''
    printlogs: 'true'
    setup_working_folder: 'true'
    usecompression: 'true'
    exclude_git_folder: 'false'