vania-janet/multiturn-rag-retrieval-data huggingface dataset:
After you pull an image and [tag](https://cloud.ibm.com/docs/Registry?topic=Registry-registry_overviewoverview_elements_tag) it for your [namespace](https://cloud.ibm.com/docs/Registry?topic=Registry-registry_overviewoverview_elements_namespace), you can upload (push) the image from your local computer to your namespace.

If you deploy a workload that pulls an image from Container Registry and your pods fail with an ImagePullBackOff status, see [Why do images fail to pull from registry with ImagePullBackOff or authorization errors?](https://cloud.ibm.com/docs/Registry?topic=Registry-ts-app-image-pull) for assistance.





 Pushing Docker images to your namespace 

You can push (upload) an image to your namespace in IBM Cloud Container Registry to store and share your image with other users.

Zoom

![Push an image from your computer to IBM Cloud Container Registry.](https://cloud.ibm.com/docs-content/v1/content/cbb80bf851fb762a838129cba09d5674f8bfffda/Registry/images/pushing_images_mul.svg)

Figure 2. Pushing Docker images to your namespace

Before you begin, complete the following tasks.



* [Install the CLI](https://cloud.ibm.com/docs/Registry?topic=Registry-registry_setup_cli_namespacecli_namespace_registry_cli_install) to work with images in your namespace.
* [Set up your own namespace in IBM Cloud Container Registry](https://cloud.ibm.com/docs/Registry?topic=Registry-registry_setup_cli_namespaceregistry_namespace_setup).
For more information, see [Exporting a custom image to IBM Cloud Object Storage](https://cloud.ibm.com/docs/vpc?topic=vpc-managing-custom-images&interface=uicustom-image-export-to-cos).



 6 April 2023 

Image lifecycle management for custom images (beta)
: For customers with special access to this feature, you can use the UI, CLI, and API to manage the lifecycle of your custom images with the following three statuses. You can move the image back and forth through all the statuses. You can also schedule status changes to manage the entire lifecycle of the image. For more information, see [Custom image lifecycle](https://cloud.ibm.com/docs/vpc?topic=vpc-planning-custom-images&interface=uicustom-image-lifecycle) in [Getting started with custom images](https://cloud.ibm.com/docs/vpc?topic=vpc-planning-custom-images&interface=ui).



* available: The image can be used to create an instance.
* deprecated: The image can be used to create an instance. Using the deprecated status can discourage use of the image before the status changes to obsolete.
* obsolete: The image can't be used to create an instance.







 4 April 2023 

File Storage for VPC high-performance profile (beta)
: For customers with special access to this feature, you can now create file shares by using the dp2 high-performance profile. This profile provides higher IOPS and greater capacity than earlier profiles. You can also modify existing file shares to use this profile. For more information, see the [file share profiles overview](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-profiles&interface=uifile-storage-profile-overview).







 March 2023 



 31 March 2023 

New network latency dashboard to view latency between zones in a multi-zone region (MZR)
(https://cloud.ibm.com/docs-content/v1/content/b6066ebcc4ff31f2a8b558531f2ee791d108a7e1/cloud-pak-multicloud-management/images/import_custom_image_v2.png)

Figure 8. Example import of custom image

e. Select your Cloud Object Storage and bucket based on your authorization that is created in step 3.

f. Select your qcow2 image (your custom image).

g. Select the CentOS for Operating system.

h. Click Import custom image.

Zoom

![Figure showing example of custom image imported.](https://cloud.ibm.com/docs-content/v1/content/b6066ebcc4ff31f2a8b558531f2ee791d108a7e1/cloud-pak-multicloud-management/images/select_qcow2_image_v2.png)

Figure 9. Example of custom image imported

Zoom

![Figure showing example of custom image listing after successful image creation.](https://cloud.ibm.com/docs-content/v1/content/b6066ebcc4ff31f2a8b558531f2ee791d108a7e1/cloud-pak-multicloud-management/images/results_vpc_images.png)

Figure 10. Example of custom image listing after successful image creation
7. Create a virtual server from the custom image by clicking the "three dot menu" of that image, then selecting "New virtual server".

Zoom

![Figure showing select three dot menu for New virtual server.](https://cloud.ibm.com/docs-content/v1/content/b6066ebcc4ff31f2a8b558531f2ee791d108a7e1/cloud-pak-multicloud-management/images/select_new_server.png)

Figure 11.
IBM Cloudant allows materialized MapReduce views to be created on a database - a secondary index structure that contains user-defined keys and values. MapReduce views exist and are queried in the same path as the primary database.

With the "dbcopy" feature configured, the MapReduce data is instead written to a second database. The second database then contains the key/value pairs that would usually be found in the materialized view of a normal MapReduce view. The dbcopy feature was used to allow view data to be "chained" (for example, the creation of views of views) or to provide a primitive join functionality between documents.





 What happens after the feature is removed? 

The primary database continues to function as normal, but any MapReduce indexes with dbcopy configured no longer write data to the secondary database. The secondary database still exists, but it cannot be updated when the primary data changes.





 How do I know whether my MapReduce views use dbcopy? 

MapReduce index definitions are stored in a database's [design documents](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-design-documents). These MapReduce index definitions contain JavaScript that programmatically decides what data from the document makes it into the view, as shown in the following example:

{
"_id": "_design/myview",
"views": {
"view": {
"map": "function(doc) { emit(doc.date, doc.price) }",
"dbcopy": "another_database"
}
}
}

If a view definition contains an attribute that is called dbcopy, as is the case with the previous example design document, then the dbcopy feature is in use and is affected by the feature's removal.





 Alternatives to dbcopy 

No alternative to the dbcopy feature exists. Simply removing the "dbcopy" attribute from a design document instructs IBM Cloudant to build a normal MapReduce view. This view contains the same data that was being copied to the secondary database, for example:

{
When you have an image available in IBM Cloud Object Storage, you can import it to IBM Cloud VPC infrastructure by using the application programming interface (API).

To import a custom image by using the API, use [Create an image](https://cloud.ibm.com/apidocs/vpc/latestcreate-image).

Specify the file.href subproperty with the location of the image. Specify the operating_system.name subproperty with the name of the image operating system.

The following example imports a custom image with the name of my-image, source location of cos://us-south/my-bucket/my-image.qcow2, and the operating system for the image is debian-9-amd64.

curl -X POST "$vpc_api_endpoint/v1/images?version=2023-02-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
"name": "my-image",
"file": {
"href": "cos://us-south/my-bucket/my-image.qcow2"
},
"operating_system": {
"name": "debian-9-amd64"
}
}'



 Schedule custom image lifecycle status changes by using the API 

When you import a custom image by using the application programming interface (API), you can also schedule the lifecycle status changes of an IBM Cloud VPC custom image at the same time by using the [Create an image](https://cloud.ibm.com/apidocs/vpc/latestcreate-image) command.

The name can't be used by another image in the region and names that start with ibm- are reserved for system-provided images. Specify the file.href subproperty with the location of the image. Specify the operating_system.name subproperty with the name of the image operating system.
If not using the pre-built container image and if [using a private container registry additional steps might be needed](https://cloud.ibm.com/docs/codeengine?topic=codeengine-deploy-app-private). You can find the source at [https://github.com/IBM-Cloud/serverless-guestbook/tree/ce](https://github.com/IBM-Cloud/serverless-guestbook/tree/ce)







 Step 3: Deploy the web app 

Create a Object Storage bucket configured with static website hosting containing the files for the guestbook JavaScript application that uses the IBM Cloudant database.

Create a Object Storage instance:



1. Select [Object Storage](https://cloud.ibm.com/objectstorage/create) from the catalog.
2. Select IBM Cloud for the Infrastructure and Standard for the plan.
3. Enter a unique service name for the instance, such as <yourinitials>-guestbook-cos.
4. Select a resource group.
5. Click Create



Create a bucket configured for static website hosting:



1. Click Create a bucket.
2. Click Customize your bucket.
3. Enter a bucket name that is unique across all IBM accounts. Try <yourinitials>-guestbook.
4. Select resiliency as Regional.
5. Select a Location consistent with the IBM Cloudant instance.
6. Keep the Storage class default
7. Scroll down to the Static website hosting and click Add+.
8. Keep the Routing rules (individual) selected and add the Index document index.html.
9. Click Public access to On
10. Click Save
11. Scroll to the bottom and click Create bucket



Copy the files in the docs directory of [https://github.com/IBM-Cloud/serverless-guestbook/tree/ce](https://github.com/IBM-Cloud/serverless-guestbook/tree/ce) into the bucket:



1.
These backups should be stored in a backup instance of secrets manager in an alterative region and in the backup account as described in [Backup accounts](https://cloud.ibm.com/docs/enterprise-account-architecture?topic=enterprise-account-architecture-bcdraccounts).





 Cloud Object Storage 

Cloud Object Storage buckets can be cross regional, regional, or stored in a single data center. In addition, Cloud Object Storage Buckets can be backed up using [bucket replication](https://cloud.ibm.com/docs/cloud-object-storage?topic=cloud-object-storage-replication-overview). These backups should be stored in a Cloud Object Storage bucket in a alterative region and in the backup account as described in [Backup accounts](https://cloud.ibm.com/docs/enterprise-account-architecture?topic=enterprise-account-architecture-bcdraccounts).





 Cloudant 

Cloudant is a highly available NoSQL DB that can be configured with replicas in multiple regions. In addition, Cloudant backups can be taken by using the [CouchBackup](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-ibm-cloudant-backup-and-recovery) client that uses customer-supplied automation. These backups should be stored in Cloud Object Storage in a alterative region and in the backup account as described in [Backup accounts](https://cloud.ibm.com/docs/enterprise-account-architecture?topic=enterprise-account-architecture-bcdraccounts).





 Event Streams 

Event Streams is a highly available Kafka as a service. Given the nature of eventing systems, point in time backups are likely of little value. However, [mirroring to a second region](https://cloud.ibm.com/docs/EventStreams?topic=EventStreams-mirroring_setup) is recommended for disaster recovery.





 Other services 

For more information on backups, see service-specific documentation.







 Related controls in IBM Cloud Framework for Financial Services
Copy and paste values of the CLOUDANT_HOST, CLOUDANT_USERNAME and CLOUDANT_PASSWORD fields into the .env file and save the changes. The result will be something like:

CLOUDANT_HOST=abc...yz.cloudant.com
CLOUDANT_USERNAME=abc...yz
CLOUDANT_PASSWORD=445d...d1a
4. Run your app locally.

php -S localhost:8000



View your app at: http://localhost:8000. Any names you enter into the app will now get added to the database.

Your local app and the IBM Cloud app are sharing the database. View your IBM Cloud app at the URL listed in the output of the push command from above. Names you add from either app should appear in both when you refresh the browsers.

Remember, if you don't need your app live, stop it so you don't incur any unexpected charges.





 Next steps 



* [Samples](https://ibm-cloud.github.io)
* [Architecture Center](https://www.ibm.com/cloud/architecture/architectures)
(https://cloud.ibm.com/docs-content/v1/content/b6066ebcc4ff31f2a8b558531f2ee791d108a7e1/cloud-pak-multicloud-management/images/import_custom_image.png)

Figure 8. Example import of custom image

e. Select your Cloud Object Storage and bucket based on your authorization that is created in step 3.

f. Select your qcow2 image (custom image).

g. Select the Red Hat Enterprise for Operating system.

h. Click Import custom image.

Zoom

![Figure showing example of custom image imported.](https://cloud.ibm.com/docs-content/v1/content/b6066ebcc4ff31f2a8b558531f2ee791d108a7e1/cloud-pak-multicloud-management/images/select_qcow2_image.png)

Figure 9. Example of custom image imported

Zoom

![Figure showing example of custom image listing after successful image creation.](https://cloud.ibm.com/docs-content/v1/content/b6066ebcc4ff31f2a8b558531f2ee791d108a7e1/cloud-pak-multicloud-management/images/results_vpc_images.png)

Figure 10. Example of custom image listing after successful image creation
7. Create a virtual server from the custom image by clicking the "three dot menu" of that image, then selecting "New virtual server".

Zoom

![Figure showing select three dot menu for New virtual server.](https://cloud.ibm.com/docs-content/v1/content/b6066ebcc4ff31f2a8b558531f2ee791d108a7e1/cloud-pak-multicloud-management/images/select_new_server.png)

Figure 11.
ibmcloud cf apps

You can also go to the IBM Cloud [resource list](https://cloud.ibm.com/resources) to view your app.





 Step 5: Add a database 

Next, we'll add an IBM Cloudant NoSQL database to this app and set up the app so that it can run locally and on IBM Cloud.



1. In your browser, log in to IBM Cloud and go to the Dashboard. Select Create resource.
2. Search for IBM Cloudant, and select the service.
3. For Available authentication methods, select Use both legacy credentials and IAM. You can leave the default settings for the other fields. Click Create to create the service.
4. In the navigation, go to Connections, then click Create connection. Select your app, and click Connect.
5. Using the default values, click Connect & restage app to connect the database to your app. Click Restage when prompted.

IBM Cloud will restart your app and provide the database credentials to your app using the VCAP_SERVICES environment variable. This environment variable is available to the app only when it is running on IBM Cloud.



Environment variables enable you to separate deployment settings from your source code. For example, instead of specifying a database password in your source code, you can store it in an environment variable that you reference in your source code.





 Step 6: Use the database 

We're now going to update your local code to point to this database. Create a JSON file that will store the credentials for the services the app will use. This file will get used ONLY when the app is running locally. When running in IBM Cloud, the credentials will be read from the VCAP_SERVICES environment variable.

Create a file called my-cloudant-credentials.json in the config directory with the following content (as reference, see config/my-cloudant-credentials.json.example):

{
"password": "<password>",
"url": "<url>",
"username": "<username>"
}
You can choose Creating new image or Update Existing Image (Need to be the owner of this image.).



* If you create new image, the new image will be independent from the old one. You can configure image for different name, description, memory size, and etc. You can also assign the new image to different user group to use.
* If you update the image, the image will be considered as different version of current image. The image will have the same image name, configurations, description and etc. Usually any image can have multiple versions, but only one version can be in production. Normal users (the users do not have create image privilege) can only use the version in production, therefore admin can easily control which version common users can use.





![create1](https://cloud.ibm.com/docs-content/v1/content/b6c5dbb443b797203b2824b05472cac5ae8635da/cloud-for-education/images/createUpdate2.png)

- If you want to create new image, you need to fill out following information, then click Create Image, the creating process will start. Click Advanced Options if you need to change default configurations for the number of CPU cores, memory size, maximum concurrent usage, and etc.

![create2](https://cloud.ibm.com/docs-content/v1/content/b6c5dbb443b797203b2824b05472cac5ae8635da/cloud-for-education/images/create1.png)

- If you choose to update the image, you need to fill the comment for this version, then click Submit.

![create2](https://cloud.ibm.com/docs-content/v1/content/b6c5dbb443b797203b2824b05472cac5ae8635da/cloud-for-education/images/create2.png)
This file will get used ONLY when the app is running locally. When running in IBM Cloud, the credentials will be read from the VCAP_SERVICES environment variable.



1. Create a file called .env in the get-started-go directory with the following content:

CLOUDANT_URL=
2. Find your app in the IBM Cloud [resource list](https://cloud.ibm.com/resources). On the Service Details page for your app, click Connections in the sidebar. Click the IBM Cloudant menu icon (…) and select View credentials.
3. Copy and paste just the url from the credentials to the CLOUDANT_URL field of the .env file and save the changes. The result will be something like:

CLOUDANT_URL=https://123456789 ... bluemix.cloudant.com
4. Run your app locally.

go run main.go
5. View your app at: http://localhost:8080. Any names that you enter into the app are added to the database.



Your local app and the IBM Cloud app share the database. View your IBM Cloud app at the URL listed in the output of the push command. Names you add from either app show in both apps when you refresh the browsers.

If you don't need your app live, stop it so you don't incur any unexpected charges.





 Next steps 



* [Samples](https://ibm-cloud.github.io)
* [Architecture Center](https://www.ibm.com/cloud/architecture/architectures)
[Import and validate](https://cloud.ibm.com/docs/vpc?topic=vpc-importing-custom-images-vpc&interface=ui) your custom image in your VPC. Do this for each region in which you want your software to be available and verify that the SHA or checksum matches for the imported image in each region.



3. Make sure you're assigned the IBM Cloud Identity and Access Management (IAM) editor role or higher on the catalog management service. See [Assigning access to account management services](https://cloud.ibm.com/docs/account?topic=account-account-services) for more information.







 Step 1: Create a private catalog 



1. In the IBM Cloud console, go to Manage > Catalogs, and click Create a catalog.
2. Select Product default as the catalog type.
3. Enter the name of your catalog, for example, Sample virtual server image.
4. Select No products to exclude all products in the IBM Cloud® catalog from your catalog.
5. Click Create.







 Step 2: Import the virtual server image to your private catalog 



1. From the Private products page, click Add.
2. Select Virtual server image for VPC as the deployment method.
3. Select Software as the kind of product that you're adding.
4. Select the image you'd like to onboard.

If the virtual server image you want to add is not included in the list of available images, click Import a new image to import it. Your image must be imported into IBM Cloud VPC, in an available status, with an x86 architecture in order for you to onboard it to a private catalog. Also, your image can't be used with a bare metal profile or instance groups, or encrypted. An image can only be added to one product within one private catalog at a time. If the image you want to import is already imported into another product, you must remove the image from that product or delete the product before you add the image to a new product.
5. Enter the software version, for example, 1.0.0.
Cloudant service = Cloudant.newInstance();

DeleteDocumentOptions documentOptions =
new DeleteDocumentOptions.Builder()
.db("events")
.docId("0007241142412418284")
.rev("2-9a0d1cd9f40472509e9aac6461837367")
.build();

DocumentResult response =
service.deleteDocument(documentOptions).execute()
.getResult();

System.out.println(response);

from ibmcloudant.cloudant_v1 import CloudantV1

service = CloudantV1.new_instance()

response = service.delete_document(
db='events',
doc_id='0007241142412418284',
rev='2-9a0d1cd9f40472509e9aac6461837367'
).get_result()

print(response)

deleteDocumentOptions := service.NewDeleteDocumentOptions(
"events",
"0007241142412418284",
)
deleteDocumentOptions.SetRev("2-9a0d1cd9f40472509e9aac6461837367")

documentResult, response, err := service.DeleteDocument(deleteDocumentOptions)
if err != nil {
panic(err)
}

b, _ := json.MarshalIndent(documentResult, "", " ")
fmt.Println(string(b))

const { CloudantV1 } = require('@ibm-cloud/cloudant');
const service = CloudantV1.newInstance({});

service.deleteDocument({
db: 'events',
docId: '0007241142412418284',
](https://cloud.ibm.com/docs-content/v1/content/Cloudant//images/authentication.png)<br><br>Authentication](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-learning-centerauthentication-video)[![carousel thumbnail](https://cloud.ibm.com/docs-content/v1/content/Cloudant//images/dashboard.png)<br><br>Cloudant Dashboard](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-learning-centerthe-dashboard-video)[![carousel thumbnail](https://cloud.ibm.com/docs-content/v1/content/Cloudant//images/basics.png)<br><br>HTTP API Basics](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-learning-centerhttp-api-basics-video)[![carousel thumbnail](https://cloud.ibm.com/docs-content/v1/content/Cloudant//images/bulk-api.png)<br><br>The Bulk API](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-learning-centerthe-bulk-api-video)[![carousel thumbnail](https://cloud.ibm.com/docs-content/v1/content/Cloudant//images/programmatically.png)
[image1](https://cloud.ibm.com/docs-content/v1/content/b6c5dbb443b797203b2824b05472cac5ae8635da/cloud-for-education/images/imageGroup.png)



1. Choose Image as Type, and input the name you like.



![image2](https://cloud.ibm.com/docs-content/v1/content/b6c5dbb443b797203b2824b05472cac5ae8635da/cloud-for-education/images/imageType.png)



1. Use the same way in [Adding Image to Image Pool](https://cloud.ibm.com/docs/cloud-for-education?topic=cloud-for-education-creating-updating-images) to add target images to your new image group.
2. Send your user group name and image group name to [cldedu@us.ibm.com](mailto:cldedu@us.ibm.com). We will assign proper resource mapping.