Enterprise Distributed Application Service：Buat gambar aplikasi

Catatan penggunaan

Kunjungi GitHub untuk melihat contoh Dockerfile dan gambar yang digunakan dalam topik ini.

Spesifikasi dan batasan

Sebelum menggunakan Dockerfile untuk membuat gambar aplikasi EDAS, pastikan spesifikasi berikut terpenuhi dan perhatikan batasan yang ada:

• Informasi Layanan

  Informasi layanan mencakup nama domain EDAS dan port yang digunakan untuk terhubung selama runtime.

  Tabel 4. Sumber Daya

  Jenis sumber daya	Nama sumber daya	Deskripsi
  ConfigMap	edas-envs	Informasi layanan EDAS.

  Tabel 5. Variabel Lingkungan

  Kunci variabel lingkungan	Tipe	Deskripsi
  EDAS_ADDRESS_SERVER_DOMAIN	String	Nama domain atau alamat IP layanan pusat konfigurasi.
  EDAS_ADDRESS_SERVER_PORT	String	Port layanan pusat konfigurasi.
  EDAS_CONFIGSERVER_CLIENT_PORT	String	Port layanan ConfigServer.

• Diperlukan: Variabel lingkungan selama runtime aplikasi

  EDAS menyediakan variabel lingkungan saat Anda menyebarkan aplikasi untuk memastikan aplikasi berjalan sesuai harapan. Kami sarankan agar Anda tidak menimpa pengaturan variabel lingkungan. Untuk informasi lebih lanjut, lihat Lampiran: Variabel Lingkungan selama Runtime.

Buat Dockerfile standar

Dockerfile adalah file konfigurasi teks yang digunakan untuk membuat gambar secara efisien.

Gunakan Dockerfile untuk membuat gambar untuk High-speed Service Framework (HSF), Spring Cloud, atau aplikasi Dubbo sesuai kebutuhan bisnis Anda. Contoh berikut menjelaskan cara membuat Dockerfile untuk aplikasi dengan framework berbeda.

EDAS menyediakan Dockerfile standar yang mencakup semua instruksi untuk membangun lingkungan runtime aplikasi di EDAS. Instruksi ini membantu Anda memahami cara mengunduh, menginstal, dan menjalankan komponen seperti OpenJDK, Tomcat, serta paket WAR dan JAR. Anda dapat memodifikasi Dockerfile sesuai kebutuhan, misalnya mengganti versi OpenJDK, menyesuaikan konfigurasi Tomcat, atau mengubah lingkungan runtime. Untuk informasi lebih lanjut tentang OpenJDK, lihat Gambar Kustom: Gunakan OpenJDK Terbaru.

Untuk informasi lebih lanjut tentang Dockerfile, lihat bagian berikut:

• Contoh Dockerfile untuk Aplikasi HSF

• Contoh Dockerfile untuk Aplikasi Spring Cloud atau Dubbo

Contoh Dockerfile untuk aplikasi HSF

# Menggunakan centos7 + openjdk8 + ali tomcat7 + pandora 3.5.9 sebagai dasar
FROM apaas-registry.cn-hangzhou.cr.aliyuncs.com/apaas/edas-centos-openjdk8-alitomcat7:latest
MAINTAINER Tim EDAS Alibaba Cloud<edas-**@list.alibaba-inc.com>

ENV TZ="Asia/Shanghai"

# Secara default letakkan paket aplikasi Anda di /home/admin/app/
ENV APP_HOME /home/admin/app/

#####----> Kasus pertama: deploy file fat-jar 
ARG APP_LOCATION=https://edas-hz.oss-cn-hangzhou.aliyuncs.com/prod/demo/HSF_PROVIDER.jar

#####----> Kasus kedua: deploy file war, cukup ubah nama file yang diinginkan.
#ARG APP_LOCATION=https://edas-hz.oss-cn-hangzhou.aliyuncs.com/prod/demo/HSF_PROVIDER.war

#####----> Kasus ketiga: deploy file dari penyimpanan lokal.
#ARG APP_LOCATION=/Users/yanliang.lyl/workspace/java/demo/HSF_PROVIDER.war

