Skip to content

Commit 042aaa3

Browse files
committed
Merge remote-tracking branch 'upstream/main'
2 parents 1a39677 + b675001 commit 042aaa3

251 files changed

Lines changed: 7928 additions & 33 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

README.md

Lines changed: 14 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,25 @@
1-
*This repository acts as a template for all of Oracle’s GitHub repositories. It contains information about the guidelines for those repositories. All files and sections contained in this template are mandatory, and a GitHub app ensures alignment with these guidelines. To get started with a new repository, replace the italic paragraphs with the respective text for your project.*
1+
# Welcome
22

3-
# Project name
3+
[![](https://oracle-livelabs.github.io/common/images/livelabs-banner-formarketplace.png)](https://livelabs.oracle.com)
4+
---
5+
LiveLabs is the place to explore Oracle's products and services using workshops designed to enhance your experience building and deploying applications on the Cloud and On-Premises. Our library of workshops cover everything from how to provision the world's first autonomous database to setting up a webserver on OCI, machine learning and much more. Use your existing Oracle Cloud account, a Free Tier account, or a LiveLabs Sandbox Reservation to build, test, and deploy applications on Oracle's Cloud.
46

5-
*Describe your project's features, functionality and target audience*
7+
### How do I get started?
8+
Visit [LiveLabs](https://livelabs.oracle.com) now to get started. Workshops are added weekly, please visit frequently for new content.
69

7-
## Installation
10+
[![](https://oracle-livelabs.github.io/common/images/livelabs-new-skin.png)](https://livelabs.oracle.com)
811

9-
*Provide detailed step-by-step installation instructions. You can name this section **How to Run** or **Getting Started** instead of **Installation** if that's more acceptable for your project*
1012

11-
## Documentation
12-
13-
*Developer-oriented documentation can be published on GitHub, but all product documentation must be published on <https://docs.oracle.com>*
14-
15-
## Examples
16-
17-
*Describe any included examples or provide a link to a demo/tutorial*
18-
19-
## Help
20-
21-
*Inform users on where to get help or how to receive official support from Oracle (if applicable)*
2213

2314
## Contributing
24-
25-
*If your project has specific contribution requirements, update the CONTRIBUTING.md file to ensure those requirements are clearly explained*
26-
27-
This project welcomes contributions from the community. Before submitting a pull request, please [review our contribution guide](./CONTRIBUTING.md)
28-
29-
## Security
30-
31-
Please consult the [security guide](./SECURITY.md) for our responsible security vulnerability disclosure process
15+
Pull requests are currently not being accepted. See [CONTRIBUTING](CONTRIBUTING.md) for details.
3216

3317
## License
18+
Copyright (c) 2014, 2025 Oracle and/or its affiliates
19+
The Universal Permissive License (UPL), Version 1.0
20+
See [LICENSE](LICENSE.txt) for details.
3421

35-
*The correct copyright notice format for both documentation and software is*
36-
"Copyright (c) [year,] year Oracle and/or its affiliates."
37-
*You must include the year the content was first released (on any platform) and the most recent year in which it was revised*
38-
39-
Copyright (c) 2023 Oracle and/or its affiliates.
40-
41-
*Replace this statement if your project is not licensed under the UPL*
22+
## Need Help?
23+
Please first consult the "Need Help?" lab located at the bottom of your workshop to see if our FAQ can solve your problem. If you have an issue that is specific to the contents of the workshop, please reach out to the author located in the "Acknowledgements" section at the bottom of each lab via email. Please include your workshop name and lab name. You can also include screenshots and attach files. If you have a more general issue or comment, please [reach out to the LiveLabs team](mailto:livelabs-help_us@oracle.com).
4224

43-
Released under the Universal Permissive License v1.0 as shown at
44-
<https://oss.oracle.com/licenses/upl/>.
25+
For workshop reservations you will need to [create an Oracle account](https://profile.oracle.com/myprofile/account/create-account.jspx).

agent_workflow_on_oke/workshops/desktop/index.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@
1414

1515
<link rel="stylesheet" href="https://oracle-livelabs.github.io/common/redwood-hol/css/style.min.css" />
1616
<link rel="shortcut icon" href="https://oracle-livelabs.github.io/common/redwood-hol/img/favicon.ico" />
17+
1718
</head>
1819

1920
<body>

agent_workflow_on_oke/workshops/sandbox/index.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@
1414

1515
<link rel="stylesheet" href="https://oracle-livelabs.github.io/common/redwood-hol/css/style.min.css" />
1616
<link rel="shortcut icon" href="https://oracle-livelabs.github.io/common/redwood-hol/img/favicon.ico" />
17+
1718
</head>
1819

1920
<body>

agent_workflow_on_oke/workshops/tenancy/index.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@
1414

1515
<link rel="stylesheet" href="https://oracle-livelabs.github.io/common/redwood-hol/css/style.min.css" />
1616
<link rel="shortcut icon" href="https://oracle-livelabs.github.io/common/redwood-hol/img/favicon.ico" />
17+
1718
</head>
1819

1920
<body>

aistore/aistore_cli/aistore_cli.md

Lines changed: 137 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,137 @@
1+
# AIStore CLI
2+
3+
## Introduction
4+
5+
This lab will demonstrate how to use a deployed AIStore cluster into OCI environment using AIS CLI commands.
6+
7+
Estimated Workshop Time: 30 min
8+
9+
### Objectives
10+
11+
This lab will guide you through how to:
12+
- use AIStore to list buckets in OCI
13+
- use AIS CLI to copy from OCI to AIS and delete from AIS
14+
15+
### Prerequisites
16+
17+
This lab assumes you have:
18+
19+
* Lab 1. Provision of OCI infrastructure completed
20+
21+
## Task 1: SSH into VM Instance
22+
Go in OCI console under Compute -> Instances and take the public ip of the instance and username to ssh into it.
23+
![SSH VM Instance](images/ssh_to_vm.png)
24+
25+
## Task 2: Verify cloudinit has finished and all required tools are installed
26+
Use the following command to see the cloudinit has finished:
27+
```
28+
<copy>
29+
tail -f -n 100 /var/log/cloud-init-output.log
30+
</copy>
31+
```
32+
If you see something like in the screenshot bellow it means the cloudinit execution has finished:
33+
![Cloud Init Screenshot](images/cloudinit.png)
34+
35+
Use the following command to see the docker is installed and the ais cluster docker is running:
36+
```
37+
<copy>
38+
sudo docker ps -a
39+
</copy>
40+
```
41+
42+
![Docker ps output](images/docker_ps.png)
43+
44+
Use the following commands to see ais cli is installed:
45+
```
46+
<copy>
47+
ais --version
48+
</copy>
49+
```
50+
51+
![AIS version output](images/ais_version.png)
52+
53+
If the docker is up and running and ais cli is installed, use the following command to set the ais cluster endpoint:
54+
```
55+
<copy>
56+
ais config cli set cluster.url=http://localhost:51080
57+
</copy>
58+
```
59+
60+
## Task 3: List buckets associated with AIS cluster
61+
Once we are all set, we can use ais cli to interact with the AIS cluster deployed in the docker container.
62+
We will run the following command to see the bucket that we created within the automation is available in the AIS cluster:
63+
```
64+
<copy>
65+
ais ls --all
66+
</copy>
67+
```
68+
69+
![AIS ls all output](images/ais_ls_all.png)
70+
71+
## Task 4: Create AIS buckets and copy object from OCI bucket into AIS bucket
72+
73+
First lets add a file tls.tf into mybucket in OCI console:
74+
```
75+
<copy>
76+
# tls.tf
77+
# Copyright (c) 2024 Oracle Corporation and/or its affiliates.
78+
# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl
79+
80+
locals {
81+
user_public_ssh_key = chomp(var.ssh_public_key)
82+
bundled_ssh_public_keys = "${local.user_public_ssh_key}\n${chomp(tls_private_key.stack_key.public_key_openssh)}"
83+
}
84+
85+
resource "tls_private_key" "stack_key" {
86+
algorithm = "RSA"
87+
rsa_bits = 4096
88+
}
89+
</copy>
90+
```
91+
![Object upload OCI console](images/object_upload.png)
92+
93+
Then lets create AIS bucket:
94+
```
95+
<copy>
96+
ais create ais://localbucket1 ais://localbucket2
97+
98+
</copy>
99+
```
100+
101+
![AIS create output](images/ais_create.png)
102+
103+
104+
Once we have AIS buckets created, lets copy objects from OCI object storage to AIS buckets:
105+
```
106+
<copy>
107+
wget https://<bucket_namespace>.compat.objectstorage.eu-frankfurt-1.oraclecloud.com/mybucket/tls.tf
108+
ais put tls.tf ais://localbucket1
109+
ais ls ais://localbucket1
110+
</copy>
111+
```
112+
![AIS put output](images/ais_put.png)
113+
114+
## Task 5: Delete AIS bucket
115+
116+
We will cleanup the AIS buckets from the cluster with the following commands:
117+
```
118+
<copy>
119+
ais bucket rm ais://localbucket1
120+
ais bucket rm ais://localbucket2
121+
</copy>
122+
```
123+
![AIS rm output](images/ais_rm.png)
124+
125+
126+
127+
## Learn More
128+
129+
* [What is cohort?](https://kueue.sigs.k8s.io/docs/concepts/cluster_queue/#cohort)
130+
131+
132+
## Acknowledgements
133+
134+
**Authors**
135+
136+
* **Cristian Vlad**, Principal Cloud Architect, NACIE
137+
* **Last Updated By/Date** - Cristian Vlad, December 2024
Lines changed: 101 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,101 @@
1+
/* NOTE: Files cannot contain empty lines (line breaks) */
2+
/* Specify the base URL that you copied from your files in OCI Object Storage in the define base_URL line below*/
3+
/* change idthydc0kinr to your real namespace. The name is case-sensitive. */
4+
/* change ADWCLab to your real bucket name. The name is case-sensitive. */
5+
/* change us-phoenix-1 to your real region name. The name is case-sensitive. */
6+
/* you can find these values on the OCI Console .. Storage .. Object Storage screen */
7+
set define on
8+
define base_URL='https://objectstorage.us-phoenix-1.oraclecloud.com/n/idthydc0kinr/b/ADWCLab/o'
9+
/* copy Channels table */
10+
begin
11+
dbms_cloud.copy_data(
12+
table_name =>'CHANNELS',
13+
credential_name =>'OBJ_STORE_CRED',
14+
file_uri_list =>'&base_URL/chan_v3.dat',
15+
format => json_object('ignoremissingcolumns' value 'true', 'removequotes' value 'true')
16+
);
17+
end;
18+
/
19+
/* copy Countries table */
20+
begin
21+
dbms_cloud.copy_data(
22+
table_name =>'COUNTRIES',
23+
credential_name =>'OBJ_STORE_CRED',
24+
file_uri_list =>'&base_URL/coun_v3.dat',
25+
format => json_object('ignoremissingcolumns' value 'true', 'removequotes' value 'true')
26+
);
27+
end;
28+
/
29+
/* Copy customers */
30+
begin
31+
dbms_cloud.copy_data(
32+
table_name =>'CUSTOMERS',
33+
credential_name =>'OBJ_STORE_CRED',
34+
file_uri_list =>'&base_URL/cust1v3.dat',
35+
format => json_object('ignoremissingcolumns' value 'true', 'removequotes' value 'true', 'dateformat' value 'YYYY-MM-DD-HH24-MI-SS')
36+
);
37+
end;
38+
/
39+
begin
40+
dbms_cloud.copy_data(
41+
table_name =>'SUPPLEMENTARY_DEMOGRAPHICS',
42+
credential_name =>'OBJ_STORE_CRED',
43+
file_uri_list =>'&base_URL/dem1v3.dat',
44+
format => json_object('ignoremissingcolumns' value 'true', 'removequotes' value 'true')
45+
);
46+
end;
47+
/
48+
begin
49+
dbms_cloud.copy_data(
50+
table_name =>'SALES',
51+
credential_name =>'OBJ_STORE_CRED',
52+
file_uri_list =>'&base_URL/dmsal_v3.dat',
53+
format => json_object('ignoremissingcolumns' value 'true', 'removequotes' value 'true', 'dateformat' value 'YYYY-MM-DD')
54+
);
55+
end;
56+
/
57+
begin
58+
dbms_cloud.copy_data(
59+
table_name =>'PRODUCTS',
60+
credential_name =>'OBJ_STORE_CRED',
61+
file_uri_list =>'&base_URL/prod1v3.dat',
62+
format => json_object('delimiter' value '|', 'quote' value '^', 'ignoremissingcolumns' value 'true', 'dateformat' value 'YYYY-MM-DD-HH24-MI-SS', 'blankasnull' value 'true')
63+
);
64+
end;
65+
/
66+
begin
67+
dbms_cloud.copy_data(
68+
table_name =>'PROMOTIONS',
69+
credential_name =>'OBJ_STORE_CRED',
70+
file_uri_list =>'&base_URL/prom1v3.dat',
71+
format => json_object('ignoremissingcolumns' value 'true', 'removequotes' value 'true', 'dateformat' value 'YYYY-MM-DD-HH24-MI-SS', 'blankasnull' value 'true')
72+
);
73+
end;
74+
/
75+
begin
76+
dbms_cloud.copy_data(
77+
table_name =>'SALES',
78+
credential_name =>'OBJ_STORE_CRED',
79+
file_uri_list =>'&base_URL/sale1v3.dat',
80+
format => json_object('ignoremissingcolumns' value 'true', 'removequotes' value 'true', 'dateformat' value 'YYYY-MM-DD', 'blankasnull' value 'true')
81+
);
82+
end;
83+
/
84+
begin
85+
dbms_cloud.copy_data(
86+
table_name =>'TIMES',
87+
credential_name =>'OBJ_STORE_CRED',
88+
file_uri_list =>'&base_URL/time_v3.dat',
89+
format => json_object('ignoremissingcolumns' value 'true', 'removequotes' value 'true', 'dateformat' value 'YYYY-MM-DD-HH24-MI-SS', 'blankasnull' value 'true')
90+
);
91+
end;
92+
/
93+
begin
94+
dbms_cloud.copy_data(
95+
table_name =>'COSTS',
96+
credential_name =>'OBJ_STORE_CRED',
97+
file_uri_list =>'&base_URL/costs.dat',
98+
format => json_object('ignoremissingcolumns' value 'true', 'dateformat' value 'YYYY-MM-DD', 'blankasnull' value 'true')
99+
);
100+
end;
101+
/
12.4 KB
Loading
3.8 KB
Loading
30.9 KB
Loading
29.1 KB
Loading

0 commit comments

Comments
 (0)