Плагин Service Fabric для разработки Java приложений в среде Eclipse

Eclipse является одним из самых широко используемых интегрированных сред разработки (IDEs) для разработчиков Java. В этой статье описано, как настроить среду разработки Eclipse для работы с Azure Service Fabric. Узнайте, как установить подключаемый модуль Service Fabric, создать приложение Service Fabric и развернуть приложение Service Fabric в локальном или удаленном кластере Service Fabric в Eclipse.

Примечание.

Плагин Eclipse в настоящее время не поддерживается на Windows.

Это важно

Убедитесь, что JDK 8 установлен в системе и выбран в Eclipse.

Установка или обновление подключаемого модуля Service Fabric в Eclipse

Возможна установка подключаемого модуля Service Fabric в Eclipse. Подключаемый модуль поможет упростить процесс создания и развертывания служб Java.

Это важно

Для подключаемого модуля Service Fabric требуется Eclipse Neon или более поздняя версия. Чтобы проверить версию Eclipse, выполните инструкции под этим примечанием. Если у вас установлена более ранняя версия Eclipse, скачайте более новые версии с сайта Eclipse. Не рекомендуется устанавливать наверх (перезаписывать) существующую установку Eclipse. Его можно удалить перед запуском установщика или установить более новую версию в другом каталоге.

В Ubuntu мы рекомендуем установить Eclipse непосредственно с сайта, а не с помощью установщика пакета (apt или apt-get). Так вы получите последнюю версию Eclipse.

Установите Eclipse Neon или более поздней версии с сайта Eclipse. Также установите версию 2.2.1 или более позднюю версию Buildship (подключаемый модуль Service Fabric несовместим со старыми версиями Buildship):

• Чтобы проверить версии установленных компонентов, в Eclipse перейдите в раздел "Справка>о установке Eclipse>".
• Сведения об обновлении Buildship см. в статье Eclipse Buildship: Подключаемые модули Eclipse для Gradle.
• Чтобы проверить и установить обновления eclipse, перейдите в раздел "Справка>по проверке обновлений".

Установите подключаемый модуль Service Fabric в Eclipse, перейдите к разделу "Справка по>установке нового программного обеспечения".

1. В поле Работа с введите https://servicefabricdownloads.blob.core.windows.net/eclipse/.

2. Нажмите кнопку Добавить.

   

3. Выберите подключаемый модуль Service Fabric и нажмите кнопку "Далее".

4. Выполните действия по установке и примите условия лицензионного соглашения майкрософт.

Если у вас уже установлен подключаемый модуль Service Fabric, установите последнюю версию.

1. Чтобы проверить наличие доступных обновлений, перейдите в раздел "Справка>о установке Eclipse>".
2. В списке установленных подключаемых модулей выберите Service Fabric и нажмите кнопку "Обновить". Будут установлены доступные обновления.
3. После обновления подключаемого модуля Service Fabric также обновите проект Gradle. Щелкните правой кнопкой мыши build.gradle, а затем выберите "Обновить".

Примечание.

При установке или обновлении подключаемого модуля Service Fabric медлительность может быть связана с параметром Eclipse. Eclipse собирает метаданные о всех изменениях сайтов обновлений, зарегистрированных в вашем экземпляре Eclipse. Чтобы ускорить процесс проверки и установки подключаемого модуля Service Fabric, перейдите на доступные сайты программного обеспечения. Снимите флажки для всех сайтов, кроме того, который указывает на расположение плагина Service Fabric ('https://servicefabricdownloads.blob.core.windows.net/eclipse/').

Примечание.

Если Eclipse не работает должным образом на компьютере Mac или вам нужен суперпользователь), перейдите в папку ECLIPSE_INSTALLATION_PATH и перейдите к вложенной папке Eclipse.app/Contents/MacOS. Запустите Eclipse, выполнив команду ./eclipse.

Создание приложения Service Fabric в Eclipse

1. В Eclipse перейдите к Файл>Создать>Другое. Выберите Проект Service Fabric и нажмите кнопку "Далее".

   

2. Введите имя проекта и нажмите кнопку "Далее".

   

3. В списке шаблонов выберите шаблон службы. Выберите тип шаблона службы (субъект, без отслеживания состояния, контейнер или гостевой двоичный файл), а затем нажмите кнопку "Далее".

   

4. Введите имя службы и сведения о службе, а затем нажмите кнопку "Готово".

   

5. При создании первого проекта Service Fabric в диалоговом окне "Открыть связанную перспективу " нажмите кнопку "Да".

   

6. Новый проект выглядит следующим образом:

   

Создание приложения Service Fabric в Eclipse

1. Щелкните правой кнопкой мыши новое приложение Service Fabric и выберите Service Fabric.

   

2. В контекстном меню выберите один из следующих вариантов:

   • Чтобы создать приложение без очистки, нажмите кнопку "Создать приложение".
   • Чтобы выполнить чистую сборку приложения, нажмите кнопку "Перестроить приложение".
   • Чтобы очистить приложение от созданных артефактов, нажмите Очистить приложение.

Развертывание приложения Service Fabric в локальном кластере с помощью Eclipse

