 yükleme AWS Serverless Application Model (SAM) kullanılarak bir API dağıtmak, bulut tabanlı uygulamalar için verimli ve ölçeklenebilir bir yaklaşımdır. İnfrastruktur yönetimini basitleştirir, entegre SSL/TLS desteğini sağlar ve CloudFormation, Lambda, S3, Route 53 ve CloudWatch gibi AWS hizmetleriyle sorunsuz bir şekilde entegrasyon sağlar.  ile yüklemeyi doğrulayın  İndir  İndirilen dosyayı çift tıklayın.  ile ilgili bilgiler Hizmetler tablosu – Giriş: Neden bir API'yi dağıtmak için SAM kullanın? – Ön koşullar: SAM CLI – Adım 1: SAM başlatmak – Adım 2: API Endpoint tanımlamak – Adım 3: Yerel olarak oluşturun ve test edin – Adım 4: API'yi dağıtın – Adım 5: CI / CD ile Github Eylemleri  – Sonuç Intro: Neden SAM kullanarak bir API dağıtmak için? Serverless modelini kullanarak, geliştiriciler uygulama mantığını yazmaya odaklanabilirken, AWS ölçeklendirme, güvenlik ve bakım ile ilgilenir ve bu da modern, yüksek kullanılabilirlikli API'ler için ideal bir çözüm haline gelir. Bu öğretici, basit bir API oluşturma, SAM CLI ile AWS CloudFormation kullanarak dağıtma ve ardından GitHub Eylemleri kullanılarak dağıtımları otomatikleştirme hakkında adım adım rehberlik edecektir.  İşte bu iş akışının daha ayrıntılı bir diagramı: Öncelikler Öncelikler        yerel test için.    AWS CLI ve SAM CLI yüklü.   Node.js yüklü Docker  hesabı. GitHub AWS CLI ve SAM CLI yüklü. Node.js yüklü Node.js yüklü  yerel test için. Docker Docker  hesabı. GitHub GitHub Öneriler: SAM CLI yükleme Öğrenciye dalmadan önce, AWS SAM CLI'nin bilgisayarınıza yüklendiğinden emin olun.Aşağıda macOS ve Windows için kurulum adımları yer almaktadır:  macOS için  (hiç yüklü değilse): Install Homebrew Homebrew yükleme /bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" /bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" : AWS tuşuna ekleyin ve SAM CLI'yi yükleyin AWS tuşuna ekleyin ve SAM CLI'yi yükleyin dönüştürücü aws/dönüştürücü aws-sam-cli brew tap aws/tapbrew install aws-sam-cli   sam --version sam - sürüm Windows için : Download the SAM CLI installer Download the SAM CLI installer        ve en son Windows yükleme yazılımını indirin. official AWS SAM CLI page    ve en son Windows yükleme yazılımını indirin. official AWS SAM CLI page official AWS SAM CLI page : Yükleme programını çalıştırın Installer çalıştırın     Double-click downloaded   file and follow the installation wizard. .exe Double-click downloaded   file and follow the installation wizard. .exe .exe  (otomatik olarak eklenmemişse): PATH'a SAM CLI ekle PATH'a SAM CLI ekle             Başlangıç menüsünü açın ve “Çevre Değişkenleri” için arama yapın.  “Sistem Değişkenlerini Düzenle.”  “Sistem Özellikleri” altında “Çevre Değişkenleri” düğmesine tıklayın.  “Sistem Değişkenleri” altında   bulun ve “Edit” düğmesine tıklayın. Path  SAM CLI’nin yüklendiği dizini ekleyin (örneğin,  ). C:\Program Files\Amazon\AWS SAM CLI\bin  Başlangıç menüsünü açın ve “Çevre Değişkenleri” için arama yapın. Sistem çevresindeki değişkenleri düzenle.  “Sistem Özellikleri” altında “Çevre Değişkenleri” düğmesine tıklayın. Sistem Değişkenleri'nde  'ı bulun ve "Edit"'i tıklayın.Etiket Arşivi  Path SAM CLI'nin yüklendiği dizini ekleyin (örneğin,  ). C:\Program Files\Amazon\AWS SAM CLI\bin C:\Program Dosyaları\Amazon\AWS SAM CLI\bin : Bir komut iletisini açın ve  Yüklemeyi doğrulayın sam --version Yüklemeyi doğrulayın sam - sürüm Adım 1: SAM CLI'yi başlatın   Bilgisayarınızda yeni bir depolama oluşturun: mkdir aws-serverless-api Makinenizde yeni bir depolama oluşturun: Sosyal medya aws-serverless-api   Dilekçeye geçin: cd aws-serverless-api Düzenleme sayfasına geçin: cd aws-serverless-api için   daha sonra birkaç seçenekle yönlendirileceksiniz.  ile ilgili yorumlar Yeni bir SAM uygulaması başlatın: sam init Yeni bir SAM uygulaması başlatın: sam init       Güçlü > Güçlü > Güçlü Güçlü > Güçlü > Güçlü  ile ilgili yorumlar  Hakkında Bilgi   AWS Hızlı Başlangıç Şablonları <1'i seçin.      lambda destekli bir serverless API API'yi API Gateway'de dağıtmak için. "7 - Serverless API"    veya X-Ray izleme için No seçin, çünkü maliyetlerimizi azaltmak istiyoruz ve bu sadece basit bir Hello World örneğidir. Eğer farklı hizmetlerde karmaşık bir API'yi çekmek istiyorsanız, bu örneğin Hello World "N" Choose  “1 — AWS Hızlı Başlangıç Şablonları.” “1 — AWS Hızlı Başlangıç Şablonları.” “1 — AWS Hızlı Başlangıç Şablonları.” Lambda destekli bir serverless API API API Gateway üzerinde dağıtmak için   seçin. "7 — Serverless API" “7 — Serverless API”  “7 — Serverless API” Choose  “Node.js 20.x”  “Node.js 20.x”  “Node.js 20.x”    veya X-Ray izleme için Hayır seçin, çünkü maliyetlerimizi azaltmak istiyoruz ve bu sadece basit bir Hello World örneğidir. Güçlü > Güçlü > GüçlüAyrıca cloudwatch izleme için   seçiyorum çünkü bu Hello World örneği için performans analizine ihtiyacımız yok. "N"  “N” “N”  “N” Ayrıca   lambda günlüğünde json biçimi için çünkü bu sadece bir Hello World örneğidir. "N"  “N” Şimdi,   tarafından oluşturulan dizine cd'yi koyalım; projeyi   olarak adlandırmayı seçtim, bu yüzden gidelim: sam init sam-hello-world sam init sam-hello-world hello-world         için yorum yapın cd sam-hello-world Sonra projeyi VSCode   - projeyi VSCode veya en sevdiğiniz IDE'de açtığınızda zaten çok sayıda oluşturulan dosya görmeniz gerekir. code'da açın. Etiket Arşivi:   ile ilgili yorumlar Yaratılan Dosyaları Anlamak  İşte   tarafından oluşturulan dosyaların her biri ne yapar: sam init sam init            – API Gateway, Lambda ve diğer AWS kaynaklarını tanımlar. **template.yaml**  – Lambda işlevinin örnek işlemcileri içerir. **src/handlers/**  – Yerel testler için örnek test olayları. **events/**  – Node.js Lambda işlevleri için bağımlılıkları yönetir. **package.json**   .gitignore**  – Standart proje kurulum dosyaları.    – API Gateway, Lambda ve diğer AWS kaynaklarını tanımlar. **template.yaml**  ıslak ıslak ıslak ıslak  – Lambda fonksiyonu işlemcileri örneği içerir. **src/handlers/**                İndir  – Yerel test için örnek test olayları. **events/**  * etkinlikler / *  – Node.js Lambda fonksiyonları için bağımlılıkları yönetir. **package.json** **package.json** **.gitignore**    – Standart proje kurulum dosyaları. **README.md**         > Güçlü > Güçlü  Hakkında **README.md** Bu dosyaların bir kısmını, çok basit “hello world” API’mızla uyum sağlamak için   değiştireceğiz. Bu dosyaların bazılarını çok basit “hello world” API’mızla uyum sağlamak için değiştirin ve kaldırın.  Hakkında  adı verilen bir dosya oluşturalım  ile ilgili bilgiler  ile ilgili bilgiler  Hakkında Bilgi  ile ilgili yorumlar   Adım 2: API Endpoint tanımlamak Şimdi  'ı açın ve mevcut Lambda işlev tanımlarını şu şekilde değiştirin: template.yaml template.yaml AWSTemplateFormatVersion: "2010-09-09" Transform: AWS::Serverless-2016-10-31 Açıklama: Lambda'ya Node.js/Express API'yi dağıtmak için AWS SAM şablonu Kaynaklar: HelloWorldFunction: Type: AWS::Serverless::Function Properties: Handler: src/app.lambdaHandler Runtime: nodejs20.x Events: HelloWorld: Type: Api Properties: Path: / Method: GET  AWSTemplateFormatVersion: "2010-09-09" Transform: AWS::Serverless-2016-10-31 Açıklama: Lambda'ya Node.js/Express API'yi dağıtmak için AWS SAM şablonu Kaynaklar: HelloWorldFunction: Type: AWS::Serverless::Function Properties: Handler: src/app.lambdaHandler Runtime: nodejs20.x Events: HelloWorld: Type: Api Properties: Path: / Method: GET  Bu, API'mizin kökünde GET isteği olan bir rotayı tanımlar Lambda fonksiyonu güncelleştirme    dizininde  /src app.js  / src app.js   'da, yolumuzdan hello world çıkartmak için bir işlev yazalım: src/app.js src/app.js exports.lambdaHandler = async (event) => { return { statusCode: 200, body: JSON.stringify({ message: "Hello, World!" }) }; };  exports.lambdaHandler = async (event) => { return { statusCode: 200, body: JSON.stringify({ message: "Hello, World!" }) }; };  Hasır Dosyaları Kaldır Şimdi,   tarafından 1. adımda oluşturulan ek işlemcileri ve olayları kaldıralım. sam init sam init Proje dizininde bir terminal açın ve  :  bu komutları çalıştırın Bu komutları çalıştırın rm -rf src/handlers/get-all-items.mjs src/handlers/get-by-id.mjs src/handlers/put-item.mjs rm -rf src/handlers/get-all-items.mjs src/handlers/get-by-id.mjs src/handlers/put-item.mjs rm -rf olayları/ rm -rf olayları/ Adım 3: Yerel olarak oluşturun ve test edin Proje dizininde bir terminal açın ve aşağıdaki adımları izleyin:     :  Uygulamayı oluştur :  Uygulamayı oluştur  Uygulamayı Oluştur  böyle bir çıkış görmelisiniz: sam build  yerel olarak çalıştırmak için yüklemeniz gerektiğini unutmayın.  sam oluşturmak     : Bir yerel API sunucusunu başlat : Bir yerel API sunucusunu başlat Bir yerel API sunucusunu başlat docker            yerel olarak çalıştırmak için yüklemeniz gerektiğini unutmayın.  docker                  yerel olarak çalıştırmak için yüklemeniz gerekir. Başarılı olduğunda, docker masaüstünde API için oluşturulan bir konteyner görmelisiniz.  — Not:  sam local start-api docker     Bir tarayıcı açın veya terminalde son noktayı test etmek için   kullanın: curl  — Eğer yerel olarak çalışmak için   yüklemeniz gerektiğini unutmayın. Başarılı olduğunda, docker masaüstünde API için oluşturulan bir konteyner görmelisiniz. sam local start-api docker sam local start-api için  Etiket Arşivi   kullanarak AWS'e dağıtalım  Kullanım Kılavuzu  Hakkında Bilgi  Kullanıcı Adı  seçtim docker     Bir tarayıcı açın veya terminali test etmek için   kullanın: curl Bir tarayıcı açın veya terminali test etmek için   kullanın: curl curl     curl [http://127.0.0.1:3000/](http://127.0.0.1:3000/) curl [http://127.0.0.1:3000/](http://127.0.0.1:3000/) curl [http://127.0.0.1:3000/](http://127.0.0.1:3000/)     Eğer JSON'u son noktamızdan döndüğünü görürseniz, API'yi yerel olarak başarıyla başlattınız!  Adım 4: API'yi dağıtın  kullanarak API'yi paketleme ve dağıtma: Şimdi API'mizin yerel olarak çalıştığını onayladığımızda,  SAM  SAM kullanarak API'yi paketleme ve dağıtma sam dağıtım --guided sam deploy --guided Bu yönlendirilmiş dağıtım size şunları sağlayacaktır: Bu yönlendirilmiş dağıtım size şunları sağlayacaktır: 1. Adınızı seçin; benim  sam-hello-world sam-hello-world 2. AWS Bölgesi seçin; benim  us-east-1 us-east-1 3. Geliştirme öncesi değişiklikleri onaylayın;  Y  ve   için 4. SAM-CLI Role Creation izin,  Y  ve   için 5. Rollback'i devre dışı bırakın,  'ı seçin, herhangi bir kaynağı temizlemek için aracı istiyoruz N N   ile ilgili 6. HelloWorldFunction kimlik doğrulaması yok; bu iyi mi? bu kılavuzun amaçları için  Y  ve   için 7 Argümanları yapılandırma dosyasına kaydedin  Y  ve   için  Hakkında  İndir Adım Adım Adım Adım Adım Adım Adım  8. Konfigürasyon dosyası  samconfig.toml samconfig.toml 9. SAM yapılandırma ortamı — bunu varsayılan olarak bırakın Eğer dağıtımınız başarılı ise, başarıyla oluşturulan kaynakları şu şekilde görmelisiniz: Başvuru başarılı olduğunda,   ve API Gateway hizmetini arayın. API ayarlarına gidin, alan adınızı tarayıcınızın penceresinde bulunan URL girisine kopyalayın ve dağıtılan API son noktasına ulaşmak için URL'nizin sonuna `/Prod` ekleyin. AWS hesabınıza oturum açın AWS hesabınıza giriş URL adresim şu şekilde görünüyor: AWS konsolunda Lambda için de arama yaparak, bu son nokta için yazdığımız kodun yaşadığı dağıtılan sunucusuz Lambda işlevini görüntüleyebilirsiniz. Şimdi API'mizi başarılı bir şekilde dağıtmış olduktan sonra, bu süreci GitHub ile otomatikleştirelim, böylece API'mizi geliştirmek istediğimiz zaman, dağıtım sadece MAIN veya MASTER dalına bağlı olarak otomatik olarak başlatılabilir. Adım 5: Github Eylemleri ile CI/CD Git Repo'nunuzu başlatın ve Master Branch'a basın Önce, projemizin dizininde bir git depolamasını   ile başlatacağız, sonra bu dosyaları  'a ekleyelim, çünkü bunları taahhüt etmek istemiyoruz. git init .gitignore git init .girişimcilik echo "node_modules/\n.aws-sam/\nsamconfig.toml" >>.gitignore echo "node_modules/\n.aws-sam/\nsamconfig.toml" >>.gitignore Şimdi, projenin tüm dosyalarını aşamaya hazırız:   ekleyin ve sonra ilk komite yapın: git.  ile ilgili tüm içeriği bul  iş akışları  Hakkında git commit -m "Initial commit - AWS SAM API setup" git commit -m "Initial commit - AWS SAM API setup" Bu sonraki adım, GitHub CLI'sini yüklediğinizi varsayar - Bu adım, mevcut dizinimizden bir GitHub repo oluşturabiliriz: gh repo create aws-sam-cli-tutorial --public --source=. --remote=origin gh repo create aws-sam-cli-tutorial --public --source=. --remote=origin GitHub CLI'sine sahip değilseniz, repo'yu GitHub'ta manuel olarak oluşturabilir ve daha sonra bu komutu kullanarak dizinizi repo'ya yönlendirebilirsiniz: github.com/YOUR_USERNAME/YOUR_REPO_NAME.git git uzaktan kaynağı ekle https://github.com/YOUR_USERNAME/YOUR_REPO_NAME.git Son olarak, kodumuzu GitHub  git push -u origin master git push -u origin master CI/CD için GitHub Eylemlerini Kurun GitHub eylemleri iş akışı dosyası oluşturalım: github/workflows github / iş akışları touch.github/workflows/deploy.yml touch.github/workflows/deploy.yml Bu   dosyasını vscode'da açın ve aşağıdaki yaml yapılandırmasını yapıştırın: deploy.yml deploy.yml name: AWS Cloud API'yi AWS CloudFormation üzerinde: push: bölümler: - master jobs: deploy: runs-on: ubuntu-latest steps: - name: Checkout Code uses: actions/checkout@v3 - name: Install AWS SAM CLI uses: aws-actions/setup-sam@v2 - name: Configure AWS CLI uses: aws-actions/configure-aws-credentials@v2 with: aws-access-key-id: ${ secrets.AWS_ACCESS_KEY_ID }} aws-secret-access-key: ${ secrets.AWS_SECRET_ACCESS_KEY }} aws-region: us-east-1 -  İndir  İndir  İndirAWS / AWS / AWS / AWS / AWS / AWS / AWS / AWS / AWS  İndir  tarafından sağlandı  Hakkında  Kullanıcı Adı  Hakkında  Hakkında  Kullanım Kılavuzu Adım Adım Adım Adım Adım Adım Adım  name: AWS Cloud'a API dağıtımını AWS CloudFormation üzerinde: push: şubeler: - master jobs: deploy: runs-on: ubuntu-latest steps: - name: Checkout Code uses: actions/checkout@v3 - name: Install AWS SAM CLI uses: aws-actions/setup-sam@v2 - name: Configure AWS CLI uses: aws-actions/configure-aws-credentials@v2 with: aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }} aws-secret-access-key: ${ secrets.AWS_SECRET_ACCESS_KEY }} aws-region: us-east Bu.yaml dosyasında, GitHub'tan AWS-Actions depolarına güveniyoruz:   SAM CLI'yi yüklemek ve kimliklerimizi yapılandırmak için - bu AWS depoları birkaç yıl içinde değişebilir, gerekirse güncelleyelim. https://github.com/orgs/aws-actions/repositories https://github.com/orgs/aws-actions/repositories Şimdi github.com'a gidelim - depolarınıza gidin, bu proje için oluşturduğumuz depolara tıklayın, ayarlara, eylemlere gidin ve çevre ve depolama sırlarını eklemek için bu ekranı göreceksiniz. Aşağıdakiler için Depozitör sırlarını ekleyeceğiz:  Biz için Depozito sırlarını ekleyeceğiz:   AWS_ACCESS_KEY_ID  AWS_ACCESS_KEY_ID  AWS_SECRET_ACCESS_KEY  AWS_SECRET_ACCESS_KEY  AWS_REGION AWS_S3_BUCKET AWS_S3_BUCKET Bu değerleri almak için AWS konsolunuza gidin.   yerel makinenizden dağıtmış olduğunuz aynı bölgeyi kullanmak istiyorsunuz. Bölge hakkında emin değilseniz, bulut formatı arayın ve oluşturduğunuz sızıntıyı bulun, üzerine tıklayın ve URL'de bölgeyi görmelisiniz. AWS_REGION için, AWS_REGION, AWS_S3_BUCKET   arama yapın ve AWS makinenizden dağıtıldığımızda oluşturulan küpü adım 4. Bu küpün ID'sini değeriniz için kullanın; benim aşağıdaki ekran görüntüsünde gösterilmektedir.  için, AWS konsolunda S3 için AWS_S3_BUCKET,  ve   için AWS konsolundaki IAM servisine gidin: AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY, AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY, Bundan itibaren, kullanmak istediğiniz erişimle zaten sahip değilseniz bir IAM kullanıcısı oluşturun ve kullanıcıya en azından bu izin alanlarını ekleyin:       AWSLambdaFullAccess IAMFullAccess AmazonS3FullAccess CloudFormationFullAccess AmazonAPIGatewayAdministrator AWSLambdaFullAccess IAMFullAccess AmazonS3FullAccess CloudFormationFullAccess AmazonAPIGatewayYönetici Sadece   ekleyebilirsin.Ondan sonra, bu kullanıcı için bir Access anahtarı ve Gizli oluşturmak istiyoruz.CLI'yi erişim anahtarı için kullanım durumuna seçin. Gizliğinizi kopyalayın çünkü bunu bir daha göremeyeceksiniz. AdministratorAccess AdministratorGiriş Şimdi GitHub'a dönün ve depolama sırlarınızı ekleyin: Evet, son adım her şeyin işe yaradığını test etmektir! app.js'inizi başka bir şey söylemek için güncelleyin; benimimi “What up, World!” olarak değiştirdim. exports.lambdaHandler = async (event) => { return { statusCode: 200, body: JSON.stringify({ message: "What up, World!" }), }; };  exports.lambdaHandler = async (event) => { return { statusCode: 200, body: JSON.stringify({ message: "What up, World!" }), }; };  Daha sonra değişikliklerinizi ana dalınıza basın.       - basıldığınızda ana dalın üzerinde olduğunuzu kontrol edin. git add. git commit -m 'updated message' git push  İndir  Kullanım Kılavuzu git commit -m 'updated message' Git Push GitHub repo'unuzda, eylemin çalıştığını ve başarılı bir şekilde dağıtıldığını görmelisiniz: Son olarak, web tarayıcınıza geri dönün ve ayarladığımız API Gateway'den URL'yi yapıştırın. Benim:   - ve mesajı değiştirdiğini onaylayın. https://tt40c6vgm3.execute-api.us-east-1.amazonaws.com/Prod https://tt40c6vgm3.execute-api.us-east-1.amazonaws.com/Prod Sözleşme Tebrikler! Sunucu olmayan AWS Stack için yeni bir CI/CD dağıtım hattı oluşturdunuz; şimdi, API'nizi yararlı hizmetlerle çalıştırabilirsiniz. Bu makalenin yararlı olup olmadığını veya geliştirme konusunda herhangi bir sorunuz veya öneriniz olup olmadığını bana bildirin!

Read My Stories

Bu ses hikayenin orijinal dilinde üretilmiştir!

AWS SAM CLI ve GitHub Actions ile Sunucusuz Bir API Nasıl Dağıtılır

About Author

YORUMLAR

ETİKETLERİ ASIN

BU YAZI

Related Stories

Sulara Yelken Açmak: Data Lakes ile Üretim Sınıfında RAG Uygulamaları Geliştirme

Forumlardan Feed'lere: Sosyal Medya Algoritmaları Dijital Etkileşimi Nasıl Şekillendiriyor

Claude Sonnet 3.5 Sistem Bilgi Sızıntısı: Adli Analiz

Yapay Zekanın Gücünü Ortaya Çıkarıyoruz. En Son Tekniklerin Sistematik Bir İncelemesi: Özet ve Giriş

Sulara Yelken Açmak: Data Lakes ile Üretim Sınıfında RAG Uygulamaları Geliştirme

Forumlardan Feed'lere: Sosyal Medya Algoritmaları Dijital Etkileşimi Nasıl Şekillendiriyor

Claude Sonnet 3.5 Sistem Bilgi Sızıntısı: Adli Analiz

Yapay Zekanın Gücünü Ortaya Çıkarıyoruz. En Son Tekniklerin Sistematik Bir İncelemesi: Özet ve Giriş

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps