Dokümantasyon › Bağlantılar
Vercel
Vercel'i bağlayın; EOMA yönlendirmeleri CDN üzerinde hazırlasın ve sitenizin geri kalanının kurulduğu depoyu bulsun.
10 saniyede
- Yönlendirmeleri EOMA sizin için Vercel'in içinde hazırlar. Siz Publish düğmesine basana kadar Vercel panelinizde beklerler, EOMA o düğmeye asla basmaz.
- Geri kalan her şey, sayfa metni, başlıklar ve açıklamalar, yapılandırılmış veri, Vercel dışından değiştirilemez. O iş, sitenizin kurulduğu depoya gider.
- Vercel'i bağlamak aynı zamanda EOMA'nın hangi depo olduğunu öğrenme yoludur, böylece adını hiç yazmanız gerekmez.
Başlamadan önce
- EOMA'da markanın sahibi olmanız gerekir. Diğerleri Bağlayın düğmesi yerine "Yalnızca sahip" görür.
- Projenizin sahibi olan Vercel hesabına ya da takımına bir entegrasyon kurabiliyor olmanız gerekir.
Adımlar
1. Ayarlar → Entegrasyonlar ekranını açın
Ayarlar sol kenar çubuğunun en altındadır, Entegrasyonlar ise Çalışma Alanı grubundadır. Vercel, Yayınlama · CMS & siteler grubundadır.
2. EOMA entegrasyonunu kurun
Bağlayın düğmesine, sonra Vercel'e devam edin düğmesine basın. Vercel size EOMA'nın ne istediğini ve nereye kurulacağını gösterir. Kopyalanacak bir şey ve oluşturulacak bir token yoktur.
EOMA projelerinizi ve ayarlarını okumayı, dağıtımlarla çalışmayı ister. Ortam değişkenlerinizi, alan adlarınızı ya da faturalandırmanızı istemez.
3. Web siteniz olan projeyi seçin
Doğrudan EOMA'ya dönersiniz ve EOMA kurulumun görebildiği projeleri listeler. Her satır o projenin nasıl dağıtıldığını gösterir:
| Rozet | Anlamı |
|---|---|
| Deploys from owner/repo | Siteniz o depodan kurulur. Normal durum budur |
| Direct deploys (CLI / v0) | Dosyalar bir depodan kurulmak yerine yüklenmiştir |
Web sitenize hizmet edeni seçin ve Save project ("Projeyi kaydet") düğmesine basın.
4. GitHub'ı bağlayın
Projeniz bir depodan dağıtılıyorsa, EOMA size artık hangisi olduğunu söyler ve sizi GitHub'a götürür. EOMA'yı orada kurup o depoya erişim verdiğinizde, yayın hedefi sizin için doldurulur, depo seçici yok, seçilecek dal yok.
Depo kendi hesabınızda değilse EOMA hangi hesapta olduğunu söyler. Bunu sitenizi kuran kişiye iletin: EOMA'yı GitHub'a kurup o depoya erişim vermeleri gerekir.
Ne göreceksiniz
"Bir adım kaldı; GitHub'ı bağlayın". Bir proje seçtikten sonra, o proje bir depodan dağıtılıyorsa gelen ekran. Depoyu adlandırır ve değişikliklerin oraya, inceleyip birleştireceğiniz pull request'ler olarak geleceğini açıklar.
Depo zaten seçili halde. GitHub kurulumundan sonra yayın hedefi ayarlanmış olur. GitHub satırına bakarsanız depo ve dalın zaten doldurulmuş olduğunu görürsünüz.
Erişim eksik olduğunda adlandırılmış bir hesap. EOMA'ya Vercel projenizin adlandırdığı depoya erişim verilmemişse, size boş bir liste göstermek yerine bunu söyler ve deponun sahibi olan hesabı adlandırır.
Sayıları okumak
Dağıtım rozeti kararın tamamıdır ve okumanız gereken tek şeydir.
| Rozet | Anlamı | Ne olur |
|---|---|---|
| Deploys from owner/repo | Siteniz o depodan kurulur | Yönlendirmeler Vercel'de sizin yayınlamanız için hazırlanır. Geri kalan her şey o depoya, inceleyip birleştireceğiniz bir pull request olarak gider |
| Direct deploys (CLI / v0) | Dosyalar bir depodan kurulmadı, yüklendi | Yönlendirmeler yine aynı şekilde çalışır. Geri kalanı için bir depo yoktur, dolayısıyla o aksiyonlar size uygulamaya hazır halde gelir |
EOMA'nın Vercel üzerinden neyi yayınlayabildiği ve neyi yayınlayamadığı. Vercel sitenizin önünde bir CDN olarak durur ve bir isteğe siteniz görmeden önce farklı yanıt vermesi söylenebilir. Bu bir yönlendirme için yeterlidir, yani ziyaretçileri yenisine göndermesi gereken eski bir adres için, bu yüzden EOMA onları doğrudan Vercel'de hazırlar.
Sayfanın içinde yaşayan hiçbir şey için yeterli değildir. Bir başlık, bir açıklama ya da bir yapılandırılmış veri bloğu, sitenizin döndürdüğü HTML'in parçasıdır ve CDN onun içine uzanamaz. Vercel sitenizin barındırıldığı yerdir, yazıldığı yer değil: projeniz bir Git deposuna bağlıysa gerçek kaynak o depodur ve Vercel bilinçli olarak dışarıdan hiçbir şeyin onu değiştirmesine izin vermez, API'sinden Git tabanlı bir dağıtımın dosyalarını isteyin, reddeder. Bu iyi bir şeydir. Bizim de dahil olduğumuz hiç kimsenin, sitenizi geliştiricinizin arkasından sessizce yeniden yazamayacağı anlamına gelir.
Dolayısıyla o iş, sitenizin gerçekten yazıldığı yere gider. EOMA deponuzda bir pull request açar, siz inceleyip birleştirirsiniz ve Vercel sonucu her zamanki gibi kurup yayınlar.
Siz Publish düğmesine basana kadar Vercel'de hiçbir şey yayına girmez. EOMA bir yönlendirme hazırladığında, projenizin CDN → Routing Rules ("CDN → Yönlendirme Kuralları") altındaki bekleyen listesine iner, tam da kendi yaptığınız bir değişikliğin ineceği yere. Siz yayınlayana kadar üretim trafiğine dokunulmaz. EOMA onu yayınlayabilecek bir yetkiye sahiptir, tercihen yayınlamıyoruz, çünkü site sizindir.
Orada bekleyen kendinize ait yayınlanmamış bir yönlendirme değişikliği zaten varsa, EOMA üstüne eklemek yerine durur ve bunu söyler. Aksi halde sizinkini yayınlamak aynı basışta bizimkini de yayınlardı, tersi de geçerli.
Vercel'i bağlamanın asıl nedeni şudur: depo çoğu zaman adını sizin bilebileceğiniz bir şey değildir. Sıklıkla siteyi kuran ajansa, serbest çalışana ya da geliştiriciye aittir ve hiç görmediğiniz bir hesabın altındadır. Vercel hangisi olduğunu bilir. Onu bağlayın, biz de cevabını veremeyeceğiniz bir soruyu sormak yerine bunu projenizden okuyalım.
EOMA'nın okuyabildikleri. Projeleriniz ve ayarları, bir de dağıtımlarınız. Ortam değişkenleriniz değil, alan adlarınız değil, faturalandırmanız değil. Entegrasyonu istediğiniz zaman kendi Vercel panelinizden kaldırabilirsiniz ve kaldırdığınızda EOMA bunu hemen öğrenir.
Bir şeyler ters giderse
| Gördüğünüz | Nedeni | Ne yapmalı |
|---|---|---|
| Bağlayın düğmesi yerine "Yalnızca sahip" | EOMA'da bu markanın sahibi siz değilsiniz. | Marka sahibinden bağlamasını isteyin. |
| "This installation can't see any projects." ("Bu kurulum hiçbir proje göremiyor") | Entegrasyon projenizi tutmayan bir hesaba ya da takıma kuruldu veya ona erişim verilmedi. | Vercel'de EOMA entegrasyonunu açın ve sitenize hizmet eden projeye erişim verin. |
| "Install the EOMA integration on Vercel first." ("Önce EOMA entegrasyonunu Vercel'e kurun") | Proje listesi kurulum bitmeden istendi. | Tekrar Bağlayın'a basın ve Vercel adımını tamamlayın. |
| EOMA deponun başka birinin hesabında olduğunu söylüyor | Siteniz sahibi olmadığınız bir depodan kurulmuş, genellikle geliştiricinizin ya da ajansınızın. | EOMA'nın gösterdiği cümleyi onlara gönderin. EOMA'yı GitHub'a kurup o depoya erişim verirler. |
| Vercel projeniz GitLab ya da Bitbucket'tan dağıtılıyor | EOMA bugün yalnızca GitHub'da pull request açabilir. | Sayfa düzenlemeleri ve yapılandırılmış veri, sizin yerinize yayınlanmak yerine uygulamaya hazır halde size gelir. |
| "Vercel rejected our access." ("Vercel erişimimizi reddetti") | Entegrasyon kaldırıldı ya da izinleri Vercel tarafında değiştirildi. | EOMA'da bağlantıyı kesin ve yeniden kurun. |
| "You have an unpublished routing change waiting" ("Bekleyen yayınlanmamış bir yönlendirme değişikliğiniz var") | Vercel projenizde kimsenin yayınlamadığı, hazırda bekleyen bir kural var. | Vercel'de CDN → Routing Rules bölümünü açın ve bekleyeni ya yayınlayın ya da atın, sonra aksiyonu tekrar onaylayın. |
| Bir yönlendirme onaylandı ama sayfa hâlâ eski adrese gidiyor | Hazırlanmış, yayınlanmamış. O basış sizindir. | Vercel'de CDN → Routing Rules bölümünü açın ve Publish ("Yayınla") seçeneğini seçin. |
İlgili sayfalar
- GitHub · bir Vercel sitesinin değişikliklerinin gerçekte yayınlandığı yer
- Aksiyonlar · işi onayladığınız yer
- Entegrasyonlar · tüm bağlantılar tek yerde