Docker, Dockerfile'dan talimatları okuyarak g&ouml;r&uuml;nt&uuml;leri(image) oluşturur. Dockerfile, kaynak kodunuzu oluşturmak i&ccedil;in talimatlar i&ccedil;eren uzantısı olmayan bir metin dosyasıdır. Dockerfile i&ccedil;erisinde hangi&nbsp;Image&rsquo;ın&nbsp;kullanılacağı, hangi&nbsp;dosyaları&nbsp;i&ccedil;ereceği ve hangi&nbsp;uygulamanın hangi parametrelerle &ccedil;alışacağı yazılır. Docker, Dockerfile dosyasında bulunan komutları&nbsp;sırayla tek tek &ccedil;alıştırır.
&nbsp;
Bu yazıda yeni bir .Net 9 Web Api uygulamasını oluşturarak onu dockerize edip Docker ortamında &ccedil;alışmaya hazır hale getireceğiz.
&nbsp;
Not: Aşağıdaki adımları uygulamadan &ouml;nce sisteminizde .Net 9 SDK ve Docker kurulu olması gerekmektedir.
Docker kurulumu i&ccedil;in bu <a title="https://hexacodein.net/docker-basics" href="https://hexacodein.net/docker-basics" target="_blank" rel="noopener">makaleyi</a> inceleyebilirsiniz.
.Net 9 SDK kurulumunu <a title="https://dotnet.microsoft.com/en-us/download" href="https://dotnet.microsoft.com/en-us/download" target="_blank" rel="noopener">buradan</a> yapabilirsiniz.
&nbsp;
Yeni bir .NET 9 Web API Projesi Oluşturma
Terminal veya Komut İstemi'nde aşağıdaki komutu &ccedil;alıştırarak yeni bir .NET 9 Web API projesi oluşturun:<button class="flex select-none items-center gap-1"></button>
<pre class="language-javascript"><code>dotnet new webapi -n MyDockerizedApi
cd MyDockerizedApi</code></pre>
Projeyi &Ccedil;alıştırıp Test Etme
<pre class="language-javascript"><code>dotnet run</code></pre>
Tarayıcıda https://localhost:5001/swagger veya http://localhost:5000/swagger adresine giderek API'nin &ccedil;alıştığını doğrulayabilirsiniz.
&nbsp;
Dockerfile Oluşturma
Proje klas&ouml;r&uuml;nde Dockerfile adında yeni bir dosya oluşturun ve aşağıdaki i&ccedil;eriği ekleyin:
<div class="contain-inline-size rounded-md border-[0.5px] border-token-border-medium relative bg-token-sidebar-surface-primary dark:bg-gray-950">
<div class="overflow-y-auto p-4" dir="ltr">
<pre class="language-javascript"><code># .NET 9 SDK ile temel imajı kullan
FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build

# &Ccedil;alışma dizinini ayarla
WORKDIR /app

# Proje dosyalarını kopyala
COPY . .

# Bağımlılıkları geri y&uuml;kle
RUN dotnet restore

# Uygulamayı derle
RUN dotnet publish -c Release -o /publish

# Runtime i&ccedil;in ASP.NET Core imajı kullan
FROM mcr.microsoft.com/dotnet/aspnet:9.0 AS runtime

# &Ccedil;alışma dizinini ayarla
WORKDIR /app

# Yayınlanan dosyaları kopyala
COPY --from=build /publish .

