# Openshift

Openshift est une distribution de [[documentation_publique:software:kubernetes]].

OKD / OpenShift origin en est la version community (opensource)

Documentation OKD: https://docs.okd.io/latest/welcome/index.html

## Premiers pas

[[https://docs.openshift.com/container-platform/3.11/architecture/index.html|Architecture d'Openshift]]

[[https://docs.openshift.com/container-platform/3.11/cli_reference/basic_cli_operations.html|Utilisation de la CLI (et liste des types d'objets)]]

## How to learn

Lab + Tuto: https://learn.openshift.com/subsystems/container-internals-lab-2-0-part-1

Cheat Sheet: https://design.jboss.org/redhatdeveloper/marketing/openshift_cheatsheet/cheatsheet/images/openshift_cheat_sheet_r1v1.pdf

## Instructions spécifiques

### Se connecter temporairement à un port sur un pod
Par exemple pour se connecter à une db
```
# First auth
oc login oso-master.uttnetgroup.fr

# pour lister la liste des projets
oc projects

# Selection du projet
oc project etuutt 

# Récupérer la liste des pods du projet
oc get pods

# créer un pont réseau vers le pod sur le port mysql (3306) vers le port 3000 local
oc port-forward mariadb-1-fdcvq 3000:3306

# Se connecter au pod
oc rsh <pod>
```

### Import d'un fichier YAML

Depuis l'interface Web, en haut à droite `Add to project`, puis `Import YAML/JSON`

Depuis un noeud openshift, `oc create -f <filename>`

### Export d'un objet yaml
```
oc export <type>/<object-name>
```

### Gestion des utilisateurs

* https://docs.openshift.com/container-platform/3.9/admin_guide/manage_users.html
* https://docs.openshift.com/container-platform/3.9/install_config/configuring_authentication.html#token-options
* https://docs.openshift.com/container-platform/3.9/install_config/syncing_groups_with_ldap.html#overview

## Troubleshooting

Erreur:
```
Container image "openshift/prometheus-node-exporter:v0.16.0" already present on machine
```

Action: Suppression de l'image sur la machine

Erreur:
```
Failed create pod sandbox: rpc error: code = Unknown desc = NetworkPlugin cni failed to set up pod "front-prod-29-build_ua" network: CNI request failed with status 400: 'failed to run IPAM for d294379a0fa6e41494e7ecd63496ff24a44fde2af7417722de492110f24f3a22: failed to run CNI IPAM ADD: failed to allocate for range 0: no IP addresses available in range set: 10.129.0.1-10.129.1.254 '
```

Action:
  * https://github.com/debianmaster/openshift-examples/issues/59

## Tips

* https://www.craftypenguins.net/how-to-trigger-a-kubernetes-cronjob-manua