You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/containers/imageregistry.md
+157-6Lines changed: 157 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -117,42 +117,193 @@ Some examples of an image registry are **Red Hat Quay** and **IBM Cloud Registry
117
117
118
118
=== "Podman"
119
119
120
+
**1. Install the Container Registry CLI**
121
+
122
+
Before you begin, you need to install the IBM Cloud CLI so that you can run the IBM Cloud ***ibmcloud*** commands.
123
+
``` Bash title="Install the container-registry CLI"
124
+
ibmcloud plugin install container-registry
125
+
```
126
+
**2. Set up a namespace**
127
+
128
+
Then, you need to create a namespace. The namespace is created in the resource group that you specify so that you can configure access to resources within the namespace at the resource group level. If you don't specify a resource group, then the default is used.
129
+
``` Bash title="Log in to IBM Cloud"
130
+
ibmcloud login
131
+
```
132
+
133
+
``` Bash title="Create namespace"
134
+
ibmcloud cr namespace-add <my_namespace>
135
+
```
136
+
Make sure to replace <my_namespace\> with your preferred namespace.
137
+
138
+
If you want to create the namespace in a specific resource group, use the following code **before** creating the namespace.
139
+
``` Bash title="Specify a resource group"
140
+
ibmcloud target -g <resource_group>
141
+
```
142
+
Replace <resource_group\> with the resource group you want to create the namespace in.
143
+
144
+
To validate the namespace was created, run the following command.
145
+
``` Bash title="Validate namespace is created"
146
+
ibmcloud cr namespace-list -v
147
+
```
148
+
149
+
**3. Pull images from a registry to your local computer**
150
+
151
+
Next, you can pull images from IBM Cloud Registry to your local computer. Make sure [Podman](https://podman.io/docs/installation){target="_blank"} is installed and up and running.
152
+
153
+
``` Bash title="Pull image to local computer"
154
+
podman pull <source_image>:<tag>
155
+
```
156
+
Replace <source_image\> with the respository of the image and <tag\> with the tag of the image that you want to use.
157
+
158
+
Below is an example where <source_image\> is "hello-world" and <tag\> is "latest".
159
+
160
+
```
161
+
podman pull hello-world:latest
162
+
```
163
+
164
+
**4. Tag the image**
165
+
166
+
Tags are used as an optional identifier to specify a particular version of an image.
167
+
168
+
``` Bash title="Tag image"
169
+
podman tag <source_image>:<tag> <region>.icr.io/<my_namespace>/<new_image_repo>:<new_tag>
170
+
```
171
+
Replace <source_image\> with the respository of the image, <tag\> with the tag of your local image that you previously pulled, <region\> with the name of your region, and <my_namespace\> with the namespace you created in step 2. You'll want to define the repository and tag of the image that you want to use in your namespace by replacing <new_image_repo\> and <new_tag\> respectively.
172
+
173
+
Below is an example where <source_image\> is "hello-world", <tag\> is "latest", <region\> is "uk", <my_namespace\> is "namespace1", <new_image_repo\> is "hw_repo", and <new_tag\> is "1".
174
+
175
+
```
176
+
podman tag hello-word:latest uk.icr.io/namespace1/hw_repo:1
177
+
```
178
+
179
+
**5. Push images to your namespace**
180
+
181
+
First, you'll need to log in to IBM Cloud Container Registry.
182
+
183
+
``` Bash title="Log in to ICR"
184
+
ibmcloud cr login --client podman
185
+
```
186
+
187
+
Once you've logged in, you can push the image up to your namespace in the registry.
Replace <my_namespace\> with the namespace you created in step 2 and <image_repo\> and <tag\> with the repository and tag of the image you chose when you tagged the image in step 4.
194
+
195
+
Below is an example where <region\> is "uk", <my_namespace\> is "namespace1", <image_repo\> is "hw_repo", and <tag\> is "1".
196
+
197
+
```
198
+
podman push uk.icr.io/namespace1/hw_repo:1
199
+
```
200
+
201
+
**6. Verify that the image was pushed**
202
+
203
+
Verify that the image was pushed successfully by running the comand below.
204
+
205
+
```
206
+
ibmcloud cr image-list
207
+
```
208
+
209
+
You can also view your pushed images by clicking on the button below:
Before you begin, you need to install the IBM Cloud CLI so that you can run the IBM Cloud ***ibmcloud*** commands.
123
218
``` Bash title="Install the container-registry CLI"
124
219
ibmcloud plugin install container-registry
125
220
```
126
221
222
+
**2. Set up a namespace**
223
+
127
224
Then, you need to create a namespace. The namespace is created in the resource group that you specify so that you can configure access to resources within the namespace at the resource group level. If you don't specify a resource group, then the default is used.
128
225
``` Bash title="Log in to IBM Cloud"
129
226
ibmcloud login
130
227
```
131
228
132
229
``` Bash title="Create namespace"
133
-
ibmcloud cr namespace-add my_namespace
230
+
ibmcloud cr namespace-add <my_namespace>
134
231
```
135
-
Make sure to replace "my_namespace" with your preferred namespace.
232
+
Make sure to replace <my_namespace\> with your preferred namespace.
136
233
137
234
If you want to create the namespace in a specific resource group, use the following code **before** creating the namespace.
138
235
``` Bash title="Specify a resource group"
139
-
ibmcloud target -g resource_group
236
+
ibmcloud target -g <resource_group>
140
237
```
141
-
Replace "resource_group" with the resource group you want to create the namespace in.
238
+
Replace <resource_group\> with the resource group you want to create the namespace in.
142
239
240
+
To validate the namespace was created, run the following command.
143
241
``` Bash title="Validate namespace is created"
144
242
ibmcloud cr namespace-list -v
145
243
```
146
244
245
+
**3. Pull images from a registry to your local computer**
246
+
147
247
Next, you can pull images from IBM Cloud Registry to your local computer. Make sure [Docker](https://www.docker.com/products/container-runtime/#/download){target="_blank"} is installed and up and running.
148
248
149
249
``` Bash title="Pull image to local computer"
150
-
docker pull source_image:tag
250
+
docker pull <source_image>:<tag>
151
251
```
152
-
Replace "source_image" with ther respository of the image and "tag" with the tag of the image that you want to use. Below is an example.
252
+
Replace <source_image\> with the respository of the image and <tag\> with the tag of the image that you want to use.
253
+
254
+
Below is an example where <source_image\> is "hello-world" and <tag\> is "latest".
153
255
154
256
```
155
257
docker pull hello-world:latest
156
258
```
157
259
260
+
**4. Tag the image**
261
+
262
+
Tags are used as an optional identifier to specify a particular version of an image.
263
+
264
+
``` Bash title="Tag image"
265
+
docker tag <source_image>:<tag> <region>.icr.io/<my_namespace>/<new_image_repo>:<new_tag>
266
+
```
267
+
Replace <source_image\> with the respository of the image, <tag\> with the tag of your local image that you previously pulled, <region\> with the name of your region, and <my_namespace\> with the namespace you created in step 2. You'll want to define the repository and tag of the image that you want to use in your namespace by replacing <new_image_repo\> and <new_tag\> respectively.
268
+
269
+
Below is an example where <source_image\> is "hello-world", <tag\> is "latest", <region\> is "uk", <my_namespace\> is "namespace1", <new_image_repo\> is "hw_repo", and <new_tag\> is "1".
270
+
271
+
```
272
+
docker tag hello-word:latest uk.icr.io/namespace1/hw_repo:1
273
+
```
274
+
275
+
**5. Push images to your namespace**
276
+
277
+
First, you'll need to log in to IBM Cloud Container Registry.
278
+
279
+
``` Bash title="Log in to ICR"
280
+
ibmcloud cr login --client docker
281
+
```
282
+
283
+
Once you've logged in, you can push the image up to your namespace in the registry.
Replace <my_namespace\> with the namespace you created in step 2 and <image_repo\> and <tag\> with the repository and tag of the image you chose when you tagged the image in step 4.
290
+
291
+
Below is an example where <region\> is "uk", <my_namespace\> is "namespace1", <image_repo\> is "hw_repo", and <tag\> is "1".
292
+
293
+
```
294
+
docker push uk.icr.io/namespace1/hw_repo:1
295
+
```
296
+
297
+
**6. Verify that the image was pushed**
298
+
299
+
Verify that the image was pushed successfully by running the comand below.
300
+
301
+
```
302
+
ibmcloud cr image-list
303
+
```
304
+
305
+
You can also view your pushed images by clicking on the button below:
[Learn More about Quay :fontawesome-brands-redhat:](https://docs.redhat.com/en/documentation/red_hat_quay/3.5/html/deploy_red_hat_quay_for_proof-of-concept_non-production_purposes/pr01){ .md-button target="\_blank"} [Learn More about ICR :fontawesome-solid-cloud:](https://cloud.ibm.com/docs/Registry?topic=Registry-getting-started&interface=ui){ .md-button target="\_blank"}
Copy file name to clipboardExpand all lines: docs/index.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
## Bootcamp Overview
4
4
5
-
This Cloud Native Bootcamp has been created to teach and guide IBMers, Business Partners, and clients what it takes to move to the cloud. We want to provide a way for anyone using this site to come away with some hands-on experience in each of the different technologies listed below.
5
+
This Cloud Native Bootcamp has been created to teach and guide IBMers, Business Partners, and clients what it takes to move to the cloud. We want to provide a way for anyone using this site to come away with hands-on experience in each of the different technologies listed below.
6
6
7
7
8
8
## Concepts Covered
@@ -13,7 +13,7 @@ This Cloud Native Bootcamp has been created to teach and guide IBMers, Business
13
13
14
14
---
15
15
16
-
Moving to the cloud comes with some new concepts and standards that should be understood before starting your journey to cloud. Learn about them by clicking the link below.
16
+
Moving to the cloud comes with new concepts and standards that should be understood before starting your journey to cloud. Learn about them by clicking the link below.
@@ -45,4 +45,4 @@ This Cloud Native Bootcamp has been created to teach and guide IBMers, Business
45
45
46
46
## How to approach the Bootcamp
47
47
48
-
This bootcamp has been designed with a
48
+
This bootcamp has been designed to give the students a better hands-on experience than just copy/paste. The bootcamp uses the approach of "Read, listen, watch, try it out". We want students to take what they have heard and use their resources to solve the labs on their own without much instruction.
Copy file name to clipboardExpand all lines: docs/openshift/index.md
+6Lines changed: 6 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,6 +6,12 @@ Kubernetes is an open source container orchestration platform that automates dep
6
6
7
7
## What is OpenShift?
8
8
9
+
Red Hat OpenShift is an open-source container platform that runs on the Red Hat enterprise Linux operating system and Kubernetes. It is typically referred to as a "Platform as a Service" (PaaS) due to its combination of services for enterprise businesses, including the Kubernetes platform and Docker container images. OpenShift offers additional features exclusive to its enterprise platform. It allows for deploying apps on highly available clusters and securing hybrid workloads with developer-focused tools and seamless integration of IBM, CloudPak, and Red Hat content.
10
+
11
+
Red Hat OpenShift provides a uniform platform across public and private clouds for full portability, standardization, and ease of adoption. It offers various forms to meet customer needs, such as Red Hat OpenShift Container Platform (OCP), Red Hat OpenShift Dedicated (OSD), Microsoft Azure Red Hat OpenShift, and Red Hat OpenShift Online.
12
+
13
+
In summary, Red Hat OpenShift is an enterprise-ready Kubernetes container platform with full-stack automated operations for managing hybrid cloud and multi-cloud deployments. It offers multiple offerings to cater to diverse customer requirements and ensures a consistent experience across public and private clouds.
14
+
9
15
## What is Kubernetes?
10
16
11
17
Kubernetes—also known as ‘k8s’ or ‘kube’—is a container orchestration platform for scheduling and automating the deployment, management, and scaling of containerized applications.
0 commit comments