Skip to content

vSphere Integrated Containers Engine Version v0.8.0-rc2

Pre-release
Pre-release
Compare
Choose a tag to compare
@mdubya66 mdubya66 released this 25 Nov 18:04
· 2158 commits to master since this release

Changes from v0.7.0 v0.7.0...v0.8.0-rc2

This release is primarily addressing functional and usability issues.

Features:

  • To be updated

Of note:
Do we want to keep this?
If a container is started and subsequently attached to, only output generated by the container after the attach completes will be seen - docker logs can be used to obtain the entire output over the life of the container.

If an attach is done prior to start, e.g. run -it or start -ai, we delay launching the container process until the attach has completed as we infer from the operation ordering a desire to receive all output from process launch onward.

Attaching to a containerVM inhibits that VM from vMotioning, detaching removes that inhibition:

  • to launch a container without attaching, use start or run -d
  • to detach from a TTY enabled container, using Ctrl-P Ctrl-Q
  • to detach from a non-TTY enabled container, kill the docker client via a different terminal
  • issues still exist with container logs when vMotioning containers

Resolved Issues

  • Virtual container host does not work if management interface is not Layer 2 adjacent to vSphere management endpoints. #3081
  • Setting a static IP address on the virtual container host without specifying --dns-server defaults to the specified gateway. #3060
  • A single image cannot currently contain multiple tags. #1638
  • rmi on VSAN fails with error "Cannot delete file" #2384
  • Inconsistent license check reporting between vic-machine and vic-admin #2305
  • vic-machine does not support secure test registries. #2103
  • Allowing and configuring insecure registries is not supported. #1486