После создания приложения Service Fabric выполните следующие действия, чтобы развернуть его в локальном кластере.

1. Если вы еще не запустили локальный кластер, следуйте инструкциям в разделе "Настройка локального кластера " для запуска локального кластера и убедитесь, что он запущен.

2. Щелкните правой кнопкой мыши приложение Service Fabric и выберите Service Fabric.

   

3. В контекстном меню щелкните "Развернуть приложение".

4. Вы можете отслеживать ход операции развертывания в окне консоли.

5. Чтобы убедиться, что приложение запущено, откройте Service Fabric Explorer в локальном кластере в окне http://localhost:19080/Explorerбраузера. Разверните узел "Приложения" и убедитесь, что приложение запущено.

Сведения об отладке приложения в Eclipse с помощью локального кластера см. в статье Отладка службы Java в Eclipse.

Вы также можете развернуть приложение в локальном кластере с помощью команды "Опубликовать приложение ":

1. Щелкните правой кнопкой мыши приложение Service Fabric и выберите Service Fabric.

2. В контекстном меню щелкните "Опубликовать приложение...".

3. В окне "Публикация приложения " выберите PublishProfiles/Local.json в качестве целевого профиля и нажмите кнопку "Опубликовать".

   

   По умолчанию профиль публикации Local.json настроен для публикации в локальном кластере. Дополнительные сведения о параметрах подключения и конечной точки, присутствующих в профилях публикации, можно найти в следующем разделе.

Публикация приложения Service Fabric в Azure с помощью Eclipse

Чтобы опубликовать приложение в облаке, выполните следующие действия.

1. Чтобы опубликовать приложение в безопасном кластере в облаке, необходимо использовать сертификат X.509 для взаимодействия с кластером. В средах тестирования и разработки используемый сертификат часто является сертификатом кластера. В рабочих средах сертификат должен быть сертификатом клиента, который отличается от сертификата кластера. Требуется как сертификат, так и закрытый ключ. Файл сертификата (и ключа) должен быть отформатирован в формате PEM. Вы можете создать PEM-файл, содержащий сертификат и закрытый ключ из PFX-файла с помощью следующей команды opensl:

   openssl pkcs12 -in your-cert-file.pfx -out your-cert-file.pem -nodes -passin pass:your-pfx-password
   

   Если PFX-файл не защищен паролем, используйте --passin pass: для последнего параметра.

