OpenShift (OCP)

If you like this project, consider supporting me on Buy Me a Coffee ☕️

☸️ OpenShift (OCP) — Enterprise Kubernetes Platform

Description / Описание: Red Hat OpenShift Container Platform (OCP) is an enterprise-grade Kubernetes distribution that adds developer and operational tooling on top of Kubernetes. It provides a web console, integrated CI/CD (Pipelines/GitOps), built-in monitoring (Prometheus/Grafana), an internal container registry, enhanced security (SCCs, OAuth), and the oc CLI — a superset of kubectl. OpenShift uses Operators extensively for lifecycle management of cluster components and applications.

[!NOTE] Current Status: OpenShift is actively developed by Red Hat (IBM). It is widely used in enterprise environments requiring commercial support and compliance certifications (FedRAMP, HIPAA). Free alternatives: OKD (upstream community edition), vanilla Kubernetes + add-ons, Rancher (SUSE), Tanzu (VMware/Broadcom). The oc CLI is a superset of kubectl — all kubectl commands work with oc. / Текущий статус: OpenShift активно развивается Red Hat. Используется в корпоративных средах. Бесплатные альтернативы: OKD, Rancher, Tanzu. CLI oc — надмножество kubectl.

Default Ports: API Server: 6443 | Web Console: 443 | OAuth: 443 | Internal Registry: 5000

Authentication & Context

Login / Вход

# Login via Token / Вход по токену
oc login --token=<TOKEN> --server=https://api.<CLUSTER>:6443

# Login with User/Pass / Вход по логину/паролю
oc login -u <USER> -p <PASSWORD> https://api.<CLUSTER>:6443

# Login as System Admin (if certs available) / Вход как админ
export KUBECONFIG=<PATH_TO_KUBECONFIG>
oc whoami                                          # Show current user / Показать текущего пользователя
oc whoami --show-server                            # Show API server / Показать API сервер
oc whoami --show-token                             # Show current token / Показать текущий токен

Project Management / Управление проектами (Namespaces)

oc project <PROJECT_NAME>                          # Switch project / Переключить проект
oc new-project <PROJECT_NAME>                      # New project / Новый проект
oc get projects                                    # List projects / Список проектов
oc delete project <PROJECT_NAME>                   # Delete project / Удалить проект
oc project                                         # Show current project / Показать текущий проект

[!NOTE] OpenShift Projects are Kubernetes Namespaces with additional metadata (display name, description, annotations). oc new-project creates a namespace with default RBAC bindings. / OpenShift Projects — это Kubernetes Namespace с дополнительными метаданными.

Core Operations

The oc CLI is a superset of kubectl — all kubectl commands work with oc. Below are OpenShift-specific commands and aliases. / CLI oc — надмножество kubectl. Ниже — команды, специфичные для OpenShift.

Get Resources / Получение ресурсов

oc get pods                                        # List pods / Список pod-ов
oc get svc                                         # List services / Список сервисов
oc get routes                                      # OpenShift routes (Ingress equivalent) / Маршруты OpenShift
oc get dc                                          # DeploymentConfig (Legacy) / DeploymentConfig (устаревшее)
oc get builds                                      # List builds / Список сборок
oc get bc                                          # BuildConfig / Конфигурация сборки
oc get is                                          # ImageStreams / Потоки образов

Logs & Exec / Логи и вход

oc logs -f <POD_NAME>                              # Container logs (follow) / Логи контейнера
oc logs -f bc/<BUILD_CONFIG>                       # Build logs / Логи сборки
oc rsh <POD_NAME>                                  # Shell into pod / Оболочка в pod-е
oc exec -it <POD_NAME> -- /bin/bash                # Exec bash / Выполнить bash

[!TIP] oc rsh is more convenient than kubectl exec -it — it defaults to /bin/sh and requires fewer flags. / oc rsh удобнее kubectl exec -it — по умолчанию /bin/sh и требует меньше флагов.

Resource Creation / Создание ресурсов

oc new-app nginx                                   # Deploy app from image / Развернуть из образа
oc new-app <GIT_REPO_URL>                          # Deploy from Git / Развернуть из Git
oc new-app <IMAGE> --name=<APP_NAME>               # Deploy with custom name / Развернуть с именем
oc expose svc/<SERVICE_NAME>                       # Create route for service / Создать маршрут для сервиса

Admin Operations

[!IMPORTANT] Admin operations require cluster-admin or equivalent privileges. / Админские операции требуют привилегий cluster-admin.

Node Management / Управление узлами

oc get nodes                                       # List nodes / Список узлов
oc describe node <NODE_NAME>                       # Node details / Детали узла
oc debug node/<NODE_NAME>                          # Debug node (mounts host OS) / Отладка узла
# → chroot /host                                   # Access host filesystem / Доступ к ФС хоста
oc adm top nodes                                   # Node resource usage / Использование ресурсов нод
oc adm cordon <NODE_NAME>                          # Mark unschedulable / Запретить планирование
oc adm uncordon <NODE_NAME>                        # Enable scheduling / Разрешить планирование
oc adm drain <NODE_NAME> --ignore-daemonsets       # Drain node / Освободить ноду

Policy & Users / Политики и пользователи