Known Issues

  • Firewall status delayed on vCenter Server. #3139
    If you update the firewall rules on an ESXi host to allow access from specific IP addresses, and if that host is managed by vCenter Server, there might be a delay before vCenter Server takes the updated firewall rule into account. In this case, vCenter Server continues to use the old configuration for an indeterminate amount of time after you have made the update. vic-machine create can successfully deploy a VCH with an address that you have blocked, or else fail when you deploy a VCH with an address that you have permitted.

    Workaround: Wait a few minutes and run vic-machine create again.

  • Piping information into busybox fails. #3017
    If you attempt to pipe information into busybox, for example by running echo test | docker run -i busybox cat, the operation fails with the following error:

    Error response from daemon: Server error from portlayer: 
    ContainerWaitHandler(container_id) 
    Error: context deadline exceeded
    
  • Deleting a VCH from an ESXi host does not remove the bridge network if it was created with a custom name. #3193
    If you deploy a VCH to an ESXi host and use the --bridge-network option to create a bridge network with a custom name, vic-machine delete does not remove the bridge network if you delete the VCH.

    Workaround: Manually delete the bridge network from the ESXi host.

  • Running docker ps -aq reports containers that have been removed. #3196
    Listing containers by running docker ps -aq can include containers that have been removed. Attempting to perform an operation on a container that was included in the output of docker ps -aq, for example docker rm -f, results in the error Error response from daemon: No such container.

    Workaround: Run docker rm -f again.

  • VCH Admin shows network failure when virtual container host uses a proxy. #3213
    If a virtual container host is configured to use a proxy, the VCH Admin status page shows a network failure even if connectivity through the proxy is working.

  • vic-machine delete does not recognize virtual container hosts that were not fully created. #2981
    vic-machine delete fails when you run it on a virtual container host that was not fully created.

    Workaround: Manually delete any components of a partial installation, for example, the virtual container host vApp, the endpoint VM, and datastore folders.

  • Incorrect gateway example in --container-network-gateway help 1741

    The help text for vic-machine's option --container-network-gateway value, --cng incorrectly gives the example of a network range instead of the actual gateway address. A more proper example is e.g. vsphere-net:172.16.1.1/16. In additon, please note that we will be removing the CIDR specification from the gateway configuration in a future release.

  • Container fails to shut down with Error response from daemon: server error from portlayer : [DELETE /containers/{id}][500] containerRemoveInternalServerError. #1823

    Workaround: Developers: run docker create again. Administrators: Un-register and re-register the VM in the vSphere UI.

  • Mounting directories as a data volume using the -v option is not supported. #2303

  • When you pull a large sized image from Harbor into a virtual container host, you get an error that the /tmp partition reached capacity. #2595

    docker: Failed to fetch image blob: weblogic/test_domain/sha256:3bf21a5a3fdf6586732efc8c64581ae1b4c75e342b210c1b6f799a64bffd7924 returned download failed: write /tmp/3bf21a5a3fdf346188145: no space left on device.

    Workaround: Deploy the virtual container host with --appliance-memory=4096 which increases the appliance memory configuration.

  • Installing the virtual container host using a short hostname fails. #2582
    Workaround:

    • The IP address that you provide to vic-machine create target must be reachable on the management network.
    • If you use a DNS name instead of an IP address, the virtual container host endpoint VM must be able to resolve the name using the DNS server that is configured either by DHCP or by the vic-machine create --dns-server option. There is no default search domain, so use the FQDN.
  • Pulling all tagged images in a repository is not supported. #2724

    vSphere Integrated Containers only attempts to pull the latest tagged images.

  • Misleading error message appears when you run out of memory on ESXi. #2840

  • vSphere Integrated Containers fails to delete the vApp that remains after a virtual container host creation fails. #2853

  • The docker personality is currently tied to API 1.23, which corresponds to CLI 1.11. #2368
  • Virtual Container Host is unresponsive in a cluster with DRS and HA enabled. #2298

    DRS and HA are not supported in this release.
  • Container VM fails to start on VIC backed by a VVOL datastore. #2242

    VVOL datastores are not supported in this release.
  • Attaching the same container from multiple terminals causes problems. #2214
  • vic-machine create prompts you for a password without allowing time to enter it and the VCH deployment fails with an incorrect username and password error. #2152
  • --net=none is not supported. #2108
  • VCH restarts if required process cannot be restarted. #2099

    The system attempts to restart a finite number of times, then reports an error, leaving the VCH up and running to download logs. Instead, VCH immediately reboots.
  • vic-machine incorrectly assumes conf.ImageStores[0] is the appliance datastore. #1884
  • When some of the hosts in the cluster are not attached to the dVS and do not have access to the bridge network, the error message is not easily readable. #1647
  • Image manifest validation for pulled images is not supported. #1331
  • Setting up overlay networks is not supported. #1222

    Error response from daemon: scope type not supported
  • vic-machine can connect to the target but the VCH appliance cannot. #1160

    The VCH cannot get an IP address on the management network or does not have a route to the specified target.
  • Adding folder options to vic-machine is not yet implemented. #773
  • Adding mapped vSphere networks to running containers is not yet implemented. #745
  • Adding bridge networks to running containers is not yet implemented. #743
  • Mapping an existing vSphere level network into the Docker network to explicitly provide a container with a route not through the VCH appliance is not yet implemented. #441
  • volume ls ignores filters #1718

  • docker run busybox behaves incorrectly #1687

    The container configuration between vSphere Integrated Containers Engine and Docker containers is different in that vSphere Integrated Containers Engine attempts to attach to a container and Docker exits immediately.

  • docker ps -n shows stopped containers that have been created, but not started, for the state of the container #1545

  • Incorrect image digest format sent to Docker client #1484

    docker images --digests is not supported.

    Workaround: Pull images by tag instead.

  • docker pull results an "already exists" error #1409

    When performing docker pull busybox, a context deadline occurs on the port layer, causing an inconsistent state. Pulls can take a very long time with a slow network connection.

  • vic-machine create validation fails if a dvSwitch exists on an ESXi target #729

  • Root user support #1279

    vSphere Integrated Containers Engine does not support root users inside containers.
  • The log server does not require authentication and might expose sensitive system information.

    Debug logging is enabled in this release. This can potentially expose the path and identity of system resources over HTTP via the vicadmin portal. Plain-text passwords are not exposed.
  • Using anonymous volumes

    To use anonymous volumes with docker create -V, you must specify a default volume store when you run vic-machine create to create the virtual container host. For example, ./vic-machine create <...> --volume-store default:datastore1/anonymousVolumes

Download Binaries

Installation

For instructions about how to deploy a vSphere Integrated Containers Engine v0.8.0 virtual container host, see vSphere Integrated Containers Engine Installation HTML | PDF | Source.

Using vSphere Integrated Containers Engine

For more details on using vSphere Integrated Containers Engine v0.8.0 see the general usage doc in Github, or the current drafts of the end user documentation on https://vmware.github.io/vic:

  • vSphere Integrated Containers Engine Installation HTML | PDF | Source.
  • vSphere Integrated Containers Engine for vSphere Administrators HTML | PDF | Source
  • Developing Container Applications with vSphere Integrated Containers Engine HTML | PDF | Source

Open Source Components

The copyright statements and licenses applicable to the open source software components distributed in vSphere Integrated Containers Engine are available in the LICENSE file.