# Graviton'a geçmek için imajlarımı arm64 ve amd64 olarak nasıl derlemeliyim?

> İki mimariyi buildx ile tek tag altında toplayın; Go'yu TARGETARCH ile cross-compile edin, extension derlemesi uzuyorsa native arm64 runner kullanın.

- Soruldu: 2026-11-06
- Yanıtlandı: 2026-11-10
- Etiketler: Docker, AWS
- Kaynak: https://muhammetsafak.com/tr/sor-bakalim/gravitona-gecmek-imajlarimi-arm64-amd64-derlemeliyim/
- Dil: tr-TR
- Yazar: Muhammet Şafak

---
**Soru:** AWS'te maliyeti düşürmek için EC2 filomu Graviton (arm64) instance'lara taşımak istiyorum; fiyat/performans avantajı ciddi görünüyor. Ama sorun şu: CI hattım (GitHub Actions) bugün yalnızca amd64 imajları üretiyor.

Bir Go servisim, bir de Laravel API'm var, ikisi de container olarak çalışıyor. Aynı imajın hem eski amd64 node'larda hem yeni arm64 node'larda sorunsuz koşmasını istiyorum. İmajları iki mimari için doğru şekilde nasıl derlerim ve hangi tuzaklara dikkat etmeliyim?


## Kısa cevap

`docker buildx` ile iki mimariyi tek bir tag altında toplayan bir manifest listesi üretin; Docker çalışılan node'un mimarisine göre doğru varyantı çeker.

## Bağlam

Go tarafı neredeyse bedava, yorumlanan uygulama tarafında asıl karar QEMU mı native runner mı olduğu.

## Neden

1. **Temel araç buildx ve çok mimarili manifest.** `--platform linux/amd64,linux/arm64` ile tek `docker buildx build --push` çağrısı iki imaj + bir manifest listesi yaratır. `myimage:1.4` tag'i her iki mimariyi de işaret eder; Graviton node `arm64`, eski node `amd64` varyantını çeker, `exec format error` almazsınız.

## Ne yapmalı

1. **Go için cross-compile pratikte ücretsizdir.** [Go'da mimari değiştirmek](https://muhammetsafak.com/tr/sor-bakalim/go-cli-aracini-goreleaser-ve-homebrew-ile-dagitmak/) `GOARCH` meselesi; emülasyona hiç gerek yok. Dockerfile'da buildx'in verdiği `TARGETARCH` argümanını kullanıp derlemeyi hep amd64 runner'da yapın:

   ```dockerfile
   FROM --platform=$BUILDPLATFORM golang:1.24 AS build
   ARG TARGETOS TARGETARCH
   WORKDIR /src
   COPY . .
   RUN CGO_ENABLED=0 GOOS=$TARGETOS GOARCH=$TARGETARCH go build -o /app ./cmd/api
   FROM gcr.io/distroless/static
   COPY --from=build /app /app
   ENTRYPOINT ["/app"]
   ```

2. **Yorumlanan uygulamada (Laravel) iki yol var.** Resmi PHP imajları zaten çok mimarili, o yüzden çalışır; ama arm64 katmanını amd64 runner'da QEMU emülasyonuyla derlemek, extension derliyorsanız (pecl, `docker-php-ext-install`) belirgin biçimde yavaşlar. Alternatif: her mimariyi kendi native runner'ında derleyip sonunda `docker buildx imagetools create` ile manifest'i birleştirmek. GitHub artık arm64 runner sunuyor; build süresi canınızı yakıyorsa matrix + native runner çok daha hızlı ve kararlıdır.

3. **Bağımlılıkların arm64 karşılığı olduğundan emin olun.** Base image, üçüncü parti binary'ler, `mysqli`/`gd` gibi extension'lar, hatta bazı Composer/npm paketlerinin native derlenen kısımları arm64'te mevcut olmalı. Genelde sorun çıkmaz ama tek bir eksik binary tüm imajı çökertir.

4. **Prod'a almadan gerçek arm64'te test edin.** Emülasyonla "derlendi" demek "çalışıyor" demek değildir. Tek bir arm64 node açıp smoke test yapın; float davranışı, time zone, native kütüphane farkları nadir de olsa ısırır.

**Sonuç:** Ben olsam Go servisini `TARGETARCH`'lı buildx ile tek hatta çok mimarili derlerdim — ucuz, temiz, ekstra runner istemez. Laravel tarafında extension derlemesi build süresini şişiriyorsa QEMU yerine native arm64 runner'la matrix kurar, `imagetools create` ile birleştirirdim. Geçişi de bir gecede değil; önce imajları çok mimarili yapıp filoyu karışık çalıştırır, arm64'ü doğruladıktan sonra ağırlığı Graviton'a kaydırırdım.

*Sahada karşılaşılan ve bana sorulan sorulardan derlendi.*

## İlgili Yazılar

- [Container'larım sürekli OOMKilled oluyor, memory limit'lerini PHP-FPM ve Go için nasıl doğru ayarlarım?](https://muhammetsafak.com/tr/sor-bakalim/containerlarim-oomkilled-memory-limitlerini-php-fpm-go-ayarlarim/) — Sor Bakalım
- [Container'daki Go worker'ım SIGTERM almıyor ve graceful kapanmıyor, bu bir PID 1 sorunu mu?](https://muhammetsafak.com/tr/sor-bakalim/containerdaki-go-workerim-sigterm-almiyor-pid-1-sorunu/) — Sor Bakalım
- [Container'ı non-root çalıştırınca mount edilen storage dizinine yazamıyorum, izinleri nasıl çözerim?](https://muhammetsafak.com/tr/sor-bakalim/containeri-non-root-calistirinca-mount-edilen-storage-dizinine-yazamiyorum-izinleri-nasil/) — Sor Bakalım
