{"id":16686963,"url":"https://github.com/paralin/openshift-under-kubernetes","last_synced_at":"2025-10-24T15:44:56.095Z","repository":{"id":57449226,"uuid":"53095305","full_name":"paralin/openshift-under-kubernetes","owner":"paralin","description":"A full system for deploying and managing Openshift Origin under an existing Kubernetes cluster.","archived":false,"fork":false,"pushed_at":"2018-02-06T13:46:06.000Z","size":100,"stargazers_count":16,"open_issues_count":4,"forks_count":5,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-18T03:51:30.748Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paralin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-03-04T00:44:18.000Z","updated_at":"2023-07-27T02:39:56.000Z","dependencies_parsed_at":"2022-09-14T07:22:05.016Z","dependency_job_id":null,"html_url":"https://github.com/paralin/openshift-under-kubernetes","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paralin%2Fopenshift-under-kubernetes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paralin%2Fopenshift-under-kubernetes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paralin%2Fopenshift-under-kubernetes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paralin%2Fopenshift-under-kubernetes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paralin","download_url":"https://codeload.github.com/paralin/openshift-under-kubernetes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244849482,"owners_count":20520726,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-12T15:07:21.961Z","updated_at":"2025-10-24T15:44:56.042Z","avatar_url":"https://github.com/paralin.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Openshift under Kubernetes\n\n\n[![](https://img.shields.io/pypi/dm/openshift-under-kubernetes.svg)](https://pypi.python.org/pypi/openshift-under-kubernetes/)\n[![](https://img.shields.io/pypi/v/openshift-under-kubernetes.svg)](https://pypi.python.org/pypi/openshift-under-kubernetes/)\n[![](https://travis-ci.org/paralin/openshift-under-kubernetes.svg)](https://travis-ci.org/paralin/openshift-under-kubernetes/)\n\nDeploys OpenShift Origin to an existing Kubernetes cluster. This is arguably the most ideal way to deploy OpenShift, for a few reasons:\n\n - OpenShift Origin is a layer on top of Kubernetes\n - Kubernetes is extremely flexible in the ways it can be deployed, with kube-up\n - Allowing Kubernetes and OpenShift to be independently updated is ideal for feature iteration and stability\n - This is much easier than dealing with Ansible under OpenShift v3.\n\nRequirements\n============\n\nThis system requires the following things:\n\n - A running working Kubernetes cluster.\n - A kubeconfig for this cluster with long-term API authentication details at maximum administrative level.\n - A Persistent Volume with at least 2Gi of space.\n\n# Deploy Process\n\nThis is the process this system uses to deploy OpenShift:\n\n- Fetch the ServiceAccount public key by creating a temporary namespace and pod.\n- Create the `openshift-origin` namespace.\n- Create a secret containing the kubeconfig with administrative access\n- Create the \"openshift\" service and grab the internal and external addresses.\n- Run openshift with the \"--write-config\" option to generate the initial default config in a temporary namespace.\n- Use an existing `PersistentVolume` created by the user.\n- Create a `PersistentVolumeClaim` to claim this storage.\n- Create the single-node \"etcd\" cluster to store the openshift data.\n- Create the OpenShift replication controller.\n\nThe cli allows you to interactively edit the config, among other features.\n\n# Usage\n\nTo install it:\n\n    $ pip install openshift-under-kubernetes\n\nTo use it:\n\n    $ openshift-under-kubernetes --help\n\nThis will output:\n\n    Usage: openshift-under-kubernetes [OPTIONS] COMMAND [ARGS]...\n    \n    Options:\n      --config PATH             kube config path\n      --context TEXT            kube context\n      --openshift-version TEXT  force openshift version (default 1.1.4)\n      --secure / --no-secure    enables https checking\n      -y                        auto-answer for all confirmations\n      --help                    Show this message and exit.\n    \n    Commands:\n      addclusterrole  Adds a CLUSTER role to a user by directly...\n      deploy          Deploy OpenShift to the cluster.\n      deployregistry  Deploy an OpenShift Registry to the cluster.\n      editconfig      Interactively edits master-config.yaml\n      execute         Executes any of the OpenShift commands inside...\n      getconfig       Writes the entire openshift config to a...\n      info            Show cluster information\n      undeploy        Removes OpenShift from the cluster.\n\n\nYou can get started by running `openshift-under-kubernetes info` to check that the tool can properly communicate with your cluster. Then, use \"deploy\" to publish a new openshift cluster.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparalin%2Fopenshift-under-kubernetes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparalin%2Fopenshift-under-kubernetes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparalin%2Fopenshift-under-kubernetes/lists"}