Confluence

Bir Confluence Cloud sitesini ya da bir Confluence Data Center örneğini indeksleyin: hesabın okuyabildiği her space, ya da tam olarak sizin adlandırdığınız space’ler, Confluence’ın storage formatından Markdown’a render edilir.

Bir tane eklemek

Add source → Confluence

Test connection’a basın: hiçbir şeyi indekslemeden siteyi, kimlik bilgisini ve kapsamı kontrol eder — kaydetmeden önce kullanın. Her iki durumda da dış sınır hesabın kendi izinleridir: Contextator, hesabın okuyamadığı bir sayfayı asla görmez.

Cloud ya da Data Center

• Cloud, https://<site>.atlassian.net/wiki altındaki REST API’sidir; bir Atlassian hesap e-postası ve bir API token ile kimlik doğrular.
• Data Center 7.9 ve sonrası, <base URL>/rest/api altındaki REST API’sidir; bearer olarak gönderilen bir personal access token ile kimlik doğrular — e-posta yoktur. Herhangi bir kimlik bilgisi gönderilmeden önce, sunucunun sürümü onun anonim application manifest’inden okunur; daha eski bir sürüm, okunamayan bir sürüm ya da Confluence olmayan bir sunucu, sürüm adlandırılarak hem Test connection’da hem de senkronizasyonda reddedilir.
• Data Center’dan önceki ürün hattı olan Confluence Server desteklenmez. Kullandığınız buysa, space’i dışa aktarın ve bunun yerine bir Yükleme kaynağı olarak ekleyin.

Dahili ağdaki bir Data Center

Base URL bir editör tarafından yazılır ve sunucu ona kaynağın token’ını taşıyarak bağlanır, bu yüzden bir Confluence kaynağının nereye bağlanabileceği sınırlıdır (ADR-0088):

• Her zaman reddedilir: loopback ve link-local adresleri — bulut metadata adresi 169.254.169.254 dahil — artı belirtilmemiş ve multicast adresleri, ve bunların IPv4-eşlenmiş IPv6 biçimleri.
• İzin verilmedikçe reddedilir: özel adresler — 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, fc00::/7, ve kullanımdan kaldırılmış site-local aralığı fec0::/10.

Data Center’ınız özel bir adrese çözümleniyorsa, host’unu CONFLUENCE_ALLOWED_HOSTS’a ekleyin ve yeniden başlatın:

CONFLUENCE_ALLOWED_HOSTS=wiki.corp.example

Kontrol, bağlantının gerçekte kullandığı adres üzerinde çalışır — DNS’ten sonra, ve her yönlendirmede yeniden — böylece ne içeri çözümlenen herkese açık görünümlü bir ad, ne de dahili bir adrese yönlendirme bunu atlatabilir. Bir ret, kuralı kaynağın satırında ve Test mesajında adlandırır, örneğin:

refused: `wiki.corp.example` resolves to a private address; list `wiki.corp.example` in CONFLUENCE_ALLOWED_HOSTS to allow it

Bu durumda hiçbir istek — ve dolayısıyla hiçbir token — gönderilmez. Liste yalnızca özel adres kuralını, ve yalnızca üzerindeki adlar için kaldırır; kontrolü tamamen kapatan bir anahtar yoktur. CONFLUENCE_ALLOWED_HOSTS, ürünle gelen .env.example’in geri kalanıyla birlikte .env içinde ayarlanır.

Bir sayfa neye dönüşür

Confluence’ın storage formatı, XHTML artı Confluence’ın kendi ac: ve ri: ad alanlarıdır. .html dosyalarının geçtiği aynı HTML→Markdown dönüşümünden geçer — bkz. İçerik Türleri — bu yüzden tablolar, kod blokları, görev listeleri ve uyarı kutuları yapı olarak hayatta kalır.

• Makrolar açılır. Bir expand’in ya da panel’in içindeki metin indekslenir; makronun kendi yapılandırması indekslenmez.
• Uyarı kutuları, onları uyarı kutusu yapan sözcüğü korur, bu yüzden bir not hâlâ not olarak okunur.
• Kod blokları hayatta kalır. Sıradan bir HTML ayrıştırıcısının göz ardı ettiği <![CDATA[…]]> içinde yaşarlar — bu, dönüşüm çalışmadan önce ele alınır, sonra değil.

Nasıl taze tutulur

Bir Confluence kaynağının zamanlanmış kontrolü tek bir HTTPS isteğidir: çalıştırmanın indekslediği tam olarak space’ler üzerinde bir CQL araması, kaç sayfa olduğunu ve en yenisine en son ne zaman dokunulduğunu bildirir. İkisi de değişmediyse hiçbir şey çekilmez.

Data Center’da, bir sayfa değişir değişmez imzalı bir webhook bir senkronizasyon başlatabilir — bkz. Push Webhook’ları. Senkronizasyon aralığını tamamlar; onun yerine geçmez. Confluence Cloud bir Forge ya da Connect uygulaması olmadan bir webhook gönderemez, bu yüzden orada kaynağın taze kalma yolu senkronizasyon aralığıdır — bkz. İndeksleme.

Bilinmesi gereken sınırlar

• Bir kaynak en fazla 5.000 sayfa indeksler. Daha büyük bir wiki, tavana kadar indekslenir ve çalıştırma bunu, tam olarak bu sözlerle, kaynağın satırında söyler. Her birinde daha az space adlandırarak birden çok kaynağa bölün.
• Adlandırılmış birkaç space’ten biri yanıt vermeyi bırakırsa hiçbir şey silinmez. Yeniden adlandırılmış bir space anahtarı ya da hesaptan geri alınmış bir izin, API’ye hatasız, sayfası olmayan bir space olarak okunur — bu yüzden az önce belge tutan ama şimdi hiçbirini sunmayan yapılandırılmış bir space, belgelerini sessizce silmek yerine, space’i adlandırarak senkronizasyonu başarısız kılar. Spaces boş bırakıldığında orada ne olması gerektiğine dair bir liste yoktur ve bu kontrol yapılamaz.
• Render edilemeyen bir sayfa bir şikâyettir, başarısız bir senkronizasyon değil. Başarısız olan bir istek başarısız bir senkronizasyondur. İkisi ayrı tutulur, böylece rate-limit’e takılan bir ilk çekim, eksik bir wiki’nin üçte biri üzerinden başarı bildiremez.

Sık karşılaşılan sorunlar