Uygulamalarınızı Red Hat ™ OpenShift 4.x üzerinde devreye alma
Aşağıda, uygulamalarınızı bir Liberty kapsayıcısında ve OpenShift kümesinde devreye almak için Transformation Advisor geçiş yapay nesnelerinin nasıl kullanılacağı açıklanmaktadır.
Aşağıdakileri yapmak için seçeneğiniz vardır:
Tek bir uygulamanın konuşlandırılması
İkili proje
Aşağıdaki bölümde, ikili tabanlı bir projenin Red Hat™ OpenShift' e nasıl konuşlandırılacağı açıklanmaktadır. İkili proje için, uygulama ve bağımlılıklar için ikili dosyalar sağlamanız gerekir.
Uygulamanızı üç adımda yeni düzeye geçirebilirsiniz. Bu belge aşağıdaki değişkenlere gönderme yapacak:
<BINARY_FILE_LOCATION>, bağımlılıklar ve paylaşılan kitaplık dosyaları da içinde olmak üzere, uygulamanıza ilişkin ikili dosyaların yeridir.<APPLICATION_FILE>, uygulamanızın ikili dosyasıdır.<DEPENDENCY_FILE_LOCATION>, uygulamanızın gerektirdiği bağımlılıkların ve paylaşılan kitaplık dosyalarının konumudur.<APP_CONTEXT_ROOT>, uygulamanızın bağlam köküdür. Başka bir yerde (örneğin, ibm-web-ext-xml içinde) tanımlanmamışsa, bu, server.xmldosyasının<application>öğesindekinameözniteliğine karşılık gelir.<APPLICATION_NAME>, uygulamanın adıdır.<CONTAINER_ID>, docker görüntünüzü için kapsayıcı tanıtıcısıdır. Bu değeri almak için şunu girin: docker ps<IMAGE_REFERENCE>, kayıt defteri, havuz ve etiket de içinde olmak üzere bu görüntüye ilişkin başvurudur; örn. docker.io/myspace/myappimage:1.0.0<LIBERTY_HOME>, Liberty 'nin kurulduğu konumdur.<LIBERTY_MACHINE>, Liberty profilini kurduğunuz makinedir.<MIGRATION_ARTIFACTS_HOME>, Transformation Advisor yapay nesnelerini açtığınız ya da havuzu klonladığınız konumdur.<OCP_PROJECT>, uygulamayı kurmak istediğiniz OpenShift projesinin adıdır.
ADIM ONE: Java uygulamasını Liberty 'ye geçir
Bu adımda uygulamanızı yerel bir Liberty sunucusuna geçireceksiniz. Bu, uygulamanızın Liberty üzerinde doğru çalıştığını doğrulamanıza ve gerektiğinde yapılandırma değişiklikleri yapmanıza olanak sağlar. Uygulamanızın Liberty üzerinde çalıştığından emin olmak için test ettikten sonra uygulamanız için bir Liberty kapsayıcısı oluşturmaya hazır olacaksınız.
Adım 1 Önkoşulları
- Liberty kuruluşu
- WebSphere Liberty yazılımını buradan alabilirsiniz: https://www.ibm.com/support/knowledgecenter/SSEQTP_liberty/com.ibm.websphere.wlp.doc/ae/twlp_inst.html
Not: Uygulamanız Java EE6 özelliklerini gerektiriyorsa, Websphere Liberty - Open Liberty olanağını buradan alabilirsiniz:
https://openliberty.io/
- WebSphere Liberty yazılımını buradan alabilirsiniz: https://www.ibm.com/support/knowledgecenter/SSEQTP_liberty/com.ibm.websphere.wlp.doc/ae/twlp_inst.html
- Transformation Advisor ' dan karşıdan yüklediğiniz geçiş yapay nesnelerinin bir kopyası Liberty ürününü kurduğunuz makinede bulunur.
Adım 1 Görevleri
- Uygulama dosyanızı geçiş paketine ekleyin ve yer tutucu dosyasını kaldırın:
cp <BINARY_FILE_LOCATION>/<APPLICATION_FILE> <MIGRATION_ARTIFACTS_HOME>/target/
rm <MIGRATION_ARTIFACTS_HOME>/target/*.placeholder
- Bağımlılık dosyalarınızı geçiş paketine ekleyin ve yer tutucu dosyaları kaldırın:
cp <DEPENDENCY_FILE_LOCATION>/* <MIGRATION_ARTIFACTS_HOME>/src/main/liberty/lib
rm <MIGRATION_ARTIFACTS_HOME>/src/main/liberty/lib/*.placeholder
NOTE: The placeholder files provide the name(s) of all depednecies for your application
- Uygulamanızı çalıştırmak için Liberty kuruluşunda bir sunucu oluşturun:
cd <LIBERTY_HOME>/bin
./server create server1
- Geçiş yapay nesnelerinizin konumuna gidin ve hedef dizindeki uygulama ikili dosyasını (ear/war) Liberty 'nin uygulama dizinine kopyalayın:
cd <MIGRATION_ARTIFACTS_HOME>
cp target/*.war <LIBERTY_HOME>/usr/servers/server1/apps
- Önceden yoksa, dizini oluşturun
<LIBERTY_HOME>/usr/shared/config/lib/global
ve geçiş konumundan bu konuma ek ikililer kopyalayın:
mkdir -p <LIBERTY_HOME>/usr/shared/config/lib/global
cp src/main/liberty/lib/* <LIBERTY_HOME>/usr/shared/config/lib/global
- Gerekiyorsa, server.xml dosyasını güncelleyin:
- Transformation Advisor , geçiş paketi için server.xml dosyasını oluşturduğunda,
server.xmldosyasının sonunda boş bir varsayılan değerle hassas veriler değişkenler olarak çıkarılır. Değişken varsayılan değerlerinin uygun şekilde ayarlandığından emin olun. - Bu dosyada gerek duymadığınız başka ikililer varsa, bunlara ilişkin başvuruları kaldırın.
- Transformation Advisor , geçiş paketi için server.xml dosyasını oluşturduğunda,
NOT: Yalnızca server.xml dosyasında tanımlanan değişkenler için varsayılan değeri ayarlayın. Değer server.xml dosyasında ayarlanırsa, konuşlandırma sırasında geçersiz kılamaz.
- Oluşturulan server.xml dosyasını varsayılan server.xml:
cp src/main/liberty/config/server.xml <LIBERTY_HOME>/usr/servers/server1/server.xml
- Liberty sunucusunu başlat:
<LIBERTY_HOME>/bin/server start server1
- Uygulamanızın doğru şekilde başlatıldığını doğrulamak ve erişim için URL ' yi bulmak için Liberty günlüklerini denetleyin:
cd <LIBERTY_HOME>/usr/servers/server1/logs
vi messages.log
NOT: server.xml içinde varsayılan olarak Liberty 'de kurulu olmayan özellikler tanımlamış olabilirsiniz. Bunlar günlükte listelenir. Bu durumda, bin/featureUtility komutunu kullanarak gerekli özellikleri kurun.
NOT: server.xmldosyasında bir <dataSource> öğesi tanımlarsanız, şuna benzer bir kimlik doğrulama sorunuyla karşılaşabilirsiniz: invalid username/password; logon denied
Bu sorunu görürseniz, veri kaynağı özelliklerinizde kullanılan kimlik doğrulama veri değişkenleri için varsayılan değeri güncellemeniz gerekebilir.
- Günlüklerin şuna benzer bir satır içerdiğini doğrulayın: TCP Kanal defaultHttpUç noktası başlatıldı ve şimdi anasistem * (IPv6) kapısı 9080 üzerindeki istekleri dinliyor. Bunu görmüyorsanız, sunucu başlatılırken ya da uygulama başlatılırken bir sorun oluştu. Daha fazla ayrıntı için günlük dosyasında arama yapın ve buna göre hata ayıklayın.
- Aşağıdaki bağlantıya gidip tarayıcınızda uygulamanızı açın:
http://<LIBERTY_HOME_MACHINE_IP>:9080/<APP_CONTEXT_ROOT>
NOT: Geçiş yapay nesneleri, uygulamanızın geçişinde size yardımcı olur. Uygulamanızın niteliğine ve karmaşıklığına bağlı olarak, bu görevi tam olarak tamamlamak için ek yapılandırma gerekebilir. Örneğin, uygulamanızı bir kullanıcı kaydına bağlamak ve kullanıcı güvenlik rolü bağ tanımlarını yapılandırmak için ek yapılandırmayı tamamlamanız gerekebilir. Daha fazla ayrıntı için ürün belgelerine bakın.
ADıM İKİ: Liberty 'nin Konteynerini Kapın
Bu adımda, çalışan Liberty kurulumunuzu kapsayacaksınız. Geçişi yapılan uygulamanızın kurulu ve çalışır durumda olduğu bir Liberty görüntüsü oluşturacak ve daha sonra, resmin düzgün çalıştığını onaylamak için resmi test edeceksiniz.
NOTE: If you are using podman instead of docker simply replace the word docker in each command with podman
Adım 2 Önkoşulları
- Adım 1 'i tamamladınız: Java uygulamasını Liberty 'ye geçirin
- Docker ya da podman kurulu.
- Docker' ı karşıdan yükleyin: https://www.docker.com/get-started
- Podman 'ı karşıdan yükleyin: https://podman.io/getting-started/installation
- Bu görevi tamamladığınız makine, Liberty temel görüntüsünü karşıdan yüklemek için İnternet erişimi gerektirir.
Adım 2 Görevleri
- Gerekli kapıların kullanılabilir olduğundan emin olmak için çalışıyorsa Liberty sunucusunu durdurun:
<LIBERTY_HOME>/bin/server stop server1
- Docker kullanılıyorsa, docker hizmetinin çalıştığından emin olun. Değilse, başlat:
service docker start
- Geçiş yapay nesnelerinizin bulunduğu yere gidin ve docker dosyasından görüntünüzü oluşturun:
cd <MIGRATION_ARTIFACTS_HOME>
docker build --no-cache -t "<IMAGE_REFERENCE>" .
Not: Geçiş paketi, uygulamanın ve tüm bağımlılıkların Maven 'den çekilmesini sağlayan bir pom.xml dosyası içerir. Dockerfile 'da bu seçeneği etkinleştirmeniz ve pom.xml dosyasındaki yer tutucuları doğru değerlerle güncellemeniz gerekir. Bunun nasıl yapılacağına ilişkin ayrıntıları 'Maven kullanarak bağımlılık ekle' bölümünde bulabilirsiniz.
- Resmi çalıştırın ve düzgün çalıştığını onaylayın:
docker run -p 9080:9080 <IMAGE_REFERENCE>
- Her şey iyi görünüyorsa, görüntü başlatılmış ve 9080 kapısıyla eşlenmiştir. Bu bağlantıya tarayıcınızdan şu bağlantıyla erişebilirsiniz:
http://<LIBERTY_HOME_MACHINE_IP>:9080/<APP_CONTEXT_ROOT>İsteğe bağlı: Taşıyıcıda oturum açarak resmin çalışır durumda olup olmadığını denetleyin:
docker exec -ti <CONTAINER_ID> bash
Bu, uygulamanızın çalıştığı taşıyıcının dosya sistemine göz atmanızı sağlar.
ADıM Üç: Resiminizi Red Hat OpenShift ' e konuşlandırın
Bu adımda, oluşturduğunuz görüntüyü Red Hat OpenShift' e dağıtacaksınız. Bu yönergeler OpenShift 4 + ile ilgilidir ve OpenShift 4.12üzerinde doğrulanmıştır.
Adım 3 Önkoşulları
- Genel ya da özel Red Hat OpenShift 4 + ortamına erişim.
- Görüntü kaydı erişimi
- Geçirilen uygulama görüntünüzü OpenShift kümesi tarafından erişilebilen bir konuma göndermeniz gerekir. Genel kullanıma açık bir kayıt dosyası (örneğin, Dockerhub) ya da kendi özel kayıt defterinizi kullanabilirsiniz. Transformation Advisor tarafından oluşturulan geçiş yapıtları (özellikle application-cr.yaml dosyası), kullandığınız görüntü başvurusuyla güncellenmelidir. Uygun bir kayıt defteri yoksa, uygun bir kayıt dosyası bulununcaya kadar kullanmak üzere Dockerhub veya Podman içinde kendi kayıt defterinizi oluşturabilirsiniz.
- Dockerhub 'da kendi kayıt defterinizi nasıl oluşturacağınızı buradan bulabilirsiniz.
- Podman içinde kendi kayıt defterinizi nasıl oluşturacağınızı buradan bulabilirsiniz
- Geçirilen uygulama görüntünüzü OpenShift kümesi tarafından erişilebilen bir konuma göndermeniz gerekir. Genel kullanıma açık bir kayıt dosyası (örneğin, Dockerhub) ya da kendi özel kayıt defterinizi kullanabilirsiniz. Transformation Advisor tarafından oluşturulan geçiş yapıtları (özellikle application-cr.yaml dosyası), kullandığınız görüntü başvurusuyla güncellenmelidir. Uygun bir kayıt defteri yoksa, uygun bir kayıt dosyası bulununcaya kadar kullanmak üzere Dockerhub veya Podman içinde kendi kayıt defterinizi oluşturabilirsiniz.
- Transformation Advisor ' dan karşıdan yüklediğiniz geçiş yapay nesnelerinin bir kopyası Liberty ürününü kurduğunuz makinede bulunur.
- WebSphere Liberty Operatörü ya da Open Liberty Operatörü
- Uygulamanızı OpenShiftüzerinde WebSphere Liberty üzerinde devreye almak için öncelikle kümenizde WebSphere Liberty işlecini kurmuş olmanız gerekir.
- WebSphere Liberty işletmeni IBM Operator Catalog 'da bulunur. Operatör 'e git ...OperatorHub UI 'si ve IBM İşletmen Kataloğu
Source' nu tıklatın. WebSphere Liberty işlecini hızlı bir şekilde bulmak için aramayı kullanabilirsiniz. - WebSphere Liberty işletmen kullanıcı arabirimini tıklatın ve kuruluş yönergelerini izleyin.
- Size, WebSphere Liberty uygulamalarını tüm ad alanlarına kurabilecek işletmen kümesi çapında kuruluş seçeneği sunulur YA DA işleci belirli bir ad alanına kurmayı seçebilirsiniz. Tercihinize bağlı olarak her iki seçeneği de belirleyin.
- WebSphere Liberty işleciyle ilgili tüm ayrıntılar için lütfen buradanbelgelere bakın.
- IBM Operator Catalog ürününün kurulmasına ilişkin ayrıntılar için lütfen buradakibelgelere bakın.
- WebSphere Liberty işletmeni IBM Operator Catalog 'da bulunur. Operatör 'e git ...OperatorHub UI 'si ve IBM İşletmen Kataloğu
- Uygulamanızı OpenShiftüzerinde Open Liberty ' de devreye almak için öncelikle kümenizde Open Liberty (Açık Liberty) işlecini kurmuş olmanız gerekir.
- Open Liberty Operatörü, Sertifikalı Katalog 'da kullanılabilir. Operatör 'e git ...OperatorHub UI 'ını ve Sertifikalı
Source' yı tıklatın. Open Liberty işlecini hızlı bir şekilde bulmak için aramayı kullanabilirsiniz. - Open Liberty işletmen kullanıcı arabirimini tıklatın ve kuruluş yönergelerini izleyin.
- Size, tüm ad alanlarına Open Liberty uygulamalarını kurabilecek işletmen kümesi çapında kuruluş seçeneği sunulur YA DA işleci belirli bir ad alanına kurmayı seçebilirsiniz. Tercihinize bağlı olarak her iki seçeneği de belirleyin.
- Open Liberty işleciyle ilgili tüm ayrıntılar için lütfen belgelere geliyor gelen sa gelen sa unun
- Open Liberty Operatörü, Sertifikalı Katalog 'da kullanılabilir. Operatör 'e git ...OperatorHub UI 'ını ve Sertifikalı
- Uygulamanızı OpenShiftüzerinde WebSphere Liberty üzerinde devreye almak için öncelikle kümenizde WebSphere Liberty işlecini kurmuş olmanız gerekir.
Adım 3 Görevleri
Uygulama görüntünüzü OpenShift kümesi tarafından erişilebilen bir kayıt dosyasına itin. örn.
docker push <IMAGE_REFERENCE>burada
<IMAGE_REFERENCE>, resmi oluştururken etiketlediğiniz resim başvurusudur, örn.docker.io/myspace/myappimage:1.0.0Not:
- Başarılı bir şekilde iletmek için o görüntü kaydında oturum açmanız gerekebilir.
- Kayıt defteriniz doğrulanmış çekmeler gerektiriyorsa, kümenizi bir çekme güvenlik dizgisi ile ayarlamanız gerekir. Daha fazla bilgi için bkz. docs .
OpenShift kümesinde oturum açın ve OpenShift' de yeni bir proje oluşturun.
oc login -u <USER_NAME>Liberty işlecini kurarken önceden bir ad alanı oluşturmadıysanız, şimdi bir ad alanı oluşturun.
oc new-project <OCP_PROJECT>Aşağıdaki yönergeleri kullanarak görüntüye eşlik eden işleciyle birlikte yerleştirin:
a.
<MIGRATION_ARTIFACTS_HOME>içinde kustomize dizinine geçin:cd <MIGRATION_ARTIFACTS_HOME>/deploy/kustomizeb.
base/application-cr.yamldosyasındaki IMAGE_REFERENCE öğesini, Görev 1 'de gönderdiğiniz uygulama görüntüsü başvurusuyla eşleşecek şekilde güncelleyin.c.
base/<APPLICATION_NAME>-configmap.yamldosyasında tanımlanan değerin doğru olup olmadığını denetleyin.d. Duyarlı tarihe ilişkin değeri eklemek için
overlays/dev/<APPLICATION_NAME>-secret.yamldosyasını güncelleyin. Değerin base64 kodlanmış olması gerekir. Hassas verilerinize ilişkin kodlanmış dizgiyi almak içinecho -n 'your-secret-password' | base64komutunu çağırabilirsiniz.e. kustomization.yaml: içeren bir dizin belirtmek için
apply -kkomutunu kullanarak Liberty uygulamanız için özel kaynak (CR) oluşturun.oc apply -k overlays/devf. Oc get konuşlandırmalarını çalıştırarak dağıtımınızın durumunu görüntüleyebilirsiniz. Durumu birkaç dakika sonra görmüyorsanız, bölme bölmesini sorgulayın ve Liberty pod günlüklerini getirin:
oc get pods oc logs <pod>g. Artık OpenShift içindeki
Networking...RoutesUI ' ye giderek ve devreye aldığınız ad alanını seçerek uygulamanıza erişebilirsiniz.İsteğe bağlı: Uygulamanızı OpenShift' den silmek istiyorsanız, OpenShift UI 'sini kullanarak kaldırabilirsiniz. Liberty işlecini bulmak için OpenShift içindeki
Operators...Installed operatorsöğesine gidin. Uygulama eşgörünümünüzü bulmak ve gerektiği şekilde kaldırmak içinAll instancesetiketini tıklatın.
Maven kullanarak bağımlılık ekle
Genel Bakış
Geçiş paketi, uygulamanın ve tüm bağımlılıkların Maven 'den çekilmesini sağlayan bir pom.xml dosyası içeriyor. Dockerfile 'da bu seçeneği etkinleştirmeniz ve pom.xml dosyasındaki yer tutucuları doğru değerlerle güncellemeniz gerekir.
Görevler
- Geçiş paketine git
cd <MIGRATION_ARTIFACTS_HOME> - pom.xml dosyasını düzenleyin ve yer tutucu değerlerini uygun değerlerle güncelleyin
<dependency>öğesi için doğru değerleri ayarlayın<artifactItem>öğelerinin
her biri için doğru değerleri ayarlayın
- Dockerfile dosyasını düzenleyerek, resim oluşturma sırasında bağımlılıkların çekilmesini sağlar
RUN mvn -X initialize process-resources verifysatırını açıklama satırı olmaktan çıkar
Kaynak proje
Genel Bakış
Bir uygulamayı geçirirken, yeni hedef altyapıya başarılı bir geçiş sağlamak için genellikle kaynak kodda değişiklik yapmanız gerekir. Değişikliklerin tam türü uygulamadan uygulamaya değişir. Transformation Advisor , her bir uygulama için gerekli değişiklikleri raporlar ve kod değişiklikleri gerektiren uygulamaları Orta ya da Karmaşık olarak sınıflandırır. Kodda bu değişikliklerin tam olarak nerede yapılması gerektiğini saptamak için WebSphere Application Migration Toolkit (WAMT) Eclipse eklentisini kullanabilirsiniz. Araç olası düzeltmeleri de önerebilir. Daha fazla ayrıntı için bu bağlantıya bakın: https://developer.ibm.com/wasdev/downloads/#asset/tools-WebSphere_Application_Server_Migration_Toolkit
Aşağıdaki görevler, kaynak kodunuzu bir görüntüye oluşturmanıza yardımcı olur.
Görevler
- Geçiş paketine git
cd <MIGRATION_ARTIFACTS_HOME> - pom.xml dosyasını düzenleyin ve yer tutucu değerlerini uygun değerlerle güncelleyin ya da silin.
<dependency>öğesi için doğru değerleri ayarlayın<artifactItem>öğelerinin
her biri için doğru değerleri ayarlayın
- Uygulamayı belirtimlerinize göre oluşturmak için pom.xml dosyasını güncelleyin
- NOT: Uygulamanız için zaten bir pom.xml varsa, bunu kullanabilir ya da uygun şekilde pom.xml geçiş paketiyle birleştirebilirsiniz
- NOT: Uygulamanız için zaten bir pom.xml varsa, bunu kullanabilir ya da uygun şekilde pom.xml geçiş paketiyle birleştirebilirsiniz
- Görüntü oluşturma sırasında kaynak kodun oluşturulacağı şekilde Dockerfile 'ı düzenleyin
RUN mvn clean packagesatırını açıklama satırı olmaktan çıkar
Bir kümenin ya da uygulama grubunun konuşlandırılması
Bu bölümde, birden çok uygulamayı tek bir Liberty kapsayıcısında devreye almak için bir kümeye ya da gruba ilişkin geçiş paketinin nasıl kullanılacağı açıklanmaktadır.
Her bir uygulamayı önce tek tek geçirip sonra tek bir konuşlandırmada birleştirebilir ya da bunların tümünü tek bir ilk adım olarak aynı anda konuşlandırabilirsiniz.
Bir kümeyi yeni düzeye geçiriyorsanız, uygulamalarınız arasında bir özellik çakışması olması olası değildir. Bu durumda "Bir defada tüm uygulamalar yaklaşımı" kümenizi geçirmek için en hızlı yaklaşım olacaktır.
Bir grubu yeni düzeye geçiriyorsanız, uygulamalar daha önce birlikte çalışmamış olabileceğinden, uygulamalar birlikte konuşlandırılırken bir özellik çakışması olma olasılığınız daha yüksektir. "Bir kerede tüm uygulamalar" yaklaşımını kullanmanız önerilir, ancak sorunlarla karşılaşırsanız, bunları çözmek için "Uygulamaya göre uygulama" yaklaşımını kullanmanız önerilir.
Tüm uygulamalar aynı anda
Tüm uygulamalarınızı üç adımda geçirebilirsiniz. Bu belge aşağıdaki değişkenlere gönderme yapacak:
<APP_CONTEXT_ROOT>, uygulamanızın bağlam köküdür. Başka bir yerde (örneğin, ibm-web-ext-xml içinde) tanımlanmamışsa, bu, server.xmldosyasının<application>öğesindekinameözniteliğine karşılık gelir.<APPLICATION_NAME>, uygulamanın adıdır.<MIGRATION_ARTIFACTS_HOME>, Transformation Advisor yapay nesnelerini açtığınız ya da havuzu klonladığınız konumdur.<IMAGE_REFERENCE>, kayıt defteri, havuz ve etiket de içinde olmak üzere bu görüntüye ilişkin başvurudur; örn. docker.io/myspace/myappimage:1.0.0
ADIM ONE: Uygulamaları ve bağımlılık dosyalarını toplayın ve yapılandırmayı güncelleyin
Bu adımda uygulama dosyalarınızı ve bağımlılıkları toplayacak ve yapılandırma dosyalarını güncelleyeceksiniz.
Adım 1 Görevleri
- Uygulama dosyalarınızı geçiş paketine ekleyin ve yer tutucu dosyalarını kaldırın:
cp <BINARY_FILE_LOCATION>/<APPLICATION_FILE> <MIGRATION_ARTIFACTS_HOME>/target/ rm <MIGRATION_ARTIFACTS_HOME>/target/*.placeholder - Bağımlılık dosyalarınızı geçiş paketine ekleyin ve yer tutucu dosyaları kaldırın:
cp <DEPENDENCY_FILE_LOCATION>/* <MIGRATION_ARTIFACTS_HOME>/src/main/liberty/lib rm <MIGRATION_ARTIFACTS_HOME>/src/main/liberty/lib/*.placeholderNOTE: The placeholder files provide the name(s) of all dependencies for your application
NOTE: If you are using maven to import your application and dependencies you can skip task 1 & 2 of this step - Gerekiyorsa, server.xml dosyalarını güncelleyin:
<MIGRATION_ARTIFACTS_HOME>/src/main/liberty/configadresindeki server.xml dosyası, her uygulama için server.xml dosyalarını içeren bir dizi içerme içerir.- server.xml uygulama dosyaları şu konumlarda bulunabilir:
<MIGRATION_ARTIFACTS_HOME>/apps/<APPLICATION_NAME>/src/main/liberty/config - Her uygulama için server.xml dosyasının adı
<APPLICATION_NAME>_server_config.xmlolacaktır. - Transformation Advisor ' ın kaldırdığı hassas veriler için varsayılan değerleri girerek her server.xml dosyasını değiştirin.
- Gerek duymadığınız server.xml dosyasında listelenen ek ikililer varsa, bunlara yönelik başvuruları kaldırın.
NOT: Yalnızca server.xml dosyasında tanımlanan değişkenler için varsayılan değeri ayarlayın. Değer server.xml dosyasında ayarlanırsa, konuşlandırma sırasında geçersiz kılamaz.
ADıM İKİ: Liberty üzerindeki tüm uygulamaları konteynerle taşıma
Bu adımda, çalışan Liberty kurulumunuzu kapsayacaksınız. Taşınan tüm uygulamalarınızın kurulu ve çalışır durumda olduğu bir Liberty görüntüsü oluşturacak ve daha sonra, resmin doğru çalıştığını onaylamak için resmi test edeceksiniz.
NOTE: If you are using podman instead of docker simply replace the word docker in each command with podman
Adım 2 Önkoşulları
- Adım 1 'i tamamladınız: Uygulamaları ve bağımlılık dosyalarını toplayın ve yapılandırmayı güncelleyin
- Docker ya da podman kurulu.
- Docker' ı karşıdan yükleyin: https://www.docker.com/get-started
- Podman 'ı karşıdan yükleyin: https://podman.io/getting-started/installation
- Bu görevi tamamladığınız makine, Liberty temel görüntüsünü karşıdan yüklemek için İnternet erişimi gerektirir.
Adım 2 Görevleri
- Docker kullanılıyorsa, docker hizmetinin çalıştığından emin olun. Değilse, başlat:
service docker start
- Geçiş yapay nesnelerinizin bulunduğu yere gidin ve docker dosyasından görüntünüzü oluşturun:
cd <MIGRATION_ARTIFACTS_HOME>
docker build --no-cache -t "<IMAGE_REFERENCE>" .
Not: Geçiş paketi, uygulamanın ve tüm bağımlılıkların Maven 'den çekilmesini sağlayan bir pom.xml dosyası içerir. Dockerfile 'da bu seçeneği etkinleştirmeniz ve pom.xml dosyasındaki yer tutucuları doğru değerlerle güncellemeniz gerekir. Bunun nasıl yapılacağına ilişkin ayrıntıları 'Maven kullanarak bağımlılık ekle' bölümünde bulabilirsiniz.
- Resmi çalıştırın ve düzgün çalıştığını onaylayın:
docker run -p 9080:9080 <IMAGE_REFERENCE>
Her şey iyi görünüyorsa, görüntü başlatılmış ve 9080 kapısıyla eşlenmiştir.
Bu bağlantıya tarayıcınızdan erişebilirsiniz:http://<LIBERTY_HOME_MACHINE_IP>:9080/>Her bir uygulamayı
http://<LIBERTY_HOME_MACHINE_IP>:9080/<APP_CONTEXT_ROOT>
adresinde bulabilirsiniz.İsteğe bağlı: Taşıyıcıda oturum açarak resmin çalışır durumda olup olmadığını denetleyin:
docker exec -ti <CONTAINER_ID> bash
Bu, uygulamalarınızın çalıştığı taşıyıcının dosya sistemine göz atmanızı sağlar.
ADıM Üç: Resiminizi tüm uygulamalarla Red Hat OpenShift ' e dağıtın
Bu adımda, oluşturduğunuz görüntüyü Red Hat OpenShift' e dağıtacaksınız. Bu yönergeler OpenShift 4 + ile ilgilidir ve OpenShift 4.12üzerinde doğrulanmıştır. Resmin tek bir uygulaması varmış gibi aynı adımları izleyin- buraya bakın
Uygulamaya göre ikili proje-uygulama
Bu yaklaşımda, her bir uygulamayı tek tek yapılandırır, bulundurur ve devreye alır ve sonra bunları birlikte dağıtırsınız
Görevler
- Her bir uygulama için 'Tek bir uygulamayı devreye alma' adımlarını tamamlayın.
cd <MIGRATION_ARTIFACTS_HOME>/apps
Deploy each application indvidually
- Şimdi bu adımları
izleyerek tüm uygulamaları birlikte devreye alın
NOT: Uygulamaları birlikte konuşlandırdığınızda bir özellik çakışması olabilir. Bu durumda, çakışmaya neden olan uygulamaları başka bir devreye alıma taşımanız ya da artık çakışan özellikler gerektirmeyecek şekilde uygulamaları güncellemeniz gerekir.
Konuşlandırma sırasında anahtar depolarının yönetilmesi
When deploying to OpenShift, if your application is configured to use non default keystores then the default route will not work without configuration changes
Taşıyıcıda anahtar depolarının yapılandırılması
NOT: OpenShift ' e dağıtmayı planlıyorsanız, gerekli sertifikaları oluşturmak için Operatörü kullanabilirsiniz, ayrıntılar için sonraki bölüme bakın.
Transformation Advisor , geçiş paketindeki anahtar deposu bilgilerini otomatik olarak geçirmez.
Transformation Advisor tarafından üretilen varsayılan Dockerfile kullanılarak bir kapsayıcıda çalışırken Liberty sunucusu, varsayılan olmayan anahtar deposu dosyalarının bulunamadığını belirten iletiler görüntüler.
Liberty sunucusunda anahtar depolarının yapılandırılmasına ilişkin yönergeler için bkz. Liberty Güvenlik belgelerini yapılandırma
OpenShift devreye alımında anahtar depolarını yapılandırma
OpenShift ' e devreye alırken, tüm gerekli sertifikaları oluşturmak ya da kendi sertifikalarınızı kullanmak için Liberty Operatörü 'ni kullanabilirsiniz.
Sertifika oluşturmak için Liberty İşlecini kullanma
Uygulamanıza ilişkin sertifikaları oluşturmak üzere Liberty İşletmeni 'ni kullanmak için aşağıdaki adımları tamamlayın
server.xmldosyasını değiştirin ve tüm<keystore>özniteliklerini kaldırın.- Görüntüyü normal şekilde oluşturun ve devreye alın
Bu durumda, tüm sertifikasyon oluşturma ve anahtar deposu yönetimi İşletmen tarafından işlenecektir.
Buna ilişkin daha fazla ayrıntı Liberty belgelerinde
OpenShift ' te kendi sertifikanızı ve anahtar depolarınızı kullanma
Konuşlandırmanızı kendi sertifikalarınızı kullanacak ve güvenliği kendiniz yönetecek şekilde yapılandırabilirsiniz.
Buna ilişkin daha fazla ayrıntı, sertifikaların belirtilmesine ilişkin Liberty belgelerinde bulunabilir
.