oc adm policy add-cluster-role-to-user cluster-admin <USER>  # Add cluster admin / Дать админа
oc policy add-role-to-user view <USER> -n <PROJECT>          # Add view role / Дать права просмотра
oc adm policy add-scc-to-user anyuid -z default -n <PROJECT> # Add SCC to SA / Добавить SCC к SA
oc get clusterrolebindings | grep <USER>                     # Check user roles / Проверить роли пользователя

Cluster Management / Управление кластером

oc get clusterversion                              # Cluster version / Версия кластера
oc get clusteroperators                            # Cluster operators status / Статус операторов
oc adm upgrade                                     # Check available upgrades / Проверить обновления
oc get machineconfigpool                           # MachineConfigPool status / Статус MachineConfigPool

Builds & Deployments

OpenShift-specific Resources / Ресурсы, специфичные для OpenShift

# Start a build / Запустить сборку
oc start-build <BUILD_CONFIG>

# Start build from local directory / Сборка из локальной директории
oc start-build <BUILD_CONFIG> --from-dir=.

# Cancel a build / Отменить сборку
oc cancel-build <BUILD_NAME>

# Rollout / deployment management / Управление деплойментом
oc rollout latest dc/<APP_NAME>                    # Trigger new rollout / Запустить новое развёртывание
oc rollout status dc/<APP_NAME>                    # Rollout status / Статус развёртывания
oc rollout undo dc/<APP_NAME>                      # Rollback / Откат

[!WARNING] DeploymentConfig (dc) is a legacy OpenShift resource. For new applications, use standard Kubernetes Deployment objects. / DeploymentConfig — устаревший ресурс OpenShift. Для новых приложений используйте стандартный Deployment.

Routes & Networking

# Create route / Создать маршрут
oc expose svc/<SERVICE_NAME>                       # HTTP route / HTTP маршрут
oc create route edge --service=<SERVICE_NAME>      # HTTPS route (edge TLS) / HTTPS маршрут

# Manage routes / Управление маршрутами
oc get routes                                      # List routes / Список маршрутов
oc describe route <ROUTE_NAME>                     # Route details / Детали маршрута
oc delete route <ROUTE_NAME>                       # Delete route / Удалить маршрут

# Get route URL / Получить URL маршрута
oc get route <ROUTE_NAME> -o jsonpath='{.spec.host}'

Route vs Ingress / Маршруты vs Ingress

Security

Security Context Constraints (SCC) / Ограничения контекста безопасности

SCCs are OpenShift's extension of Kubernetes PodSecurityPolicies (now PodSecurityStandards). / SCC — расширение Kubernetes PodSecurityPolicies.

oc get scc                                         # List SCCs / Список SCC
oc describe scc restricted                         # SCC details / Детали SCC
oc adm policy add-scc-to-user anyuid -z <SA_NAME> -n <PROJECT>  # Grant SCC / Выдать SCC
oc adm policy who-can use scc anyuid               # Who has SCC / Кто имеет SCC

OAuth & Identity / OAuth и идентификация

oc get oauth cluster -o yaml                       # OAuth config / Конфигурация OAuth
oc get identities                                  # List identities / Список идентификаций
oc get users                                       # List users / Список пользователей
oc adm groups new <GROUP_NAME>                     # Create group / Создать группу
oc adm groups add-users <GROUP_NAME> <USER>        # Add user to group / Добавить в группу

Troubleshooting & Tools

Events & Diagnostics / События и диагностика

oc get events --sort-by='.lastTimestamp'            # Recent events / Последние события
oc get events -n <PROJECT> --field-selector reason=Failed  # Failed events / Неудачные события
oc adm node-logs <NODE_NAME> -u kubelet            # Node kubelet logs / Логи kubelet узла
oc adm must-gather                                 # Collect diagnostic data / Собрать диагностику

Image Streams & Registry / Потоки образов и реестр

oc get is -n openshift                             # OpenShift base images / Базовые образы OpenShift
oc describe is <IMAGE_STREAM> -n openshift         # IS details / Детали ImageStream
oc import-image <IMAGE>:<TAG> --from=<REGISTRY>/<IMAGE>:<TAG> --confirm  # Import image / Импорт образа

Internal Registry / Внутренний реестр

# Login to internal registry / Вход во внутренний реестр
oc registry login

# Get registry URL / Получить URL реестра
oc registry info

# Push image to internal registry / Отправить образ во внутренний реестр
podman push <IMAGE> $(oc registry info)/<PROJECT>/<IMAGE>:<TAG>

Common Issues Quick Reference / Краткий справочник проблем

Sysadmin Essentials

Important Paths / Важные пути

oc vs kubectl Comparison / Сравнение oc и kubectl

Documentation Links

• OpenShift Official Documentation: https://docs.openshift.com/
• OpenShift CLI (oc) Reference: https://docs.openshift.com/container-platform/latest/cli_reference/openshift_cli/getting-started-cli.html
• OKD (Community Edition): https://www.okd.io/
• Red Hat OpenShift Product Page: https://www.redhat.com/en/technologies/cloud-computing/openshift
• OpenShift GitHub: https://github.com/openshift
• OpenShift Interactive Learning: https://learn.openshift.com/