Bir kapsayıcıda Qlik Data Gateway - Doğrudan Erişim kurulumu

Son güncelleme: 30.09.2026

Bu konu, kapsayıcıya alınmış Doğrudan Erişim ağ geçidi kurulumunun nasıl yapılacağını ana hatlarıyla açıklar. Önkoşulları ve kurulum talimatlarını sağlar ve kapsayıcıya alınmış Doğrudan Erişim ağ geçidi ile çalışırken bilmeniz gereken sınırlamaları ve dikkate alınması gereken hususları açıklar.

Doğrudan Erişim ağ geçidi 1.8.0 sürümünden itibaren desteklenir.

Kapsayıcıya alınmış Doğrudan Erişim ağ geçidi nedir?

Doğrudan Erişim ağ geçidi bir Docker kapsayıcısına dağıtabilirsiniz. Bu tür dağıtım, kapsayıcılı Doğrudan Erişim ağ geçidi olarak adlandırılır. Kapsayıcılı Doğrudan Erişim ağ geçidi dağıtımları Linux, macOS ve Windows için desteklenmektedir.

Kapsayıcıya alınmış Doğrudan Erişim ağ geçidi, Doğrudan Erişim ağ geçidi ortamınıza taşınabilirlik sağlar.

Qlik Data Gateway - Doğrudan Erişim kullanırken en iyi uygulamalar

Qlik Data Gateway - Doğrudan Erişim kullanırken başarılı bir deneyim için aşağıdaki en iyi uygulamalara uyulması önemle tavsiye edilir:

Mevcut kaynaklara aşırı yüklenme riskini artıracağından ve sistem kararlılığını etkileyeceğinden, geliştirme, kullanıcı kabul testi ve üretim için aynı Doğrudan Erişim ağ geçidi öğesini kullanmayın. İş perspektifinden bakıldığında, yetersiz kaynaklar ve azalan kararlılığın birleşimi, üretim uygulama verilerinin gecikmeli olarak güncellenmesine neden olabilir.
Optimum performans için Doğrudan Erişim ağ geçidi öğesini veri kaynağınıza mümkün olduğunca yakın bir ortama kurun.

Sistem önkoşulları

Bu bölüm, kapsayıcılı Doğrudan Erişim ağ geçidi kullanımına ilişkin gereksinimleri açıklar.

Yazılım gereksinimleri

Ana makinede yüklü Docker Engine 20.9+ sürümü ve Docker Compose eklentisi (docker compose, v2 söz dizimi).

Gerekli bağlantı noktaları ve protokoller

Gerekli bağlantı noktaları ve protokoller için bkz. Gerekli bağlantı noktaları ve protokoller.

Önerilen donanım

Host: 8 çekirdek, 32 GB bellek, Docker için kullanılabilir 5 GB depolama alanı
İsteğe bağlı: Ağ geçidinin ana makinedeki diğer kapsayıcılar veya işlemlerle rekabet etmek yerine ayrılmış kapasiteye sahip olması için compose dosyasındaki kapsayıcı üzerinde eşleşen sınırları ayarlayın:
```
direct-access-agent:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "6"
          memory: 24G
...
dcaas:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"
```

Minimum donanım

Minimum donanım yalnızca sürekli düşük veri hacimleri ve sınırlı sayıda eşzamanlı yeniden yükleme ile daha küçük özel dağıtımlar (geliştirme, test veya üretim) kullanılan belirli senaryolar için uygundur.

Ana makine: 4 çekirdek, 8 GB bellek, Docker için kullanılabilir 5 GB depolama alanı
İsteğe bağlı: Ağ geçidinin ana makinedeki diğer kapsayıcılar veya işlemlerle rekabet etmek yerine ayrılmış kapasiteye sahip olması için compose dosyasındaki kapsayıcı üzerinde eşleşen sınırları ayarlayın:
```
direct-access-agent:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"
          memory: 4G
...
dcaas:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"
```

Qlik Data Gateway - Doğrudan Erişim yükleme

Direct Access gateway'i kurma işlemi, gerek Yönetim etkinlik merkezinde gerekse Direct Access gateway sunucusunda gerçekleştirilmesi gereken yordamlar içerir.

Yönetim etkinlik merkezinde gerçekleştirilmesi gereken veri ağ geçidi prosedürleri, kiracı yöneticisi izni gerektirir.

Birinci aşama: Qlik Data Gateway - Doğrudan Erişim indirme

Yönetim etkinlik merkezindeki Veri ağ geçitleri öğesini seçin.

Mevcut veri ağ geçitleri her ağ geçidi hakkında temel bilgiler gösteren bir tabloda listelenir.
Dağıt araç çubuğu düğmesine tıklayın.

Veri Ağ Geçidini Dağıt diyalog penceresi açılır.
Veri Ağ Geçidi - Doğrudan Erişim - Kapsayıcılı Doğrudan Erişim Ağ Geçidi'ni seçin, Qlik Müşteri Sözleşmesi'ni kabul edin ve İndir'e tıklayın. Direct Access gateway kurulum dosyası (docker-compose.qlik-data-gateway-direct-access.yml) makinenize indirilecektir.

