Codewind Docker registry guidance
When you run Codewind on Kubernetes for Codewind style projects, Codewind uses
buildah to build container images from Dockerfiles and to push the images to an image registry that you specify. You can use the
Image Registry Manager in your Codewind IDE to configure the registry to use.
Codewind is flexible with the registry that can be used as long as
buildah and the node that Codewind is running on can resolve the registry hostname. If
buildah is unable to resolve the registry hostname,
buildah is unable to push your projects to the registry, and deployment on Kubernetes is prevented.
Before you proceed, see the examples section on recommended values for common registries:
The following deployment registries have been tested and verified with Codewind:
- Docker Hub:
- Credentials: Docker Hub username and password or token access
- Credentials: Quay.io user name and encrpyted password
- Credentials: Artifactory user name and token
- OpenShift Registry
- Credentials: OpenShift user name and token
Note: For Docker Hub, the
Namespacevalue is likely to be your username.
Specifying image registries for Codewind
There are three scenarios in Codewind where you need to specify what image registry to use:
- If you run Codewind on a remote Kubernetes cluster (this includes Che) to develop an Appsody style project, and the image registry for the Appsody stack requires credentials, you need to configure Codewind to use the credentials for that specific image registry.
- If you run Codewind locally to develop an Appsody style project, and the image registry for the Appsody stack requires credentials, you need to
docker loginto the registry from the command line before you create the Appsody project.
- If you run Codewind on a remote Kubernetes cluster (this includes Che) to develop a Codewind style project, you need to configure Codewind with an image registry to push the application’s image to that specific image registry.
If you do not develop any Codewind style projects,and you use an image registry that does not require credentials, then you do not need to specify an image registry.
Instructions specific to OKD and OpenShift
To use the OpenShift internal Docker registry with Codewind, see Using the OpenShift Internal Registry with Codewind.