-
Language:
English
-
Language:
English
Red Hat Training
A Red Hat training course is available for Red Hat Container Development Kit
Release Notes and Known Issues
Highlighted features and identified problems in Red Hat Container Development Kit 3.6
Robin Owen
kowen@redhat.com
devtools-docs@redhat.com
Abstract
Chapter 1. Introducing Red Hat Container Development Kit
Red Hat Container Development Kit provides a platform for developing containerized applications. It is a set of tools that enables developers to quickly and easily set up an environment for developing and testing containerized applications on the Red Hat Enterprise Linux platform.
- Container Development Kit provides a personal Container Development Environment you can install on your own laptop, desktop, or server system. The Container Development Environment is provided in the form of a Red Hat Enterprise Linux virtual machine.
- Container Development Kit is available for the Microsoft Windows, macOS, and Linux operating systems, thus allowing developers to use their preferred platform while producing applications ready to be deployed in the Red Hat Enterprise Linux ecosystem.
Container Development Kit is a part of the Red Hat Developers program, which provides tools, resources, and support for developers who wish to utilize Red Hat solutions and products to create applications, both locally and in the cloud. For additional information and to register to become a part of the program, visit developers.redhat.com.
1.1. Understanding Container Development Kit Documentation
- The Red Hat Container Development Kit 3.6 Release Notes and Known Issues contains information about the current release of the product as well as a list of known problems that users may encounter when using it.
- The Container Development Kit Getting Started Guide contains instructions on how to install and start using the Container Development Environment to develop Red Hat Enterprise Linux-based containers using tools and services such as OpenShift Container Platform, Docker, Eclipse, and various command line tools.
- Report issues with Red Hat Container Development Kit or request new features using the CDK project at https://issues.jboss.org/projects/CDK.
- Report issues with the Red Hat Container Development Kit 3.6 Release Notes and Known Issues and Container Development Kit Getting Started Guide using the RHDEVDOCS project at https://issues.jboss.org/projects/RHDEVDOCS.
Chapter 2. Release Notes
This section documents the most important features and bug fixes in the Red Hat Container Development Kit 3.6 product.
2.1. Component Versions
Red Hat Container Development Kit 3.6 is shipped with the following versions of the main components:
Table 2.1. Container Development Kit, Component Versions
Component | Version |
---|---|
Docker | 1.13.1 |
Docker API | 1.26 |
Kubernetes | 1.10.0 |
OpenShift Container Platform | 3.10.45 |
2.2. VirtualBox Compatibility
Red Hat Container Development Kit 3.6 has been tested with VirtualBox 5.2.12 and higher, but is known to not work correctly with VirtualBox 5.1.11 or older. Ensure that you have VirtualBox 5.1.12 or higher if you intend to use VirtualBox as your virtualization provider. VirtualBox 5.2.12 is recommended.
2.3. New Features
This section highlights some of the new features offered by Red Hat Container Development Kit 3.6. The new version also contains a number of bug fixes.
Red Hat Container Development Kit 3.6 contains the Minishift tool, a Red Hat Enterprise Linux 7 ISO, and the oc
(OpenShift client) binary for interacting with OpenShift Container Platform.
2.3.1. Minishift
Red Hat Container Development Kit 3.6 is based on Minishift, a command line tool to provision OpenShift locally for application developers. It supports all native hypervisors and some additional ones:
- macOS
- xhyve (default)
- VirtualBox
- Linux
- KVM (default)
- VirtualBox
- Windows
- Hyper-V (default)
- VirtualBox
2.3.2. Technology Previews
Support for these features falls under the Technology Preview Features Support Scope.
- Container Development Kit now includes the ability to run a local proxy server. The local proxy server assists with the use of CDK in a proxy environment. For more information, see Local Proxy Server.
2.3.3. Usability Improvements
Container Development Kit now saves non-default flags given to the
minishift start
command to the persistent configuration. You are not required to explicitly save these settings. To disable this feature, run the following command:$ minishift config set save-start-flags false
Container Development Kit now allows you to start CDK with the latest OpenShift Container Platform version using the following command:
$ minishift start --ocp-tag latest
- The generic driver for Container Development Kit has been improved. CDK now performs all of the required steps to allow OpenShift to start on the remote RHEL 7 machine.
- Container Development Kit now includes a way to express dependencies between add-ons. For more information, see Defining Add-on Dependencies.
Chapter 3. Known Issues
This section describes issues that users of Red Hat Container Development Kit 3.6 may encounter, as well as possible workarounds for these issues.
3.1. General Issues
Issues affecting all supported platforms.
3.1.1. Check for requested OpenShift version fails
The pre-flight check used to verify the requested OpenShift version fails when running minishift start
. This is due to deprecated support for the Docker v1 API which is used to verify the requested OpenShift version. For more information, see Deprecation of Docker v1 Content.
To work around this issue, run the following command:
$ minishift config set skip-check-openshift-release true
3.2. Issues on macOS
This section describes CDK issues that affect users on a macOS host.
3.2.1. OpenShift web console does not work with older versions of Safari
minishift console
does not work on older versions of the Safari web browser such as version 10.1.2 (12603.3.8). Attempting to access the web console results in the following error:
Error unable to load details about the server
Retry after updating Safari to the latest version or use the Firefox or Chrome web browsers for this. Safari version 11.0.3 (13604.5.6) has been tested and works with the OpenShift web console. You can use minishift console --url
to get the web console URL.
3.3. Issues on Microsoft Windows
This section describes CDK issues that affect users on a Microsoft Windows host.
3.3.1. Default Switch does not work as expected with static IP
The experimental static IP feature is not possible with the Default Switch provided by Windows. The minishift
virtual machine will receive an IP address, but network traffic will not be able to pass through it.
See Assign IP Address to Hyper-V for more information about how to assign a static IP address to the minishift
VM on Windows.
3.3.2. Windows Command Prompt and PowerShell improperly parse JSON patches for the minishift openshift config set
command
Windows Command Prompt and PowerShell have problems with parsing JSON into the minishift openshift config set
command. Special attention is required when using this command on Windows.
The workaround for Windows Command Prompt environments is to escape the quotes so that the JSON content is correctly parsed:
C:\Users\CDK> minishift.exe openshift config set --patch "{\"routingConfig\": {\"subdomain\": \"192.168.99.101.nip.io\"}}"
The workaround for Windows PowerShell environments is to use a variable to store the JSON content:
PS C:\Users\CDK> $json='{\"routingConfig\": {\"subdomain\": \"192.168.99.101.nip.io\"}}' PS C:\Users\CDK> echo $json {\"routingConfig\": {\"subdomain\": \"192.168.99.101.nip.io\"}} PS C:\Users\CDK> minishift.exe openshift config set --patch $json Patching OpenShift configuration /var/lib/origin/openshift.local.config/master/master-config.yaml with {"routingConfig": {"subdomain": "192.168.99.101.nip.io"}}
3.3.3. minishift openshift config set --patch
may fail on some Windows 7 and 10 hosts
The reason for this failure is currently unknown.
Workaround: Configure the OpenShift cluster from inside of the provisioned VM using minishift ssh
:
C:\Users\CDK> minishift.exe ssh [docker@minishift ~]$ docker exec -t origin /usr/bin/openshift ex config patch /var/lib/origin/openshift.local.config/master/master-config.yaml --patch='<json-to-be-applied-to-the-cluster>'
Chapter 4. Additional Resources
- See the Container Development Kit Getting Started Guide for an overview of Container Development Kit features and an introduction to the use of the Docker service and OpenShift Container Platform.
- Report issues with Red Hat Container Development Kit or request new features using the CDK project at https://issues.jboss.org/projects/CDK.