Elasticsearch:Connect to a cluster from the command line

Başlamadan önce

Küme uç noktasını edinme

Elasticsearch kümenize bir VPC özel ağı üzerinden dahili uç nokta veya genel uç nokta kullanarak bağlanabilirsiniz.

• Dahili uç nokta: Elasticsearch kümenize düşük gecikme süresi ve yüksek kararlılık sağlayan bağlantı sunar. Bu uç nokta, küme oluşturulduğunda varsayılan olarak etkinleştirilir.

• Genel uç nokta: Elasticsearch kümenize internet üzerinden bağlanmanıza olanak tanır. Bu uç noktayı manuel olarak etkinleştirmeniz gerekir.

Genel erişimi etkinleştirme

1. Elasticsearch konsolunda oturum açın ve örneğinizin Basic Information sayfasına gidin.

2. Sol gezinme bölmesinde Configuration and Management > Security Settings seçeneğini belirleyin ve genel erişimi etkinleştirin. Küme durumu Initializing durumundan Valid durumuna geçtiğinde genel erişim etkinleştirilmiş olur.

   Genel erişimi etkinleştirdiğinizde, genel uç nokta es-cn-<instance_ID>.public.elasticsearch.aliyuncs.com biçiminde olur. Genel IP izin listesi varsayılan olarak boştur ve yapılandırılması gerekir.

   Önemli

   Genel uç nokta kullanmak Elasticsearch kümenizin güvenliğini tehlikeye atabilir. Genel uç nokta kullanıyorsanız, bir IP izin listesi yapılandırdığınızdan ve işiniz bittiğinde genel erişimi devre dışı bıraktığınızdan emin olun.

IP izin listesi yapılandırma

Kümenizi güvence altına almak için, erişim amacıyla kullanmak istediğiniz cihazın IP adresini Elasticsearch kümesinin VPC özel ağ veya genel IP izin listesine eklemelisiniz. Yalnızca izin listesindeki IP adreslerine sahip cihazlar kümeye erişebilir.

1. Erişim amacıyla kullanmak istediğiniz cihazın IP adresini edinin.

   Aşağıdaki tabloda farklı senaryolar için IP adresinin nasıl edinileceği açıklanmaktadır.

   Senaryo	IP adresi	Yöntem
   Yerel bir cihazdan bir Elasticsearch kümesine bağlanma	Yerel cihazınızın genel IP adresi. Yerel cihazınız ev veya kurumsal ağ gibi bir yerel alan ağındaysa (LAN), LAN ağ geçidinin genel IP adresini kümenin genel IP izin listesine eklemeniz gerekir.	Yerel cihazınızın genel IP adresini bulmak için curl ipinfo.io/ip komutunu çalıştırın.
   Farklı bir VPC'deki bir ECS örneğinden bir Elasticsearch kümesine bağlanma	ECS örneğinin genel IP adresi.	Örnek listesinde görüntülemek için ECS konsolunda oturum açın.
   Aynı VPC'deki bir ECS örneğinden bir Elasticsearch kümesine bağlanma	ECS örneğinin özel IP adresi.	Örnek listesinde görüntülemek için ECS konsolunda oturum açın.

2. Bu IP adresini bir izin listesi grubuna ekleyin.

   1. Elasticsearch konsolunda oturum açın. Örneğinizin Basic Information sayfasında sol gezinme bölmesinden Configuration and Management > Security Settings seçeneğini belirleyin. VPC özel ağ veya genel IP izin listesini yapılandırmak için Modify öğesine tıklayın.

   2. varsayılan grubun sağındaki Configure seçeneğine tıklayın. Görüntülenen iletişim kutusunda VPC özel ağ veya genel IP izin listesine IP adresleri ekleyin. Bir kümeye en fazla 300 IP adresi veya CIDR bloğu ekleyebilirsiniz. Birden çok girişi virgül (,) ile ayırın ve etrafına boşluk eklemeyin.

      • Özel bir grup oluşturmak için Add IP address whitelist Group seçeneğine de tıklayabilirsiniz.

      • İzin listesi grupları yalnızca IP adresi yönetimi içindir ve erişim izinlerini etkilemez. Tüm gruplardaki tüm IP adresleri aynı izinlere sahiptir.

      Yapılandırma türü	Biçim ve örnek	Önemli notlar
      IPv4 adres biçimi	Tek IP: 192.168.0.1 CIDR bloğu: 192.168.0.0/24	Tüm erişimleri reddet: 127.0.0.1 Tüm erişimlere izin ver: 0.0.0.0/0 Önemli Bu yüksek bir güvenlik riski oluşturur. 0.0.0.0/0 yapılandırmamanızı kesinlikle öneririz. Bazı küme sürümleri (örneğin 7,16 ve 8,5) ve bölgeler 0.0.0.0/0 değerini desteklemez. Ayrıntılar için konsol kullanıcı arayüzüne veya hata mesajlarına bakın.
      IPv6 adres biçimi (Yalnızca China (Hangzhou) bölgesindeki v2 dağıtım mimarisi kümeleri için desteklenir)	Tek IP: 2401:XXXX:1000:24::5 CIDR bloğu: 2401:XXXX:1000::/48	Tüm erişimleri reddet: ::1 Tüm erişimlere izin ver: ::/0 Önemli Bu yüksek bir güvenlik riski oluşturur. ::/0 yapılandırmamanızı kesinlikle öneririz. Bazı küme sürümleri ::/0 değerini desteklemez. Ayrıntılar için konsol kullanıcı arayüzüne veya yapılandırma istemlerine bakın.

   3. OK öğesine tıklayın.

# Public HTTPS
curl -u '<UserName>:<YourPassword>' 'https://<YourEsHost>:port'

# Private HTTP
curl -u '<UserName>:<YourPassword>' 'http://<YourEsHost>:port'

# Private HTTPS (use -k to bypass certificate validation)
curl -k -u '<UserName>:<YourPassword>' 'https://<YourEsHost>:port'

# Public HTTPS access
curl -u 'user123:Passw0rd!' 'https://es-xx-xxxxxxxxxxxxxxxxx.public.elasticsearch.aliyuncs.com:9200'

# Private HTTP access
curl -u 'user123:Passw0rd!' 'http://es-cn-0pp1****.elasticsearch.aliyuncs.com:9200'

# Private HTTPS access (-k to bypass certificate validation)
curl -k -u 'user123:Passw0rd!' 'https://es-cn-0pp1****.elasticsearch.aliyuncs.com:9200'

{
  "name" : "es-cn-aic**************-master-i-2",
  "cluster_name" : "es-cn-aic**************",
  "cluster_uuid" : "InmpfI1oQB2ijtdZ******",
  "version" : {
    "number" : "8.17.0",
    "build_flavor" : "default",
    "build_type" : "docker",
    "build_hash" : "0bdf7********************************50279ae7c",
    "build_date" : "2025-03-05T02:31:55.853663566Z",
    "build_snapshot" : false,
    "lucene_version" : "10.0.0",
    "minimum_wire_compatibility_version" : "7.17.0",
    "minimum_index_compatibility_version" : "7.0.0"
  },
  "tagline" : "You Know, for Search"
}

Bağlantı hatalarını giderme

Elasticsearch kümenize bağlanamıyorsanız aşağıdaki öğeleri sırayla kontrol edin:

1. Ağ bağlantısı: Elasticsearch kümesi ile istemcinin aynı VPC içinde olduğunu doğrulayın. Aynı VPC içinde değillerse, iki ağı Cloud Enterprise Network (CEN) veya bir NAT ağ geçidi kullanarak birbirine bağlayın.

2. Güvenlik grubu kuralları: ECS güvenlik grubunun gelen kurallarının 9200 numaralı bağlantı noktasını açıp açmadığını kontrol edin. RDS for MySQL veri senkronizasyonu senaryolarında hem Elasticsearch kümesinin hem de RDS for MySQL örneğinin birbirlerinin IP adreslerini genel IP izin listesine veya VPC özel ağ izin listesine eklediğinden emin olun.

3. Docker yönlendirme tablosu: İstemci bir Docker konteynerinde çalışıyorsa Docker, ana bilgisayarın yönlendirme tablosunu değiştirerek aynı VPC içindeki ana bilgisayarlar arasındaki bağlantıyı bozabilir. Yönlendirme tablosunu incelemek ve yönlendirme sorunlarını tespit etmek için istemcide route -n komutunu çalıştırın.

4. Alan adı ve bağlantı noktası: Küme uç noktasının (alan adı) ve bağlantı noktasının doğru yazıldığını doğrulayın. Uç noktanın edinilmesi hakkında daha fazla bilgi için bu konunun "Başlamadan önce" bölümüne bakın.

5. Güvenlik duvarı ve yönlendirme kısıtlamaları: Ağınızda bir kurumsal güvenlik duvarının veya başka bir yönlendirme kısıtlamasının 9200 numaralı bağlantı noktasını engelleyip engellemediğini kontrol edin.

6. Zaman aşımı ayarları: Yanlış zaman aşımlarından kaynaklanan bağlantı hatalarını önlemek için istemci tarafındaki ConnectTimeout ve SocketTimeout parametrelerini artırın.

İlgili yapılandırma için bu konudaki aşağıdaki bölümlere bakın:

• Küme parolasını unuttuysanız Elasticsearch konsolunda sıfırlayabilirsiniz.

• Genel erişimi ilk kez etkinleştiriyorsanız, varsayılan izin listesi grubundan 127.0.0.1 adresini kaldırın ve cihazınızın genel giden IP adresini ekleyin. Daha fazla bilgi için bu konunun "IP izin listesi yapılandırma" bölümüne bakın.