Remarques :

Ce tutoriel est disponible dans un environnement d'atelier gratuit fourni par Oracle.
Il utilise des exemples de valeurs pour les informations d'identification, la location et les compartiments Oracle Cloud Infrastructure. Lorsque vous terminez votre atelier, remplacez ces valeurs par celles propres à votre environnement cloud.

Créer un environnement Oracle Cloud Native Environment à partir de la source

Introduction

L'interface de ligne de commande d'Oracle Cloud Native Environment (Oracle CNE) gère le cycle de vie du cluster Kubernetes dans votre organisation. Il s'agit également d'un projet Open Source disponible sur GitHub. Ce tutoriel explique comment créer vous-même l'exécutable ocne.

Pour plus d'informations sur Oracle Cloud Native Environment 2, reportez-vous au site de la documentation sur les versions en cours.

Objectifs

Dans ce tutoriel, vous allez apprendre à :

Configurer l'environnement de build
Créez l'exécutable ocne.
Démarrer un cluster Kubernetes avec l'exécutable obtenu

Prérequis

Minimum d'une instance Oracle Linux
Oracle Linux doit être installé et configuré sur chaque système avec :
- Compte utilisateur Oracle (utilisé pendant l'installation) avec accès sudo
- SSH basé sur une clé, également appelé SSH sans mot de passe, entre les hôtes
- Environnement libvirt KVM fonctionnel.

Configurer Oracle Cloud Native Environment

Remarque : en cas d'exécution dans votre propre location, lisez le projet linux-virt-labs GitHub README.md et respectez les prérequis avant de déployer l'environnement d'atelier.

Ouvrez un terminal sur le bureau Luna.

Clonez le projet linux-virt-labs GitHub.

git clone https://github.com/oracle-devrel/linux-virt-labs.git

Accédez au répertoire de travail.
```
cd linux-virt-labs/ocne2
```

Installez les collections requises.

ansible-galaxy collection install -r requirements.yml

Déployez l'environnement d'exercice.
```
ansible-playbook create_instance.yml -e localhost_python_interpreter="/usr/bin/python3.6" -e ocne_type=libvirt
```
L'environnement d'exercice gratuit nécessite la variable supplémentaire local_python_interpreter, qui définit ansible_python_interpreter pour les lectures exécutées sur localhost. Cette variable est nécessaire car l'environnement installe le package RPM pour le kit SDK Oracle Cloud Infrastructure pour Python, situé sous les modules python3.6.

La forme de déploiement par défaut utilise la CPU AMD et Oracle Linux 8. Pour utiliser une CPU Intel ou Oracle Linux 9, ajoutez -e instance_shape="VM.Standard3.Flex" ou -e os_version="9" à la commande de déploiement.

Important : attendez que le playbook s'exécute correctement et atteignez la tâche de pause. A ce stade du manuel, l'installation d'Oracle Cloud Native Environment est terminée et les instances sont prêtes. Notez la lecture précédente, qui imprime les adresses IP publiques et privées des noeuds qu'elle déploie, ainsi que toute autre information de déploiement nécessaire lors de l'exécution de l'exercice.

Installation des prérequis

Ouvrez un terminal et connectez-vous via SSH à l'instance ocne.
```
ssh oracle@<ip_address_of_instance>
```
Installation de Git.
```
sudo dnf install git -y
```

Cloner le référentiel CNE Oracle.

git clone https://github.com/oracle-cne/ocne.git

Accédez au répertoire de travail.
```
cd ocne
```

Répertoriez les packages Oracle Cloud Native Environment disponibles.

sudo dnf search ocne

Exemple de sortie :

[oracle@ocne ~]$ sudo dnf search ocne
Last metadata expiration check: 0:01:00 ago on Fri 28 Mar 2025 11:48:50 AM GMT.
========================================================== Name Matched: ocne ===========================================================
oracle-ocne-release-el8.src : Oracle Cloud Native Environment yum repository configuration
oracle-ocne-release-el8.x86_64 : Oracle Cloud Native Environment yum repository configuration

Installez le package de référentiel.

Oracle Linux 8

sudo dnf install -y oracle-ocne-release-el8

Oracle Linux 9

sudo dnf install -y oracle-ocne-release-el9

Activez le référentiel.

Oracle Linux 8

sudo dnf config-manager --enable ol8_ocne

Oracle Linux 9

sudo dnf config-manager --enable ol9_ocne
sudo dnf config-manager --enable ol9_olcne19

Activez le référentiel Codeready.

Le référentiel CodeReady fournit de nombreux packages et outils permettant aux développeurs de créer et de packager des applications.

Oracle Linux 8
```
sudo dnf config-manager --enable ol8_codeready_builder
```
Oracle Linux 9
```
sudo dnf config-manager --enable ol9_codeready_builder
```
Vérifiez que les référentiels sont activés.
```
sudo dnf repolist
```
Mettez à jour l'exigence Helm pour Oracle Linux 9.

Oracle Linux 8

Facultatif.

Oracle Linux 9
```
sed -i 's/3.13.0/3.12.0/' buildrpm/ocne.spec
```

Installez les prérequis.

sudo yum-builddep buildrpm/ocne.spec -y

Exemple de sortie :

[oracle@ocne ocne]$ sudo yum-builddep buildrpm/ocne.spec 
Oracle Linux 8 BaseOS Latest (x86_64)                                                                    317 kB/s | 4.3 kB     00:00    
Oracle Linux 8 Application Stream (x86_64)                                                                69 kB/s | 4.5 kB     00:00    
Oracle Linux 8 CodeReady Builder (x86_64) - Unsupported                                                   39 MB/s |  12 MB     00:00    
Oracle Linux 8 Addons (x86_64)                                                                           184 kB/s | 3.5 kB     00:00    
Oracle Cloud Native Environment version 2.0 (x86_64)                                                      30 MB/s | 6.1 MB     00:00    
Dependencies resolved.
=========================================================================================================================================
 Package                           Architecture    Version                                          Repository                      Size
=========================================================================================================================================
Installing:
 btrfs-progs-devel                 x86_64          5.15.1-2.el8                                     ol8_UEKR7                       49 k
 device-mapper-devel               x86_64          8:1.02.181-15.0.1.el8_10                         ol8_codeready_builder          284 k
 golang                            x86_64          1.22.9-1.module+el8.10.0+90476+bb48cc15          ol8_appstream                  759 k
 gpgme-devel                       x86_64          1.13.1-12.el8                                    ol8_codeready_builder          166 k
 helm                              x86_64          3.17.1-2.el8                                     ol8_ocne                        12 M
 libassuan-devel                   x86_64          2.5.1-3.el8                                      ol8_codeready_builder           69 k
 rpm-build                         x86_64          4.14.3-32.0.1.el8_10                             ol8_appstream                  174 k
 yq                                x86_64          4.45.1-1.el8                                     ol8_ocne                       3.4 M
Upgrading:
 btrfs-progs                       x86_64          5.15.1-2.el8                                     ol8_UEKR7                      864 k
...
...
  python3-rpm-macros-3-45.el8.noarch                                  qt5-srpm-macros-5.15.3-1.el8.noarch                                
  redhat-rpm-config-131-1.0.1.el8.noarch                              rpm-build-4.14.3-32.0.1.el8_10.x86_64                              
  rust-srpm-macros-5-2.el8.noarch                                     systemd-devel-239-82.0.3.el8_10.3.x86_64                           
  yq-4.45.1-1.el8.x86_64                                              zstd-1.4.4-1.0.1.el8.x86_64   

Créer l'exécutable

Vérifiez les options disponibles.

make

Exemple de sortie :

[oracle@ocne ocne]$ make

Usage:
  make <target>
  help                       Display this help.
  build-cli                  Build CLI for the current system and architecture
  cli                        Build and install the CLI
  clean                      Delete output from prior builds

Linting and coverage
  check                      Run all linters
  check-golangci-lint        Run Go linters
  install-golangci-lint      Install golangci-lint
  word-linter                Check for use of 'bad' words

Créez l'exécutable.

make build-cli

Exemple de sortie :

[oracle@ocne ocne]$ make cli
...
...
cd repo && helm repo index .
make[1]: Leaving directory '/home/oracle/ocne/build/catalog'
mkdir -p pkg/catalog/embedded/charts
cp build/catalog/repo/* pkg/catalog/embedded/charts
mkdir -p out/linux_amd64
GOTOOLCHAIN=local GO111MODULE=on GOPRIVATE=github.com/oracle-cne/ocne go build -trimpath -ldflags "-X 'github.com/oracle-cne/ocne/cmd/info.gitCommit=1101a5b5fb72e9812aa14cf68613d28440f1bc57' -X 'github.com/oracle-cne/ocne/cmd/info.buildDate=2025-04-02T09:54:53Z' -X 'github.com/oracle-cne/ocne/cmd/info.cliVersion=2.1.2-3.el8'" -tags developer -o out/linux_amd64 ./...

Vérifiez que l'exécutable est présent.

ls -al out/linux_amd64/

Exemple de sortie :

[oracle@ocne ocne]$ ls -al out/linux_amd64/
total 194744
drwxrwxr-x. 2 oracle oracle        18 Mar 28 12:35 .
drwxrwxr-x. 3 oracle oracle        25 Mar 28 12:30 ..
-rwxrwxr-x. 1 oracle oracle 199415168 Mar 28 12:35 ocne

Vérifiez que cela fonctionne.

out/linux_amd64/ocne info

Exemple de sortie :

[oracle@ocne ocne]$ out/linux_amd64/ocne info
CLI Info
Name     	Value                                   
Version  	2.1.2-3.el8                             
BuildDate	2025-04-02T09:54:53Z                    
GitCommit	1101a5b5fb72e9812aa14cf68613d28440f1bc57

Environment Variables
Name         	Description                                       	Current Value
OCNE_DEFAULTS	Sets the location of the default configuration    	             
             	file.                                             	             
KUBECONFIG   	Sets the location of the kubeconfig file. This    	             
             	behaves the same way as the --kubeconfig option   	             
             	for most ocne commands.                           	             
EDITOR       	Sets the default document editor.

Notez les valeurs Version et BuildDate. La version reflète la dernière version dans Principal, et BuildDate reflète la date et l'heure de création de l'exécutable ocne.

Créer un cluster à un seul noeud

Créez un cluster Oracle Cloud Native Environment à noeud unique.

out/linux_amd64/ocne cluster start

En fonction des ressources disponibles sur votre ordinateur, la création du cluster peut prendre plusieurs minutes pendant le téléchargement de la source d'image et sa configuration.

Une fois terminé, entrez y pour terminer l'installation et revenir à l'invite de commande. Ignorez les autres étapes post-installation et passez à l'étape suivante.

Exemple de sortie :

Run the following command to create an authentication token to access the UI:
    KUBECONFIG='/home/oracle/.kube/kubeconfig.ocne.local' kubectl create token ui -n ocne-system
Browser window opened, enter 'y' when ready to exit: y

INFO[2025-03-28T13:10:04Z] Post install information:

To access the cluster from the VM host:
    copy /home/oracle/.kube/kubeconfig.ocne.vm to that host and run kubectl there
To access the cluster from this system:
    use /home/oracle/.kube/kubeconfig.ocne.local
To access the UI, first do kubectl port-forward to allow the browser to access the UI.
Run the following command, then access the UI from the browser using via https://localhost:8443
    kubectl port-forward -n ocne-system service/ui 8443:443
Run the following command to create an authentication token to access the UI:
    kubectl create token ui -n ocne-system

Installez l'outil de ligne de commande Kubernetes (kubectl)
```
sudo dnf install -y kubectl
```
Configurez kubectl pour qu'il utilise le cluster nouvellement créé.
```
export KUBECONFIG=$HOME/.kube/kubeconfig.ocne.local
```

Vérifiez que le cluster se compose d'un seul noeud.

kubectl get nodes --all-namespaces

Exemple de sortie :

[oracle@ocne ~]$ kubectl get nodes --all-namespaces
NAME                   STATUS   ROLES           AGE     VERSION
ocne-control-plane-1   Ready    control-plane   2m23s   v1.31.6+1.el8

Vérifiez que le déploiement du cluster a réussi.

kubectl get deployments --all-namespaces

Exemple de sortie :

[oracle@ocne ~]$ kubectl get deployments --all-namespaces
NAMESPACE     NAME           READY   UP-TO-DATE   AVAILABLE   AGE
kube-system   coredns        2/2     2            2           15m
ocne-system   ocne-catalog   1/1     1            1           15m
ocne-system   ui             1/1     1            1           15m

Répertoriez tous les pods déployés.

kubectl get pods --all-namespaces

Exemple de sortie :

[oracle@ocne ~]$ kubectl get pods --all-namespaces
NAMESPACE      NAME                                           READY   STATUS    RESTARTS      AGE
kube-flannel   kube-flannel-ds-8fbm2                          1/1     Running   0.            13m
kube-system    coredns-f7d444b54-njk46                        1/1     Running   0             13m
kube-system    coredns-f7d444b54-xn975                        1/1     Running   0             13m
kube-system    etcd-ocne-control-plane-1                      1/1     Running   0             13m
kube-system    kube-apiserver-ocne-control-plane-1            1/1     Running   0             13m
kube-system    kube-controller-manager-ocne-control-plane-1   1/1     Running   0             13m
kube-system    kube-proxy-jsfqs                               1/1     Running   0             13m
kube-system    kube-scheduler-ocne-control-plane-1            1/1     Running   0             13m
ocne-system    ocne-catalog-578c959566-75rr5                  1/1     Running   0             13m
ocne-system    ui-84dd57ff69-grxlk                            1/1     Running   0             13m

Cette sortie confirme que vous avez créé ocne à partir du code source et créé un cluster Kubernetes.

Etapes suivantes

Ce tutoriel a montré comment créer l'interface de ligne de commande Oracle CNE à partir du code source sur GitHub, ce qui est utile pour les tests locaux. Cependant, ce n'est que le début. Consultez la station de formation Oracle Linux pour obtenir des tutoriels et du contenu supplémentaires.

Ressources de formation supplémentaires

Explorez d'autres ateliers sur docs.oracle.com/learn ou accédez à d'autres contenus de formation gratuits sur le canal Oracle Learning YouTube. De plus, visitez le site education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour obtenir la documentation produit, consultez le site Oracle Help Center.

Informations relatives au titre et au copyright

Build Oracle Cloud Native Environment from Source

G33045-01

Créer un environnement Oracle Cloud Native Environment à partir de la source

Introduction

Objectifs

Prérequis

Configurer Oracle Cloud Native Environment

Installation des prérequis

Créer l'exécutable

Créer un cluster à un seul noeud

Etapes suivantes

Liens connexes

Ressources de formation supplémentaires