İkinci aşama: Docker Compose dosyasını çalıştırarak dağıtımı başlatın

Doğrudan Erişim ağ geçidi dağıtımını başlatmak için aşağıdaki komutu çalıştırın:

docker compose -f docker-compose.qlik-data-gateway-direct-access.yml up

Üçüncü aşama: Doğrudan Erişim ağ geçidi kurulumu

Ayrıntılı kurulum talimatları için bkz. Üçüncü aşama: Doğrudan Erişim ağ geçidi kurulumu.

Dördüncü aşama: Veri ağ geçidini kaydetme

Bir sonraki adım, veri ağ geçidini kaydetmektir. Bu işlem, Yönetim etkinlik merkezi üzerinden veya komut satırından yapılabilir.

Yönetim etkinlik merkezini kullanarak ağ geçidini kaydedebilirsiniz. Bkz. Seçenek 1: Yönetim etkinlik merkezi aracılığıyla.

Ayrıca Yönetim etkinlik merkezini kullanmadan Doğrudan Erişim ağ geçidi öğesini komut satırından otomatik olarak da kaydedebilirsiniz. Bu yöntem, bir OAuth istemcisinden oluşturulan kısa ömürlü bir oturum belirteci kullanır.

Otomatik kayıt yalnızca komut satırı üzerinden desteklenir. Otomatik ağ geçidi kaydı için bir REST API şu anda mevcut değildir.

Ön koşullar

OAuth istemcilerini oluşturmak ve yönetmek için kiracı yöneticisi iznine sahip bir API anahtarı.

Ağ geçidini otomatik kayıt ile kaydetme

İlk olarak, direct-access-agent kapsayıcısında bir OAuth istemci kimliğinin yanı sıra bir onay anahtarı (kısa ömürlü belirteç) oluşturmak için bir Python ortamı kurmanız gerekir. Şu komutları ayrı ayrı, bu sırayla çalıştırın:
1. docker exec -it --user root direct-access-agent-1 bash
2. apt-get update && apt-get install -y python3 python3-pip
3. apt install python3.11-venv
4. python3 -m venv .venv
5. source .venv/bin/activate
6. pip install cryptography pyjwt
7. python3 generate_gateway_assertion.py --tenant-url <tenant-url>
Yukarıdaki listedeki son komut için etkileşimli istemleri takip edin ve sağlandığında client_id (OAuth istemci kimliği) ile assertion bilgilerini kopyalayın. Bu ayrıntıları şimdilik kağıda veya geçici bir metin dosyasına kaydedin—bunlar sürecin sonraki adımları için gereklidir.
client_id ve assertion değerlerini not aldıktan sonra, aşağıdaki komutla Python ortamını temizleyin:

deactivate
OAuth istemcisinin onay yöntemini güvenilir olarak ayarlayın.

curl "https://<tenant-url>/api/v1/oauth-clients/<client-id>/connection-configs/me" -X PATCH -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <api-key>' -d '[{"op":"replace","path":"/consentMethod","value":"trusted"}]'
Bir erişim belirteci isteyin. Bu, ağ geçidi tarafından kullanılan bot kullanıcı hesabının otomatik olarak oluşturulmasını da tetikler.

curl "https://<tenant-url>/oauth/token" -X POST -H 'content-type: application/x-www-form-urlencoded' -d "grant_type=client_credentials" -d "client_id=<client-id>" -d "client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer" -d "client_assertion=<assertion>" -d "scope=admin.direct-access-gateways:register_gateway admin.direct-access-gateways:delete_gateway"

Bilgi notu
Onaylamanın süresi dolduysa, komut dosyasını sanal ortamdan yeniden çalıştırın.
Otomatik olarak oluşturulan bot kullanıcısını arayın.

curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <API-key>'
my-bot-client kimliğini kopyalayın.
Bir "DAG Registration" rolü oluşturun.

curl "https://<tenant-url>/api/v1/roles" -X POST -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <API-key>' -d '{"name":"DAG Registration","description":"Role for registering a gateway","assignedScopes":["admin.direct-access-gateways:register_gateway", "admin.direct-access-gateways:delete_gateway"]}'
Bot kullanıcısına kiracı düzeyinde roller atayın.

curl "https://<tenant-url>/api/v1/users/<bot-user-ID>" -X PATCH -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <API-key>' -d ' [ { "op": "replace", "path": "/assignedRoles", "value": [ { "name": "DAG Registration" } ] } ]'
Direct Access Gateway alanını alın.

curl "https://<tenant-url>/api/v1/spaces" -H 'authorization: Bearer <API-key>'
Direct Access Gateway alan kimliğini kopyalayın.
Bot kullanıcısını alana Düzenleyebilir izniyle ekleyin.

curl "https://<tenant-url>/api/v1/spaces/<DAG-space-ID>/assignments" -X POST -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <API-key>' -d '{"assigneeId": "<bot-user-ID>","roles": ["consumer","dataconsumer","producer"], "type": "user"}'
Mevcut onaylamanın süresi dolmuşsa yeni bir tane oluşturun. Şu komutu çalıştırın:

python3 generate_gateway_assertion.py --tenant-url <tenant-url>
Komut isteminde gerekli adımları izleyin. OAuth istemcisi zaten oluşturulduğundan, bu API çağrısı kullanılarak JWK'nin güncellenmesi gerekir:

curl "https://<tenant-url>/api/v1/oauth-clients/<client-ID>" -X PATCH -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <API-key>' -d '[{"op":"replace","path":"/publicKeys/0/y","value":"<Y-value-from-JWK>"},{"op":"replace","path":"/publicKeys/0/x","value":"<X-value-from-JWK>"},{"op":"remove","path":"/publicKeys/0/use"},{"op":"replace","path":"/publicKeys/0/kid","value":"<kid-value-from-JWK>"}]'
Ağ geçidini kaydedin:

dotnet ConnectorAgent.dll qcs register_gateway --tenant_url <tenant-url> --gateway_name <DAG-name> --gateway_description <DAG-description> --space_name <space-name> --client-id <client-ID> --assertion <assertion>

Otomatik olarak kaydedilen bir ağ geçidini kaldırma

Yukarıda açıklanan otomatik, oturum belirteci tabanlı yöntem kullanılarak kaydedilen bir ağ geçidinin kaydını silmek için aşağıdaki adımları uygulayın. Bu adımlar ayrıca bunun için oluşturulan OAuth istemcisini, bot kullanıcısını ve rolü de kaldırır.

Yukarıdaki bölümde açıklandığı gibi bir onaylama oluşturun.
Ağ geçidini silin:

dotnet ConnectorAgent.dll qcs delete_gateway --tenant_url <tenant-url> --gateway_name <gateway-name> --client-id <client-ID> --assertion <assertion>
Ağ geçidi için oluşturulan bot kullanıcı hesabını arayın.

curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <api-key>'
Bot kimliğini kopyalayın.
Bu bot kullanıcı hesabını silin.

curl -X DELETE "https://<tenant-url>/api/v1/users/<bot-user-ID>" -H "Authorization: Bearer <api-key>"
Ağ geçidi için oluşturulan “DAG Registration” rolünü arayın.

curl "https://<tenant-url>/api/v1/roles?limit=1&filter=(name%20eq%20%22DAG%20Registration%22)" -H "Authorization: Bearer <api-key>"
Rol kimliğini kopyalayın.
Bu rolü silin.

curl -X DELETE "https://<tenant-url>/api/v1/roles/<role-ID> -H "Authorization: Bearer <api-key>"
OAuth istemcisini silin.

curl -X DELETE https://<tenant-url>/api/v1/oauth-clients/<OAuth-client-ID> -H "qlik-confirm-delete: <OAuth-client-ID>" -H "Authorization: Bearer <api-key>

Beşinci aşama: Doğrudan Erişim ağ geçidi sunucusunda Qlik Data Gateway - Doğrudan Erişim hizmetini başlatın

Qlik Data Gateway - Doğrudan Erişim servisini başlatmak için dcaas-dg ve direct-access-agent kapsayıcılarını başlatın.

Altıncı aşama: Veri kaynağına bir bağlantı ekleyin

Bkz. Altıncı aşama: Veri kaynağına bir bağlantı ekleyin.

Ortam ayarları

Bu bölüm, veri kaynaklarınızı ağ geçidi aracılığıyla düzgün bir şekilde bağlamak için yapılandırmanız gerekebilecek docker-compose.qlik-data-gateway-direct-access.yml dosyasındaki belirli ortam değişkenlerini listeler.

ALLOW_SOURCES: Virgülle ayrılmış ana makine adları ve IP'lerin izin verilenler listesi. Ağ geçidi aracısının kendi sunucunuzdaki veya yerel ya da özel ağdaki başka bir ana bilgisayardaki bir şeye bağlanması gerektiğinde (örneğin localhost üzerindeki bir veritabanı, bir Docker hizmet adı veya özel IP'li bir ana bilgisayar), bu adresi ALLOW_SOURCES alanına eklersiniz — aksi takdirde Bağlantı denemesi reddedilir.

Desteklenen veri kaynakları

Kapsayıcılı kurulumlar için aşağıdaki ODBC bağlayıcıları desteklenmektedir:
- PostgreSQL
- SQL Server
- Oracle
ODBC bağlayıcıları hakkında daha fazla bilgi için bkz. ODBC veritabanları ‒ Qlik Cloud (yalnızca İngilizce).
REST bağlayıcı (REST Direct Access gateway aracılığıyla). REST veri kaynakları hakkında daha fazla bilgi için bkz. REST kaynakları ‒ Qlik Cloud (yalnızca İngilizce).

Daha fazla bilgi

Bu sayfa size yardımcı oldu mu?

Bu sayfa veya içeriği ile ilgili bir sorun; bir yazım hatası, eksik bir adım veya teknik bir hata bulursanız lütfen bize bildirin!

Geri bildiriminizi buradan iletin