Cara Menjalankan Aspose.Words di Docker

Layanan mikro, bersama dengan containerisasi, memungkinkan penggabungan teknologi dengan mudah. Docker memungkinkan Anda dengan mudah mengintegrasikan fungsionalitas Aspose.Words ke dalam aplikasi Anda, apa pun teknologi yang ada dalam tumpukan pengembangan Anda.

Jika Anda menargetkan layanan mikro, atau jika teknologi utama dalam tumpukan Anda bukan .NET, C++, atau Java, tetapi Anda memerlukan fungsionalitas Aspose.Words, atau jika Anda sudah menggunakan Docker di tumpukan Anda, maka Anda mungkin tertarik untuk menggunakan Aspose.Words dalam Docker wadah.

Prasyarat

• Docker harus diinstal pada sistem Anda. Untuk informasi tentang cara menginstal Docker di Windows atau Mac, lihat tautan di bagian “Lihat Juga”.

• Perhatikan juga bahwa Visual Studio 2017, .NET Core 2.2 SDK digunakan dalam contoh yang disediakan di bawah ini.

Halo Aplikasi Dunia

Dalam contoh ini, Anda membuat aplikasi konsol Hello World sederhana yang membuat pesan “Hello World!” dokumen dan menyimpannya dalam semua format penyimpanan yang didukung. Aplikasi kemudian dapat dibangun dan dijalankan di Docker.

Membuat Aplikasi Konsol

Untuk membuat program Hello World, ikuti langkah-langkah di bawah ini:

1. Setelah Docker terinstal, pastikan Docker menggunakan Linux Containers (default). Jika perlu, pilih opsi Beralih ke wadah Linux dari menu Docker Desktops.
2. Di Visual Studio, buat aplikasi konsol .NET Core.
   
   
3. Instal versi Aspose.Words terbaru dari NuGet. SkiaSharp akan diinstal sebagai ketergantungan Aspose.Words.
   
   
4. Karena aplikasi akan dijalankan di Linux, aset Linux asli yang sesuai harus diinstal. Mulailah dengan gambar dasar Debian dan instal SkiaSharp.NativeAssets.Linux.
5. Ketika semua dependensi yang diperlukan telah ditambahkan, tulislah sebuah program sederhana yang menciptakan pesan “Hello World!” mendokumentasikan dan menyimpannya dalam semua format penyimpanan yang didukung:
   

Perhatikan bahwa folder “TestOut” ditentukan sebagai folder keluaran untuk menyimpan dokumen keluaran. Saat menjalankan aplikasi di Docker, folder di mesin host akan dipasang ke folder ini di dalam container. Ini akan memungkinkan Anda dengan mudah melihat keluaran yang dihasilkan oleh Aspose.Words di penampung Docker.

Mengonfigurasi Dockerfile

Langkah selanjutnya adalah membuat dan mengkonfigurasi Dockerfile.

1. Buat Dockerfile dan letakkan di sebelah file solusi aplikasi Anda. Pertahankan nama file ini tanpa ekstensi (default).
2. Di Dockerfile, tentukan:

FROM mcr.microsoft.com/dotnet/core/sdk:2.2
WORKDIR /app
RUN apt-get update && apt-get install -y libfontconfig1
COPY . ./
RUN dotnet publish -c Release -o out
ENTRYPOINT ["dotnet", "Aspose.Words.Docker.Sample/out/Aspose.Words.Docker.Sample.dll"]

Di atas adalah Dockerfile sederhana, yang berisi instruksi berikut:

• Gambar SDK yang akan digunakan. Ini dia gambar .NET Core SDK 2.2. Docker akan mendownloadnya saat build dijalankan. Versi SDK ditentukan sebagai tag.
• Direktori kerja, yang ditentukan pada baris berikutnya.
• Perintah untuk menginstal libfontconfig1 dijalankan di container. Ini diperlukan oleh SkiaSharp.
• Perintah untuk menyalin semuanya ke container, mempublikasikan aplikasi, dan menentukan titik masuk.

Membangun dan Menjalankan Aplikasi di Docker

Kini aplikasi dapat dibangun dan dijalankan di Docker. Buka command prompt favorit Anda, ubah direktori ke folder dengan aplikasi (folder tempat file solusi dan Dockerfile ditempatkan) dan jalankan perintah berikut:

docker build -t awtest .

Pertama kali perintah ini dijalankan mungkin memerlukan waktu lebih lama, karena Docker perlu mengunduh gambar yang diperlukan. Setelah perintah sebelumnya selesai, jalankan perintah berikut:

docker run --mount type=bind,source=C:\Temp,target=/TestOut --rm awtest from Docker

Perhatikan argumen mount, karena seperti yang disebutkan sebelumnya, folder di mesin host dipasang ke folder container, untuk melihat hasil eksekusi aplikasi dengan mudah. Jalur di Linux peka huruf besar-kecil.

Gambar Mendukung Aspose.Words

Aspose.Words tersedia untuk .NET Framework dan .NET Core. Gambar .NET Core berukuran jauh lebih kecil dibandingkan gambar .NET Framework, sehingga menjadikan .NET Core pilihan yang lebih baik untuk membuat layanan mikro dan untuk digunakan dalam container. Dimungkinkan untuk menyebarkan aplikasi ke wadah Linux Docker (untuk penerapan lintas platform), yang lebih ringan dari wadah Windows.

Gambar resmi untuk .NET Core SDK disediakan untuk:

• Debian 9 dan 10
• Ubuntu 18.04 dan 19.04
• Alpine 3.7 dan 3.9
• Windows Nano Server

Untuk bekerja dengan grafis, Aspose.Words untuk .NET Standard bergantung pada SkiaSharp. Ini membatasi gambar Aspose.Words yang dapat dijalankan sebagai berikut:

• Debian 9 dan 10
• Ubuntu 18.04 dan 19.04
• Alpine 3.9

SkiaSharp tidak berfungsi pada Windows Nano Server karena kurangnya beberapa dependensi asli, yang merupakan masalah umum di SkiaSharp. Masalah ini akan teratasi di SkiaSharp versi 1.68.1.1. Jika Anda perlu menjalankan Aspose.Words dalam wadah Windows, gunakan gambar dasar .NET Framework dengan Aspose.Words versi .NET Framework, yang tidak bergantung pada SkiaSharp.

SkiaSharp adalah pembungkus perpustakaan Skia asli. Runtime berikut disediakan dalam paket SkiaSharp NuGet:

• osx
• tizen-armel
• tizen-x86
• win10-arm
• menang10-x64
• menang10-x86
• win-x64
• win-x86

Untuk menjalankannya di Linux, Anda harus menggunakan paket NuGet tambahan dengan aset asli yang sesuai, seperti versi asli perpustakaan Skia, yang tercantum di bawah:

• SkiaSharp.NativeAssets.Linux – menyediakan build Skia asli untuk distribusi Linux berbasis x64 Debian.
• SkiaSharp.NativeAssets.Linux.NoDependencies – paket ini dimaksudkan untuk digunakan dalam distribusi Linux yang tidak memiliki ketergantungan libfontconfig. Diuji pada RHEL 7 (x64).
• Goelze.SkiaSharp.NativeAssets.AlpineLinux – menyediakan build Skia asli untuk x64 Alpine Linux 3.9.
• Jellyfin.SkiaSharp.NativeAssets.LinuxArm – menyediakan build Skia asli untuk distribusi Linux berbasis arm32 dan arm64 Debian.

Contoh Lainnya

