Red Hat SummitEste conteúdo não está disponível no idioma selecionado.
Chapter 2. Getting Started
2.1. System Requirements
To use Red Hat Data Grid for OpenShift, you need:
A running Red Hat OpenShift cluster.
For supported Red Hat OpenShift Container Platform versions, refer to Red Hat Data Grid Supported Configurations.
TipUse the Red Hat Container Development Kit to create a local OpenShift cluster with minishift.
-
An oc client in your
$PATH.
2.2. Creating a Data Grid for OpenShift Project
Set up an OpenShift project where you can run Data Grid for OpenShift pods.
Log in to your OpenShift cluster.
If you are new to OpenShift, try the following tutorial: Logging in to an OpenShift Cluster.
Create an OpenShift project with the
oc new-projectcommand, for example:oc new-project rhdg-helloworld --display-name="Red Hat Data Grid"
$ oc new-project rhdg-helloworld --display-name="Red Hat Data Grid"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.3. Setting Up Registry Authentication
You must authenticate with the Red Hat Container Catalog, registry.redhat.io, to pull Data Grid images.
Use one of the following:
-
Red Hat customer account username and password. Pull resources from registry.redhat.io with the
docker logincommand. Registry service account tokens. Use authentication tokens to configure multiple hosts. Do the following:
- Log in to registry.redhat.io.
- Create or select a Registry Service Account.
- Generate authentication tokens.
2.3.1. Configuring Hosts with Authentication Tokens
Add authentication tokens from your Registry Service Account to hosts as follows:
- Select the Docker Login tab and copy the command.
-
Run the
docker logincommand on each host that pulls from registry.redhat.io. Verify your Docker configuration.
cat ~/.docker/config.json ... "registry.redhat.io": { "auth": "MTEwMDkx..." }$ cat ~/.docker/config.json ... "registry.redhat.io": { "auth": "MTEwMDkx..." }Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.3.2. Creating Pull Secrets
To pull secured container images that are not available on the internal registry for OpenShift, do the following:
- Log in to your OpenShift cluster.
Select your working project, for example:
oc project rhdg-helloworld
$ oc project rhdg-helloworldCopy to Clipboard Copied! Toggle word wrap Toggle overflow Create a generic pull secret with your Docker configuration.
oc create secret generic ${SECRET_NAME} \ --from-file=.dockerconfigjson=path/to/.docker/config.json \ --type=kubernetes.io/dockerconfigjson$ oc create secret generic ${SECRET_NAME} \ --from-file=.dockerconfigjson=path/to/.docker/config.json \ --type=kubernetes.io/dockerconfigjsonCopy to Clipboard Copied! Toggle word wrap Toggle overflow Link the pull secret to your service account.
oc secrets link default ${SECRET_NAME} --for=pull$ oc secrets link default ${SECRET_NAME} --for=pullCopy to Clipboard Copied! Toggle word wrap Toggle overflow Mount the secret.
oc secrets link builder ${SECRET_NAME}$ oc secrets link builder ${SECRET_NAME}Copy to Clipboard Copied! Toggle word wrap Toggle overflow
For more information, including troubleshooting procedures, see Red Hat Container Registry Authentication.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}