Вступление
OpenShift - это платформа Red Hat Platform-as-a-Service (PaaS), которая позволяет разработчикам быстро разрабатывать, размещать и масштабировать приложения в облачной среде. OpenShift Origin - это открытый исходный код OpenShift. Он имеет встроенную поддержку различных языков, сред выполнения и слоев данных, включая,,,,,, и. Вы можете добавить новые среды выполнения и фреймворки в OpenShift с помощью пользовательских картриджей или картриджей сообщества.
Простое масштабирование веб-приложений является основной причиной запуска их в OpenShift Origin.
-
ПРИМЕЧАНИЕ. В этом уроке пользовательский ввод будет выделен. *
Как работает OpenShift
Роли OpenShift
На платформе OpenShift используются четыре роли. Хотя это не так важно, вы знаете, какие роли выполняют эти учебные пособия, но если вы хотите развернуть кластер серверов, чтобы обеспечить высокую доступность, балансировку нагрузки и т. Д., Вам необходимо понять функции, которые предоставляют эти роли.
В нашем руководстве мы настроим один сервер для выполнения всех этих ролей.
Маклер
Роль брокера состоит из RPM-пакетов OpenShift Broker и клиента MCollective. Брокер служит центральным узлом развертывания OpenShift и предоставляет веб-интерфейс, где пользователи могут управлять своими размещенными приложениями.
-
DbServer *
Эта роль состоит из базы данных MongoDB, которую брокер использует для отслеживания пользователей и приложений.
-
MsgServer *
Роль MsgServer включает сервер ActiveMQ и клиент MCollective.
Узел
Роль Node назначается любому хосту, который будет фактически использоваться для хранения и обслуживания приложений, размещенных в OpenShift. oo-install поддерживает развертывание узлов как часть начальной установки и как часть рабочего процесса для добавления нового узла в существующее развертывание OpenShift.
Архитектура OpenShift
OpenShift разработан для обеспечения высокой доступности и масштабируемости платформы приложений. При правильной настройке крупное развертывание OpenShift может предложить простой способ масштабирования вашего приложения при повышении требований при нулевом времени простоя. С кластером хостов OpenShift в нескольких местах центров обработки данных вы можете пережить весь центр обработки данных, выходя из строя. В этом уроке мы настроим наш первый хост OpenShift, который будет выполнять все роли, необходимые для OpenShift.
Как это работает с точки зрения клиента
-
Клиент хочет посетить сайт.
-
Браузер клиента запрашивает запись DNS для домена.
-
DNS-сервер отвечает IP-адресом узла, на котором размещено приложение.
-
Браузер клиентов отправляет запрос GET на узел.
-
Узел сопоставляет запрос с желаемым приложением.
-
Приложение само отвечает на запрос напрямую.
Изображение: HTTPS: //assets.digitalocean.com/articles/configure_openshift/1.png [изображение]
-
Как DNS-сервер узнал, на каком узле запущено приложение? *
Разработчик подключается к брокеру для создания / управления приложением. Когда владелец изменяет приложение, брокер отправляет на DNS-сервер сообщение с новой информацией. Эта информация включает в себя домены, которые используются для приложения, и какие узлы размещают приложение. Из-за этой автоматизации OpenShift требует контроля над зоной DNS домена или субдомена, используемого для приложений.
OpenShift использует DNS-сервер Bind. Если у вас есть существующий DNS-сервер Bind, вы можете настроить OpenShift для работы с ним. Однако в этом руководстве мы рассмотрим процесс использования нового DNS-сервера, автоматически настроенного установщиком OpenShift Origin.
Если вы предпочитаете использовать существующий DNS-сервер BIND, вы можете прочитать инструкции по настройке DNS в OpenShift Origin всеобъемлющем руководстве по развертыванию.
Конфигурация DNS
В оставшейся части этого урока мы будем использовать следующие домены. Замените их своими собственными и не стесняйтесь использовать персонализированное соглашение об именах.
-
* example-dns.com * - используется для наших серверов имен
-
* Ns1.example-dns.com *
-
* Ns2.example-dns.com *
-
* Example.com *
-
* apps.example.com * - используется для приложений OpenShift
-
* openshift.example.com * - используется для хостов OpenShift
-
* master.openshift.example.com * - имя хоста нашей капли
Предпосылки
Требования к капелькам
-
* 1ГБ капли или больше *
Установка OpenShift является довольно ресурсоемкой, и некоторые пакеты могут использовать более 512 МБ ОЗУ. Вы должны использовать каплю объемом 1 ГБ или более. Если у вас возникли проблемы с регистрацией картриджей в конце программы установки, скорее всего, некоторые пакеты не удалось установить из-за нехватки памяти. Это можно подтвердить, изучив журналы установки.
Чтобы проверить журнал установки:
cat /tmp/openshift-deploy.logПоддерживаемые операционные системы
-
* CentOS 6.5 64-bit * (стандартное изображение DigitalOcean)
OpenShift Origin 4 поддерживается в 64-разрядных версиях Red Hat Enterprise Linux (RHEL) 6.4 или выше и CentOS 6.4 или выше. Он не поддерживается в Fedora, RHEL 7.x или CentOS 7.x. Рекомендуется минимальная установка RHEL / CentOS, чтобы избежать несовместимости пакетов с OpenShift. В этом руководстве будет использовано стандартное изображение Digital Ocean CentOS 6.5 x64 для капли объемом 1 ГБ.
Зависимости установщика
Следующие утилиты требуются для установщика OpenShift Origin. Из этого туториала Вы узнаете, как установить Ruby. Другие пакеты уже установлены по умолчанию с образом DigitalOcean CentOS 6.5.
-
* Локон *
-
* ruby * - 1.8.7 или выше
-
* ssh * - при развертывании в системах, отличных от хоста установщика
Корневой доступ
В оставшейся части этого руководства предполагается, что вы подключены к своему серверу с учетной записью пользователя root или учетной записи пользователя с привилегиями sudo.
Чтобы войти в корневую оболочку из другого аккаунта:
sudo suШаг первый - установка обновлений
Прежде чем продолжить, всегда рекомендуется убедиться, что у вас установлены последние обновления.
Чтобы установить обновления:
yum updateШаг второй - установить предпочитаемый текстовый редактор
Вы можете использовать свой любимый текстовый редактор на протяжении всего этого урока; Однако в примерах будет использоваться Nano.
Установите Nano с помощью:
yum install nanoКогда вы закончите редактирование файла в Nano, нажмите * Ctrl + X *, нажмите * Y *, чтобы сохранить, и нажмите * Enter *, чтобы перезаписать существующий файл.
Шаг третий - установить Ruby
Ruby не устанавливается по умолчанию при минимальной установке CentOS 6.5.
Чтобы установить Ruby:
yum install rubyШаг четвертый - Установите имя хоста
Мы должны убедиться, что наше имя хоста настроено правильно и соответствует нашему локальному компьютеру. Если это настроено неправильно, Puppet не сможет развернуть некоторые необходимые сервисы.
Чтобы проверить текущее имя хоста:
hostnameОн должен показать URL, который вы хотите использовать для панели управления OpenShift. В нашем случае это * master.openshift.example.com *.
Откройте файл:
nano /etc/sysconfig/networkОтредактируйте файл в соответствии с вашими потребностями:
NETWORKING=yes
HOSTNAME=При следующей перезагрузке ваше имя хоста будет обновлено. Мы перезагрузим компьютер после еще нескольких шагов.
Шаг пятый - сделайте так, чтобы имя хоста разрешалось на localhost
Это гарантирует, что puppet сможет правильно определить имя хоста во время установки.
Далее откройте файл / etc / hosts:
nano /etc/hostsДобавьте ваше имя хоста в строку:
127.0.0.1 localhost localhost.localdomain
::1 localhost6 localhost6.localdomain6Шаг шестой - Включить SELinux
SELinux (Security-Enhanced Linux) - это модуль безопасности ядра Linux, который обеспечивает механизм поддержки политик безопасности контроля доступа, в том числе обязательного контроля доступа (MAC) в стиле Министерства обороны США. Этот модуль ядра является обязательным требованием для OpenShift для безопасной изоляции приложений.
Для получения дополнительной информации о SELinux и дополнительных конфигурациях, которые необходимо выполнить перед использованием OpenShift в производственной среде, см. Серии, приведенные ниже. Хотя серия основана на CentOS 7, принципы и процесс развертывания одинаковы.
Для целей этого урока мы включим SELinux, установив его в режим «+ принудительное +».
Открыто :
nano /etc/sysconfig/selinuxИзмените SELinux на:
# This file controls the state of SELinux on the system.
# SELINUX= can take one of these three values:
# enforcing - SELinux security policy is enforced.
# permissive - SELinux prints warnings instead of enforcing.
# disabled - SELinux is fully disabled.
# SELINUXTYPE= type of policy in use. Possible values are:
# targeted - Only targeted network daemons are protected.
# strict - Full SELinux protection.
SELINUXTYPE=targeted
# SETLOCALDEFS= Check local definition changes
SETLOCALDEFS=0Затем перезагрузите, чтобы включить наши настройки:
rebootЕсли вы используете SSH, вам придется переподключаться после перезагрузки.
Шаг седьмой - Установите OpenShift Origin
Теперь мы установим OpenShift Origin.
У нас есть три варианта установки OpenShift: curl-to-shell, переносной установщик или установка из исходного кода. В этой статье мы будем использовать метод curl-to-shell для установки OpenShift Origin.
-
Эта конфигурация займет несколько минут, а сама установка может занять до часа, хотя вам не нужно присматривать за сервером для этой части. *
Чтобы запустить установщик:
sh <(curl -s https://install.openshift.com/)(Необязательно) Варианты установки
Параметры командной строки полезны для крупных и корпоративных развертываний. Если у вас есть предопределенные файлы конфигурации или уже установлена Puppet, вы можете использовать эти опции для ускорения процесса установки. Поскольку это наше первое развертывание на одном сервере, мы не будем использовать ни один из перечисленных ниже вариантов. Тем не менее, полезно знать, какие функции предоставляют эти параметры, если вам необходимо масштабировать развертывание Openshift в будущем.
Для получения дополнительной информации вы можете проверить official документов.
-a --advanced-mode Enable access to message server and db server customization
-c --config-file FILEPATH The path to an alternate config file
-w --workflow WORKFLOW_ID The installer workflow for unattended deployment
--force Ignore workflow warnings and automatically install missing RPMs
-l --list-workflows List the workflow IDs for use with unattended deployment
-e --enterprise-mode Show OpenShift Enterprise options (ignored in unattended mode)
-s --subscription-type TYPE The software source for installation packages
-u --username USERNAME Login username
-p --password PASSWORD Login password
--use-existing-puppet For Origin; do not attempt to install the Puppet module
-d --debug Enable debugging messagesШаг восьмой - Ответьте на вопросы установщика
OpenShift Origin использует интерактивный процесс установки. Есть довольно много вопросов, на которые нужно ответить, так что будьте внимательны! Вопросы показаны ниже, с пользовательским вводом в.
Welcome to OpenShift.
This installer will guide you through a basic system deployment, based
on one of the scenarios below.
Select from the following installation scenarios.
You can also type '?' for Help or 'q' to Quit:
1. Install OpenShift Origin
2. Add a Node to an OpenShift Origin deployment
3. Generate a Puppet Configuration File
Type a selection and press <return>:Программа установки предложит вам сценарий установки. Введите * 1 * и нажмите * Enter *.
DNS - установить новый DNS-сервер
----------------------------------------------------------------------
DNS Configuration
----------------------------------------------------------------------
First off, we will configure some DNS information for this system.
Do you want me to install a new DNS server for OpenShift-hosted
applications, or do you want this system to use an existing DNS
server? (Answer 'yes' to have me install a DNS server.) (y/n/q/?)Для этого урока мы хотим развернуть новый DNS-сервер, поэтому введите * y * и нажмите * Enter *.
DNS - домен приложения
All of your hosted applications will have a DNS name of the form:
<app_name>-<owner_namespace>.<all_applications_domain>
What domain name should be used for all the hosted apps in your
OpenShift system? |example.com|Введите домен, который вы хотели бы использовать для своих размещенных приложений, который в этом примере является * apps.example.com *, и нажмите * Enter *.
DNS - домен хостов OpenShift
Do you want to register DNS entries for your OpenShift hosts with the
same OpenShift DNS service that will be managing DNS records for the
hosted applications? (y/n/q)
What domain do you want to use for the OpenShift hosts?Введите домен, который вы хотели бы использовать для хостов OpenShift (в этом примере это + openshift.example.com +), и нажмите * Enter *.
DNS - полное доменное имя сервера имен
Hostname (the FQDN that other OpenShift hosts will use to connect to
the host that you are describing):Поскольку мы размещаем DNS на одной и той же Droplet, мы будем использовать Полное доменное имя этой машины. Введите полное доменное имя вашего хоста, которое в этом примере равно + master.openshift.example.com +, и нажмите * Enter *.
DNS - имя хоста SSH
Hostname / IP address for SSH access to master.openshift.example.com
from the host where you are running oo-install. You can say
'localhost' if you are running oo-install from the system that you are
describing: |master.openshift.example.com|
Using current user (root) for local installation.Это имя хоста, используемое для установки OpenShift. Поскольку мы устанавливаем на тот же Droplet, на котором работает установщик, мы можем использовать localhost. Введите + localhost + и нажмите * Enter *.
DNS - настройка IP-адреса
Если у вас включена частная сеть, вам нужно будет использовать интерфейс WAN / IP-адрес для любого хоста, которому вы хотите назначить роль узла. Поскольку в этом руководстве мы устанавливаем только один хост, убедитесь, что вы используете eth0 в качестве интерфейса для этого хоста. В большой конфигурации с несколькими брокерами и DBServers вы будете использовать интерфейс частной сети только для этих хостов. Попытка использовать частный интерфейс на узле приведет к ошибке IP-адреса во время развертывания.
Detected IP address 104.131.174.112 at interface eth0 for this host.
Do you want Nodes to use this IP information to reach this host?
(y/n/q/?)
Normally, the BIND DNS server that is installed on this host will be
reachable from other OpenShift components using the host's configured
IP address (104.131.174.112).
If that will work in your deployment, press <enter> to accept the
default value. Otherwise, provide an alternate IP address that will
enable other OpenShift components to reach the BIND DNS service on
this host: |104.131.174.112|
That's all of the DNS information that we need right now. Next, we
need to gather information about the hosts in your OpenShift
deployment.Для целей данного урока мы будем использовать настройки по умолчанию, как показано на рисунке выше.
Конфигурация брокера
----------------------------------------------------------------------
Broker Configuration
----------------------------------------------------------------------
Do you already have a running Broker? (y/n/q)
Okay. I'm going to need you to tell me about the host where you want
to install the Broker.
Do you want to assign the Broker role to master.openshift.example.com?
(y/n/q/?)
Okay. Adding the Broker role to master.openshift.example.com.
That's everything we need to know right now for this Broker.
Do you want to configure an additional Broker? (y/n/q)
Moving on to the next role.Теперь установщик попросит нас настроить брокера. В этом примере у нас еще нет брокеров, поэтому мы установим роль на master.openshift.example.com.
Конфигурация узла
----------------------------------------------------------------------
Node Configuration
----------------------------------------------------------------------
Do you already have a running Node? (y/n/q)
Okay. I'm going to need you to tell me about the host where you want
to install the Node.
Do you want to assign the Node role to master.openshift.example.com?
(y/n/q/?)
Okay. Adding the Node role to master.openshift.example.com.
That's everything we need to know right now for this Node.
Do you want to configure an additional Node? (y/n/q)Теперь установщик попросит нас настроить узел. В этом примере у нас еще нет узлов, поэтому мы установим роль на. В этот момент установщик также попросит вас настроить учетные записи пользователей. В этом примере мы решили, что установщик сгенерирует учетные данные для нас.
Конфигурация имени пользователя и пароля
Do you want to manually specify usernames and passwords for the
various supporting service accounts? Answer 'N' to have the values
generated for you (y/n/q)Если вы хотите вручную настроить имена пользователей и пароли, используемые для вашего развертывания, вы можете сделать это здесь. В нашем примере мы решили создать их автоматически для нас. Введите * n * и нажмите * Enter *.
Обратите внимание на вывод. Позже вам понадобятся значения из таблицы «Настройки учетной записи» в руководстве, в частности, и.
Account Settings
+----------------------------+------------------------+
| OpenShift Console User | demo |
| OpenShift Console Password | S94XXXXXXXXXXXXXXXH8w |
...Завершить развертывание
Host Information
+------------------------------+------------+
| Hostname | Roles |
+------------------------------+------------+
| master.openshift.example.com | Broker |
| | NameServer |
| | Node |
+------------------------------+------------+
Choose an action:
1. Change the deployment configuration
2. View the full host configuration details
3. Proceed with deployment
Type a selection and press <return>:Когда вы будете удовлетворены конфигурацией, введите * 3 * и нажмите * Enter *.
Репозиторий Подписки
Do you want to make any changes to the subscription info in the
configuration file? (y/n/q/?)
Do you want to set any temporary subscription settings for this
installation only? (y/n/q/?)Для целей этого урока мы будем использовать зеркала по умолчанию. Введите * n * и нажмите * Enter *, для обоих вопросов.
Предполетная проверка
The following RPMs are required, but not installed on this host:
* puppet
* bind
Do you want to want me to try to install them for you? (y/n/q)Теперь установщик выполнит предполетную проверку. Если вам нужны какие-либо установленные пакеты, такие как Puppet и BIND в нашем примере, введите * y * и нажмите * Enter *.
Примечание: После того, как вы ответите на этот вопрос, Puppet будет работать на вашем сервере до часа, чтобы настроить OpenShift Origin.
Вот пример выходных данных:
master.openshift.example.com: Running Puppet deployment for host
<^>Error: Could not uninstall module 'openshift-openshift_origin'
Module 'openshift-openshift_origin' is not installed
master.openshift.example.com: Puppet module removal failed. This is expected if the module was not installed.<^>
master.openshift.example.com: Attempting Puppet module installation (try #1)
<^>Warning: Symlinks in modules are unsupported. Please investigate symlink duritong-sysctl-0.0.5/spec/fixtures/modules/sysctl/manifests->../../../../manifests.
Warning: Symlinks in modules are unsupported. Please investigate symlink duritong-sysctl-0.0.5/spec/fixtures/modules/sysctl/lib->../../../../lib.<^>
master.openshift.example.com: Puppet module installation succeeded.
master.openshift.example.com: Cleaning yum repos.
master.openshift.example.com: Running the Puppet deployment. This step may take up to an hour._ПРИМЕЧАНИЕ. Красный текст в выходных данных используется для выделения ошибок и предупреждений.
Теперь установщик выполнит остальную часть развертывания. Во время этого процесса вы можете увидеть некоторые предупреждения (см. Изображение выше). Это нормально и не повлияет на развертывание. * Этот процесс может занять более часа. *
Повторное развертывание
Если Puppet не настроил все правильно с первого раза, вы можете перезапустить развертывание Puppet без повторного запуска всей конфигурации. Если вы видите ошибку при первом доступе к инструментальной панели OpenShift Origin, вы, вероятно, захотите это сделать.
Запустите установщик снова:
sh <(curl -s https://install.openshift.com/)На этот раз вы выберете третий вариант, чтобы создать новый файл конфигурации Puppet. Не весь результат показан ниже - только вопросы и ответы.
Select from the following installation scenarios.
You can also type '?' for Help or 'q' to Quit:
1. Install OpenShift Origin
2. Add a Node to an OpenShift Origin deployment
3. Generate a Puppet Configuration File
Type a selection and press <return>:
Choose an action:
1. Change the deployment configuration
2. View the full host configuration details
3. Proceed with deployment
Type a selection and press <return>:
Do you want to make any changes to the subscription info in the
configuration file? (y/n/q/?)
Do you want to set any temporary subscription settings for this
installation only? (y/n/q/?)Запишите имя файла, показанное в выводе:
Puppt template created at /root/oo_install_configure_master.openshift.example.com.pp
To run it, copy it to its host and invoke it with puppet: `puppet
apply <filename>`.
All tasks completed.
oo-install exited; removing temporary assets.Запустите конфигурацию Puppet, используя имя файла, которое вам дали:
puppet applyШаг девятый - протестируйте развертывание OpenShift
Ваша установка OpenShift завершена. Вы можете протестировать развертывание OpenShift, посетив следующий URL в веб-браузере.
https:///изображение: https: //assets.digitalocean.com/articles/configure_openshift/2.png [Предупреждение сертификата браузера]
OpenShift будет использовать самозаверяющий сертификат, поэтому вам придется добавить исключение для этого в вашем веб-браузере.
Если вы ранее не отмечали учетные данные, прокрутите обратно до раздела «Настройки учетной записи» и используйте и для входа в систему.
Account Settings
+----------------------------+------------------------+
| OpenShift Console User | |
| OpenShift Console Password | |
| MCollective User | mcollective |
| MCollective Password | dtdRNs8i1pWi3mL9JsNotA |
| MongoDB Admin User | admin |
| MongoDB Admin Password | RRgY8vJd2h5v4Irzfi8kkA |
| MongoDB Broker User | openshift |
| MongoDB Broker Password | 28pO0rU8ohJ0KXgpqZKw |
+----------------------------+------------------------+изображение: https: //assets.digitalocean.com/articles/configure_openshift/3.png [страница приветствия OpenShift]
Если вы можете войти в консоль, но видите ошибку, вам может потребоваться повторно развернуть конфигурацию Puppet. Смотрите предыдущий раздел для деталей.
Шаг десятый - настройка доменов для OpenShift
Как правило, вы должны следовать документации вашего регистратора доменов для создания записей DNS. Мы предоставили изображения ниже для иллюстративных целей. Для доменов серверов имен вы захотите заменить IP-адрес своего хоста OpenShift или DNS-сервера BIND. В нашем примере мы создали две записи сервера имен, которые указывают на один и тот же IP-адрес. Это связано с тем, что большинству регистраторов доменов требуется минимум две записи NS. В этом уроке мы не настраивали DNS-сервер Secondary Bind.
-
example-dns.com * + Запись | ns1.example-dns.com ⇒ 104.131.174.112 + A Запись | ns2.example-dns.com ⇒ 104.131.174.112
изображение: https: //assets.digitalocean.com/articles/configure_openshift/4.png [настройки DNS сервера имен]
Направьте домен приложения на использование только что настроенных DNS-серверов OpenShift.
-
example.com * + NS Record | ns1.example.com. + NS Record | ns2.example.com.
изображение: https: //assets.digitalocean.com/articles/configure_openshift/5.png [настройки DNS домена приложения]
Примечание. В целях тестирования вы также можете просто указать свой домен приложения или поддомен на IP-адрес сервера OpenShift, поскольку в настоящее время мы развертываем только один сервер OpenShift Origin.
Теперь вы сможете получить доступ к консоли OpenShift из доменного имени вашего брокера. В нашем примере мы использовали master.openshift.example.com. Вам придется снова добавить исключение для самозаверяющего сертификата с новым доменом.
Подробную информацию о настройке записей DNS см. В руководствах, перечисленных ниже.
Шаг одиннадцатый - Создайте свое первое приложение
изображение: https: //assets.digitalocean.com/articles/configure_openshift/6.png [Нажмите «Создать первое приложение сейчас»]
В консоли OpenShift Origin нажмите * Создать первое приложение сейчас * на странице «Приложения».
изображение: https: //assets.digitalocean.com/articles/configure_openshift/7.png [нажмите «PHP 5.4»]
Нажмите * PHP 5.4 *, чтобы выбрать его в качестве картриджа.
изображение: https: //assets.digitalocean.com/articles/configure_openshift/8.png [Установить имя домена]
Поскольку это ваше первое приложение, вам также нужно будет указать доменное имя. В нашем примере мы использовали demo.apps.example.com с именем приложения php. Конечный URL будет php-demo.apps.example.com.
Оставьте остальные настройки по умолчанию.
изображение: https: //assets.digitalocean.com/articles/configure_openshift/9.png [Нажмите «Создать приложение»]
Нажмите * Создать приложение *. Инициализация приложения может занять пару минут. После завершения этого процесса, вы можете нажать * посетить приложение в браузере *, чтобы увидеть тестовое приложение. Вам будет предложена страница картриджа PHP по умолчанию. Эта страница также даст вам полезную информацию о том, как редактировать и развертывать приложения, используя OpenShift.
изображение: https: //assets.digitalocean.com/articles/configure_openshift/10.png [страница приложения PHP по умолчанию]
Заключение
Мы успешно развернули среду Openshift Origin с одним сервером. К этому серверу применены все четыре роли OpenShift. Он также настроен как DNS-сервер. Мы настроили один домен (example-dns.com), используемый для указателей нашего сервера имен. Мы настроили второй домен (example.com), используемый для разрешения приложений и хостов OpenShift.