1. Dalam contoh di atas, aplikasi dijalankan dalam image SDK. Gambar SDK lebih berat daripada gambar runtime. Contoh di bawah ini menunjukkan bagaimana file Docker harus dimodifikasi agar dapat menggunakan gambar SDK untuk membangun aplikasi, dan gambar runtime untuk menjalankannya:
   

   FROM mcr.microsoft.com/dotnet/core/sdk:2.2 AS build
   WORKDIR /app
   \# copy csproj and restore as distinct layers
   COPY Aspose.Words.Docker.Sample/*.csproj ./Aspose.Words.Docker.Sample/
   WORKDIR /app/Aspose.Words.Docker.Sample
   RUN dotnet restore
   \# copy and publish app and libraries
   WORKDIR /app/
   COPY Aspose.Words.Docker.Sample/. ./Aspose.Words.Docker.Sample/
   WORKDIR /app/Aspose.Words.Docker.Sample
   RUN dotnet publish -c Release -o out
   \# copy to runtime environment
   FROM mcr.microsoft.com/dotnet/core/runtime:2.2 AS runtime
   WORKDIR /app
   \# libfontconfig1 is required to properly work with fonts in Linux.
   RUN apt-get update && apt-get install -y libfontconfig1
   RUN apt install libharfbuzz-icu0
   COPY --from=build /app/Aspose.Words.Docker.Sample/out ./
   ENTRYPOINT ["dotnet", "Aspose.Words.Docker.Sample.dll"]

2. Untuk menjalankan aplikasi di Ubuntu 18.04, Dockerfile praktis tetap sama (hanya tag yang diubah):
   

   FROM mcr.microsoft.com/dotnet/core/sdk:2.2-bionic AS build
   WORKDIR /app
   \# copy csproj and restore as distinct layers
   COPY Aspose.Words.Docker.Sample/*.csproj ./Aspose.Words.Docker.Sample/
   WORKDIR /app/Aspose.Words.Docker.Sample
   RUN dotnet restore
   \# copy and publish app and libraries
   WORKDIR /app/
   COPY Aspose.Words.Docker.Sample/. ./Aspose.Words.Docker.Sample/
   WORKDIR /app/Aspose.Words.Docker.Sample
   RUN dotnet publish -c Release -o out
   \# copy to runtime environment
   FROM mcr.microsoft.com/dotnet/core/runtime:2.2-bionic AS runtime
   WORKDIR /app
   \# libfontconfig1 is required to properly work with fonts in Linux.
   RUN apt-get update && apt-get install -y libfontconfig1
   RUN apt install libharfbuzz-icu0
   COPY --from=build /app/Aspose.Words.Docker.Sample/out ./
   ENTRYPOINT ["dotnet", "Aspose.Words.Docker.Sample.dll"]

3. Untuk menjalankan aplikasi di Alpine Linux, diperlukan penambahan aset asli SkiaSharp dan menggunakan Dockerfile berikut:
   

   FROM mcr.microsoft.com/dotnet/core/sdk:2.2-alpine3.9 AS build
   WORKDIR /app
   \# copy csproj and restore as distinct layers
   COPY Aspose.Words.Docker.Sample/*.csproj ./Aspose.Words.Docker.Sample/
   WORKDIR /app/Aspose.Words.Docker.Sample
   RUN dotnet restore
   \# copy and publish app and libraries
   WORKDIR /app/
   COPY Aspose.Words.Docker.Sample/. ./Aspose.Words.Docker.Sample/
   WORKDIR /app/Aspose.Words.Docker.Sample
   RUN dotnet publish -c Release -o out
   \# copy to runtime environment
   FROM mcr.microsoft.com/dotnet/core/runtime:2.2-alpine3.9 AS runtime
   WORKDIR /app
   \# fontconfig is required to properly work with fonts in Linux.
   RUN apk update && apk upgrade && apk add fontconfig && apk add harfbuzz
   COPY --from=build /app/Aspose.Words.Docker.Sample/out ./
   ENTRYPOINT ["dotnet", "Aspose.Words.Docker.Sample.dll"]

4. Untuk menjalankan aplikasi di RHEL 7, diperlukan penambahan aset asli SkiaSharp dan menggunakan Dockerfile berikut:
   

   FROM mcr.microsoft.com/dotnet/core/sdk:2.1 AS build
   WORKDIR /app
   \# copy csproj and restore as distinct layers
   COPY Aspose.Words.Docker.Sample/*.csproj ./Aspose.Words.Docker.Sample/
   WORKDIR /app/Aspose.Words.Docker.Sample
   RUN dotnet restore
   \# copy and publish app and libraries
   WORKDIR /app/
   COPY Aspose.Words.Docker.Sample/. ./Aspose.Words.Docker.Sample/
   WORKDIR /app/Aspose.Words.Docker.Sample
   RUN dotnet publish -c Release -o out
   \# copy to runtime environment
   FROM kkamberta/dotnet-21-rhel7 AS runtime
   WORKDIR /app
   COPY --from=build /app/Aspose.Words.Docker.Sample/out ./
   ENTRYPOINT ["/opt/rh/rh-dotnet21/root/usr/bin/dotnet", "Aspose.Words.Docker.Sample.dll"]

Lihat juga

• Instal Docker Desktop di Windows
• Instal Docker Desktop di Mac
• Visual Studio 2017, .NET Core 2.2 SDK
• Opsi Beralih ke wadah Linux
• Instal SkiaSharp.NativeAssets.Linux
• Informasi tambahan tentang .NET Core SDK
• Gunakan paket NuGet tambahan: SkiaSharp.NativeAssets.Linux, SkiaSharp.NativeAssets.Linux.Tanpa Ketergantungan, Goelze.SkiaSharp.NativeAssets.AlpineLinux, Jellyfin.SkiaSharp.NativeAssets.LinuxArm
• RHEL 7 (x64)