2. Откройте файлCloud.json в каталоге PublishProfiles . Необходимо настроить конечную точку кластера и учетные данные безопасности соответствующим образом для кластера.

   • Поле ConnectionIPOrURL содержит IP-адрес или URL-адрес кластера. Обратите внимание, что значение не содержит схему URL-адресов (https://).

   • По умолчанию ConnectionPort поле должно быть 19080, если вы явно не изменили этот порт для кластера.

   • Поле ClientKey должно указывать на peM-форматированный PEM-файл или .key файл на локальном компьютере, который содержит закрытый ключ для сертификата клиента или кластера.

   • Поле ClientCert должно указывать на файл в формате PEM, например, .pem или .crt, находящийся на вашем локальном компьютере, который содержит данные сертификата для вашего клиента или кластера. сертификат.

     {
         "ClusterConnectionParameters":
         {
            "ConnectionIPOrURL": "lnxxug0tlqm5.westus.cloudapp.azure.com",
            "ConnectionPort": "19080",
            "ClientKey": "[path_to_your_pem_file_on_local_machine]",
            "ClientCert": "[path_to_your_pem_file_on_local_machine]"
         }
     }
     

3. Щелкните правой кнопкой мыши приложение Service Fabric и выберите Service Fabric.

4. В контекстном меню щелкните "Опубликовать приложение...".

5. В окне "Публикация приложения " выберите PublishProfiles/Cloud.json в качестве целевого профиля и нажмите кнопку "Опубликовать".

   

6. Вы можете отслеживать ход выполнения операции публикации в окне консоли.

7. Чтобы убедиться, что приложение запущено, откройте Service Fabric Explorer в кластере Azure в окне браузера. В приведенном выше примере это будет: https://lnxxug0tlqm5.westus.cloudapp.azure.com:19080/Explorer Разверните узел "Приложения" и убедитесь, что приложение запущено.

В защищенных кластерах Linux, если приложение содержит службы Reliable Services, необходимо также настроить сертификат, который службы могут использовать для вызова API среды выполнения Service Fabric. Дополнительные сведения см. в разделе Настройка приложения Reliable Services для запуска на кластерах Linux.

Краткое руководство по развертыванию приложения Reliable Services Service Fabric, написанного на Java в безопасном кластере Linux, см. в кратком руководстве по развертыванию приложения Reliable Services Java.

Развертывание приложения Service Fabric с помощью конфигураций запуска Eclipse

Альтернативным способом развертывания приложения Service Fabric является использование конфигураций запуска Eclipse.

1. В Eclipse перейдите к Запуск>Конфигурации запуска.

2. В разделе "Проект Gradle" выберите конфигурацию запуска ServiceFabricDeployer .

3. В правой панели на вкладке "Аргументы" убедитесь, что параметры ip, port, clientCert и clientKey заданы соответствующим образом для вашего развертывания. По умолчанию параметры устанавливаются для развертывания в локальном кластере, как показано на следующем снимке экрана. Чтобы опубликовать приложение в Azure, можно изменить параметры, чтобы содержать сведения о конечной точке и учетные данные безопасности для кластера Azure. Дополнительные сведения см. в предыдущем разделе: публикация приложения Service Fabric в Azure с помощью Eclipse.

   

4. Убедитесь, что рабочий каталог указывает на приложение, которое требуется развернуть. Чтобы изменить приложение, нажмите кнопку "Рабочая область " и выберите нужное приложение.

5. Нажмите кнопку "Применить" и нажмите кнопку "Выполнить".

Ваше приложение собирается и разворачивается в течение нескольких мгновений. Состояние развертывания можно отслеживать в Service Fabric Explorer.

Добавление службы Service Fabric в приложение Service Fabric

Чтобы добавить службу Service Fabric в существующее приложение Service Fabric, сделайте следующее:

1. Щелкните правой кнопкой мыши проект, к которому нужно добавить службу, и выберите Service Fabric.

   

2. Нажмите кнопку "Добавить службу Service Fabric" и выполните действия по добавлению службы в проект.

3. Выберите шаблон службы, который вы хотите добавить в проект, и нажмите кнопку "Далее".

   

4. Введите имя службы (и другие сведения, по мере необходимости), а затем нажмите кнопку "Добавить службу ".

   

5. После добавления службы общая структура проекта выглядит примерно так, как показано в следующем проекте:

   

Изменение версий манифеста приложения Java Service Fabric

Чтобы изменить версии манифеста, щелкните проект правой кнопкой мыши, перейдите в Service Fabric и выберите пункт "Изменить версии манифеста" в раскрывающемся меню. В мастере можно обновить версии манифеста для манифеста приложения, манифеста службы и версий для пакетов Code, Config и Data .

Если вы проверяете параметр Автоматическое обновление версий приложений и служб , а затем обновляете версию, то версии манифеста будут автоматически обновлены. Чтобы дать пример, сначала установите флажок, а затем обновите версию кода с 0.0.0.0 до 0.0.1 и нажмите кнопку "Готово", а затем автоматически обновляется версия манифеста службы и версия манифеста приложения до версии 0.0.1.

Обновление приложения Java Service Fabric

Для сценария обновления предположим, что вы создали проект App1 с помощью подключаемого модуля Service Fabric в Eclipse. Вы развернули его с помощью подключаемого модуля для создания приложения с именем fabric:/App1Application. Тип приложения — App1ApplicationType, а версия приложения — 1.0. Теперь вы хотите обновить приложение без прерывания доступности.

Сначала внесите изменения в приложение, а затем перестройте измененную службу. Обновите файл манифеста измененной службы (ServiceManifest.xml) с обновленными версиями службы (и Code, Config или Data, как это необходимо). Кроме того, измените манифест приложения (ApplicationManifest.xml) с обновленным номером версии приложения и измененной службой.

Чтобы обновить приложение с помощью Eclipse, можно создать повторяющийся профиль конфигурации запуска. Затем используйте его для обновления приложения по мере необходимости.

1. Перейдите к разделу "Запуск>конфигураций запуска". В левой области щелкните небольшую стрелку слева от проекта Gradle.
2. Щелкните правой кнопкой мыши ServiceFabricDeployer и выберите "Дублировать". Введите новое имя для этой конфигурации, например ServiceFabricUpgrader.
3. На правой панели на вкладке "Аргументы " измените -Pconfig='deploy" на -Pconfig='upgrade", а затем нажмите кнопку "Применить".

Этот процесс создает и сохраняет профиль конфигурации запуска, который можно использовать в любое время для обновления приложения. Он также получает последнюю обновленную версию типа приложения из файла манифеста приложения.

Обновление приложения занимает несколько минут. Обновление приложения можно отслеживать в Service Fabric Explorer.

Перенос старых приложений Java Service Fabric для использования с Maven

Недавно мы перенесли библиотеки Service Fabric Java из Java SDK в репозиторий Maven. Хотя новые приложения, которые вы создаете с помощью Eclipse, будут создавать последние обновленные проекты (которые смогут работать с Maven), вы можете обновить существующие безгосударственные или акторные приложения Java Service Fabric, которые ранее использовали Java SDK для Service Fabric, чтобы использовать зависимости Java Service Fabric из Maven. Выполните описанные здесь действия, чтобы убедиться, что ваше старое приложение работает с Maven.

Дальнейшие действия

• Краткие инструкции по созданию приложения надежной службы Java и его локальному развертыванию в Azure см. в кратком руководстве по развертыванию приложения Reliable Services Java.
• Сведения об отладке приложения Java в локальном кластере см. в статье Отладка службы Java в Eclipse.
• Сведения о том, как мониторить и диагностировать приложения Service Fabric, см. в разделе «Мониторинг и диагностика служб в локальной среде разработки».