# Uygulamayı &ccedil;alıştır
ENTRYPOINT ["dotnet", "MyDockerizedApi.dll"]
</code></pre>
Docker İmajı Oluşturma ve &Ccedil;alıştırma
Aşağıdaki komutları &ccedil;alıştırarak Docker imajını oluşturun ve &ccedil;alıştırın:
<pre class="language-javascript"><code>docker build -t mydockerizedapi .</code></pre>
Konteyneri &ccedil;alıştırma
<pre class="language-javascript"><code>docker run -p 5000:8080 mydockerizedapi</code></pre>
Tarayıcıda http://localhost:5000/swagger adresine giderek API&rsquo;nin Docker konteyneri i&ccedil;inde &ccedil;alıştığını doğrulayabilirsiniz.
&nbsp;
Sonu&ccedil;
Bu makalede yeni bir .Net 9 Web Api uygulaması i&ccedil;in Dockerfile oluşturmayı ve Docker ortamında &ccedil;alıştırmayı inceledik.&nbsp;
&nbsp;
Kodlamaya devam 🙂
&nbsp;
Referanslar:
<ul>
<li><a title="https://docs.docker.com/build/concepts/dockerfile/" href="https://docs.docker.com/build/concepts/dockerfile/" target="_blank" rel="noopener">https://docs.docker.com/build/concepts/dockerfile/</a></li>
</ul>
&nbsp;
</div>
</div>

Docker creates images by reading instructions from Dockerfile. Dockerfile is a text file with no extension that contains instructions for building your source code. In Dockerfile, it is written which image to use, which files it will contain and which application will run with which parameters. Docker runs the commands in the Dockerfile one by one in sequence.
&nbsp;
In this article we will create a new .Net 9 Web Api application, dockerize it and make it ready to run in a Docker environment.
&nbsp;
Note: You must have .Net 9 SDK and Docker installed on your system before following the steps below.
You can check this <a title="https://hexacodein.net/docker-basics" href="https://hexacodein.net/docker-basics" target="_blank" rel="noopener">article</a> for Docker installation.
You can install the .Net 9 SDK <a title="https://dotnet.microsoft.com/en-us/download" href="https://dotnet.microsoft.com/en-us/download" target="_blank" rel="noopener">here.</a>
&nbsp;
Creating a New .NET 9 Web API Project
Create a new .NET 9 Web API project by running the following command in Terminal or Command Prompt: <button class="flex select-none items-center gap-1"></button>
<pre class="language-javascript"><code>dotnet new webapi -n MyDockerizedApi
cd MyDockerizedApi</code></pre>
Running and Testing the Project
<pre class="language-javascript"><code>dotnet run</code></pre>
You can verify that the API is working by going to https://localhost:5001/swagger or http://localhost:5000/swagger in a browser.
&nbsp;
Creating Dockerfile
Create a new file called Dockerfile in the project folder and add the following content:
<div class="contain-inline-size rounded-md border-[0.5px] border-token-border-medium relative bg-token-sidebar-surface-primary dark:bg-gray-950">
<div class="overflow-y-auto p-4" dir="ltr">
<pre class="language-javascript"><code># Use .NET 9 SDK as the base image
FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build

# Set working directory
WORKDIR /app

# Copy project files
COPY . .

# Restore dependencies
RUN dotnet restore

# Build the application
RUN dotnet publish -c Release -o /publish

# Use ASP.NET Core runtime image
FROM mcr.microsoft.com/dotnet/aspnet:9.0 AS runtime

# Set working directory
WORKDIR /app

# Copy published files
COPY --from=build /publish .

# Run the application
ENTRYPOINT ["dotnet", "MyDockerizedApi.dll"]
</code></pre>
Build and Run the Docker Image
Run the following commands to build and run the Docker image:
<pre class="language-javascript"><code>docker build -t mydockerizedapi .</code></pre>
Run the container
<pre class="language-javascript"><code>docker run -p 5000:8080 mydockerizedapi</code></pre>
Now, open http://localhost:5000/swagger in your browser to verify that the API is running inside the Docker container.
&nbsp;
Conclusion
In this article, we examined how to create a Dockerfile for a new .Net 9 Web Api application and run it in a Docker environment.&nbsp;
&nbsp;
Keep coding 🙂
&nbsp;
References:
<ul>
<li><a title="https://docs.docker.com/build/concepts/dockerfile/" href="https://docs.docker.com/build/concepts/dockerfile/" target="_blank" rel="noopener">https://docs.docker.com/build/concepts/dockerfile/</a></li>
</ul>
&nbsp;
</div>
</div>