# Lalu unduh paket ke /home/admin/app/
ADD ${APP_LOCATION} ${APP_HOME}/

# Direktori kerja default diatur ke /home/admin
# WORKDIR /home/admin

# Titik masuk diatur ke /home/admin/bin/start.sh, 
# yang termasuk di dalam image dasar (apaas/edas-centos-openjdk8-alitomcat8)
# CMD ["/home/admin/bin/start.sh"]             

Contoh Dockerfile untuk aplikasi Spring Cloud atau Dubbo

# Menggunakan centos7 + openjdk8 + tomcat8 sebagai dasar
FROM apaas-registry.cn-hangzhou.cr.aliyuncs.com/apaas/edas:latest

# Secara default letakkan paket aplikasi Anda di /home/admin/app/
ENV APP_HOME /home/admin/app/

##### GANTI FILE PAKET ANDA SECARA SEDERHANA
#####----> Kasus pertama: deploy file fat-jar 
ARG APP_LOCATION=https://edas-hz.oss-cn-hangzhou.aliyuncs.com/prod/demo/DUBBO_PROVIDER.jar

#####----> Kasus kedua: deploy file war, cukup ubah nama file yang diinginkan.
#ARG APP_LOCATION=https://edas-hz.oss-cn-hangzhou.aliyuncs.com/prod/demo/DUBBO_PROVIDER.war

#####----> Kasus ketiga: deploy file dari penyimpanan lokal.
#ARG APP_LOCATION=/Users/yanliang.lyl/workspace/java/demo/SPRINT_CLOUD_PROVIDER.war

# Lalu unduh paket ke /home/admin/app/
ADD ${APP_LOCATION} ${APP_HOME}/
            

Deskripsi gambar dasar EDAS

Gunakan salah satu gambar dasar berikut sesuai dengan lingkungan runtime aplikasi Anda.

Untuk gambar lainnya, kunjungi repositori gambar resmi aPaaS Docker Hub. Jika Anda memerlukan gambar dasar tambahan, bergabunglah dengan grup DingTalk (ID: 31723701) untuk mendapatkan dukungan teknis. Untuk pertanyaan tentang gambar dasar, lihat Dockerfile gambar dasar di GitHub.

Gambar kustom: Gunakan OpenJDK terbaru

Anda dapat menentukan pengaturan kustom dalam Dockerfile standar sesuai kebutuhan bisnis Anda.

Tingkatkan OpenJDK: Unduh dan instal OpenJDK terbaru di Dockerfile. Contoh berikut menunjukkan cara mengunduh dan menginstal OpenJDK 9.

# Uninstall OpenJDK versi sebelumnya, lalu unduh dan instal OpenJDK 9.
RUN yum erase -y java; yum -y install java-1.9.0-openjdk-devel            

Gambar kustom: Tingkatkan versi Kontainer EDAS untuk aplikasi HSF

Untuk aplikasi HSF yang disebarkan di kluster Container Service for Kubernetes (ACK), tingkatkan versi Kontainer EDAS untuk menggunakan fitur baru middleware atau memperbaiki masalah yang mungkin terjadi di versi sebelumnya. Ikuti langkah-langkah berikut:

1. Masuk ke .

2. Di panel navigasi kiri, pilih Application Management > Applications.

3. Di halaman Applications, klik Create Application. Di bagian Application Runtime Environment dari langkah Basic Information, konfigurasikan parameter Pandora Version dan Ali-Tomcat Version.

4. Ganti nomor versi di Dockerfile, seperti 3.5.4.

   # Tentukan versi Pandora.
   ENV UPGRADED_CONTAINER_VERSION 3.5.4        
   RUN /home/admin/bin/upgradecontainer.sh            

5. Buat dan publikasikan gambar aplikasi lagi.

Gambar kustom: Ubah parameter startup JVM di dalam gambar

Variabel lingkungan JAVA_OPTS digunakan untuk mengoper parameter Java Virtual Machine (JVM) berdasarkan gambar dasar. Contoh berikut menunjukkan cara memodifikasi parameter startup JVM:

FROM apaas-registry.cn-hangzhou.cr.aliyuncs.com/apaas/edas:latest
# Konfigurasikan parameter JVM ENV 
    JAVA_OPTS="\
     -Xmx3550m \
     -Xms3550m \
     -Xmn2g \
     -Xss128k" 

Gambar kustom: Ubah konfigurasi aplikasi Spring Boot

Untuk aplikasi FatJar yang dikembangkan berdasarkan gambar dasar EDAS, Anda dapat memodifikasi konfigurasi startup Tomcat, seperti path konteks, port startup, dan parameter lainnya. Parameter ini diteruskan melalui variabel lingkungan APP_ARGS. Contoh berikut menunjukkan cara memodifikasi konfigurasi startup:

FROM apaas-registry.cn-hangzhou.cr.aliyuncs.com/apaas/edas:latest

# Konfigurasi default di gambar dasar:
#    - Path konteks (/) digunakan. 
#    - Pengkodean URI seragam (URI) dalam ISO-8859-1 digunakan.
#    - Aplikasi dimulai pada port 8080. 
#    - Jumlah maksimum kolam thread yang digunakan oleh Tomcat adalah 400.

# Anda juga dapat menulis ulang variabel lingkungan APP_ARGS untuk memodifikasi konfigurasi default. Contoh:
              ENV APP_ARGS="--server.context-path=/  \
              --server.tomcat.uri-encoding=ISO-8859-1 \
              --server.port=8080 \
              --server.tomcat.max-threads=400"

Bangun gambar lokal

1. Akses direktori tempat Dockerfile berada menggunakan alat baris perintah lokal. Jalankan salah satu perintah docker build berikut untuk membangun gambar:

   docker build -t [Nama label, sebaiknya nama aplikasi]:[Versi].
   docker build -t [Nama label, sebaiknya nama aplikasi]:[Versi] -f /path/to/custom_dockerfile_name. # Perintah ini berlaku jika Dockerfile yang Anda buat berada di lokasi lain atau nama file bukan Dockerfile.

   Contoh:

   docker build -t hsf-provider:1.0.0 .            

2. Kemudian, jalankan perintah docker images | grep <Nama label gambar> untuk melihat gambar lokal yang telah dibungkus.

Unggah gambar ke repositori gambar

Unggah gambar aplikasi yang dibuat dan dibangun di komputer lokal Anda ke repositori gambar kontainer Alibaba Cloud.

Untuk mengunggah gambar lokal ke repositori gambar, jalankan perintah yang digunakan untuk mendorong gambar ke Container Registry. Anda dapat melihat perintah-perintah ini di halaman Details dari repositori gambar tertentu.

docker login --username=[Nama pengguna saat ini] registry.[region_id].aliyuncs.com     # Masukkan kata sandi tetap atau sementara yang digunakan sebagai kredensial akses untuk instance default di Container Registry. Kata sandi ini bukan kata sandi untuk Akun Alibaba Cloud Anda. docker tag [ID gambar aplikasi lokal] registry.[region_id].aliyuncs.com/[Nama namespace]/[Nama repositori]:[Versi gambar]
docker push registry.[region_id].aliyuncs.com/[Nama namespace]/[Nama repositori]:[Versi gambar]            

Contoh:

docker login --username=td****@gmail.com registry.cn-hangzhou.aliyuncs.com
docker tag 2b64f63601a7 registry.cn-hangzhou.aliyuncs.com/webapps/hsf-provider:1.0.0
docker push registry.cn-hangzhou.aliyuncs.com/webapps/hsf-provider:1.0.0            

Untuk mempercepat jaringan repositori gambar Alibaba Cloud, ikuti langkah-langkah berikut: Masuk ke konsol Container Registry. Di panel navigasi kiri, klik Image Tool. Kemudian, klik Image Accelerator. Di halaman Image Accelerator, peroleh nilai parameter Booster URL.

Lampiran: Variabel lingkungan selama runtime

Jika Anda membuat gambar kustom menggunakan Dockerfile, variabel lingkungan tertentu secara otomatis digunakan oleh EDAS selama runtime. Tabel berikut menjelaskan variabel lingkungan ini.

Kami sarankan Anda tidak menggunakan file /home/admin/.spas_key/default. File ini ditimpa saat pod berjalan.