VK Cloud logo

Kafka CLI және kcatBeta

Терминалдан орналастырылған Cloud Kafka данасына қосылу үшін Kafka CLI немесе kcat пайдаланыңыз. Құралды тапсырмаға байланысты таңдаңыз:

  • Kafka CLI — Kafka-ны басқару, хабарламаларды жіберу және оқу үшін.
  • kcat — Java орнатпай қосылуды тексеру, хабарламаларды жіберу және оқу үшін.

Қосылуға дайындық

  1. Kafka CLI немесе kcat орнатыңыз.
  1. VK Cloud жеке кабинетіне өтіңіз.

  2. Data Platform → Сервис даналары бөліміне өтіңіз.

  3. Cloud Kafka данасының атауын басыңыз.

  4. Жалпы ақпарат қойындысында қажетті қосылу нұсқасының жолын көшіріңіз:

    • TLS бар Bootstrap қосылу жолы — TLS арқылы қосылу үшін;
    • Bootstrap қосылу жолы — TLS-сіз қосылу үшін.
  5. TLS арқылы қосылу үшін сертификаттар тізбегін жүктеп алыңыз: Жалпы ақпарат қойындысындағы сертификат карточкасында ••• → Сертификаттар тізбегін жүктеп алу тармағын басыңыз.

  6. Cloud Kafka тіркелгісінің логині мен паролін дайындаңыз. Тіркелгіні сервис данасының бетінде қосуға болады.

Kafka CLI

Linux және macOS

  1. Терминалды ашып, Cloud Kafka тіркелгісінің логині мен паролі бар айнымалыларды орнатыңыз:

    K_USERNAME="<ЛОГИН>"K_PASSWORD="<ПАРОЛЬ>"
  2. TLS арқылы немесе TLS-сіз қосылу үшін /tmp/client.properties конфигурация файлын жасаңыз:

    cat > /tmp/client.properties <<EOFsecurity.protocol=SASL_SSLsasl.mechanism=SCRAM-SHA-512sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required username="${K_USERNAME}" password="${K_PASSWORD}";ssl.truststore.type=PEMssl.truststore.location=<СЕРТИФИКАТТАР_ТІЗБЕГІНЕ_ЖОЛ>ssl.endpoint.identification.algorithm=request.timeout.ms=30000EOF

    Мұндағы <СЕРТИФИКАТТАР_ТІЗБЕГІНЕ_ЖОЛ>: қосылуға дайындық кезінде Жалпы ақпарат қойындысынан жүктеп алынған сертификаттар тізбегі файлының жолы.

  3. Орта айнымалыларын орнатыңыз:

    export K_BOOTSTRAP="<BOOTSTRAP_СЕРВЕРІНІҢ_МЕКЕНЖАЙЫ_МЕН_ПОРТЫ>"export K_CLI_BASE="<KAFKA_CLI_ДИРЕКТОРИЯСЫНА_ЖОЛ>"export K_CONFIG=/tmp/client.properties

    Мұндағы:

    • <BOOTSTRAP_СЕРВЕРІНІҢ_МЕКЕНЖАЙЫ_МЕН_ПОРТЫ>: дайындық кезінде көшірілген қосылу жолы;
    • <KAFKA_CLI_ДИРЕКТОРИЯСЫНА_ЖОЛ>: Kafka CLI орнатылған директория. Мысалы: /opt/homebrew/opt/kafka/bin.
  4. Топиктер тізімін алыңыз:

    "${K_CLI_BASE}/kafka-topics.sh" \    --command-config "${K_CONFIG}" \    --bootstrap-server "${K_BOOTSTRAP}" \    --list

    Терминалда қолжетімді топиктер тізімі пайда болады. Қолжетімді топиктер болмаса, нәтиже бос болуы мүмкін.

Windows

  1. PowerShell ашып, Cloud Kafka тіркелгісінің логині мен паролі бар айнымалыларды орнатыңыз:

    $env:K_USERNAME = "<ЛОГИН>"$env:K_PASSWORD = "<ПАРОЛЬ>"
  2. TLS арқылы (трафик шифрланады) немесе TLS-сіз (трафик шифрланбайды) қосылу үшін клиент конфигурациясының файлын жасаңыз:

    @"security.protocol=SASL_SSLsasl.mechanism=SCRAM-SHA-512sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required username="$env:K_USERNAME" password="$env:K_PASSWORD";ssl.truststore.type=PEMssl.truststore.location=<СЕРТИФИКАТТАР_ТІЗБЕГІНЕ_ЖОЛ>ssl.endpoint.identification.algorithm=request.timeout.ms=30000"@ | Set-Content -Path "$env:TEMP\client.properties" -Encoding ASCII

    Мұндағы <СЕРТИФИКАТТАР_ТІЗБЕГІНЕ_ЖОЛ>: қосылуға дайындық кезінде Жалпы ақпарат қойындысынан жүктеп алынған сертификаттар тізбегі файлының жолы. Жолда қиғаш сызықтарды пайдаланыңыз, мысалы C:/certs/ca.crt.

  3. Орта айнымалыларын орнатыңыз:

    $env:K_BOOTSTRAP = "<BOOTSTRAP_СЕРВЕРІНІҢ_МЕКЕНЖАЙЫ_МЕН_ПОРТЫ>"$env:K_CLI_BASE  = "<KAFKA_CLI_ДИРЕКТОРИЯСЫНА_ЖОЛ>"$env:K_CONFIG    = "$env:TEMP\client.properties"

    Мұндағы:

    • <BOOTSTRAP_СЕРВЕРІНІҢ_МЕКЕНЖАЙЫ_МЕН_ПОРТЫ>: дайындық кезінде көшірілген қосылу жолы;
    • <KAFKA_CLI_ДИРЕКТОРИЯСЫНА_ЖОЛ>: Kafka CLI скрипттері бар директория, мысалы C:\kafka\bin\windows.

    Kafka CLI үшін қысқа жолы бар директорияны пайдаланыңыз, мысалы C:\kafka. Жол ұзын болса, скрипт The input line is too long қатесімен аяқталуы мүмкін.

  4. Топиктер тізімін алыңыз:

    & "$env:K_CLI_BASE\kafka-topics.bat" `    --command-config "$env:K_CONFIG" `    --bootstrap-server "$env:K_BOOTSTRAP" `    --list

    Терминалда қолжетімді топиктер тізімі пайда болады. Қолжетімді топиктер болмаса, нәтиже бос болуы мүмкін.

kcat

Терминалды ашып, таңдалған қосылу нұсқасына арналған команданы орындаңыз.

kcat -b "<BOOTSTRAP_СЕРВЕРІНІҢ_МЕКЕНЖАЙЫ_МЕН_ПОРТЫ>" -X security.protocol=SASL_SSL -X sasl.mechanism=SCRAM-SHA-512 -X sasl.username="<ЛОГИН>" -X sasl.password="<ПАРОЛЬ>" -X ssl.ca.location="<СЕРТИФИКАТТАР_ТІЗБЕГІНЕ_ЖОЛ>" -L

Команда Cloud Kafka данасының брокерлері мен топиктері туралы ақпаратты шығарады.

Мұндағы:

  • <BOOTSTRAP_СЕРВЕРІНІҢ_МЕКЕНЖАЙЫ_МЕН_ПОРТЫ>: дайындық кезінде көшірілген қосылу жолы.
  • <ЛОГИН> және <ПАРОЛЬ>: Cloud Kafka пайдаланушысының тіркелгі деректері.
  • <СЕРТИФИКАТТАР_ТІЗБЕГІНЕ_ЖОЛ>: дайындық кезінде Жалпы ақпарат қойындысынан жүктеп алынған сертификаттар тізбегі файлының жолы. Тек TLS арқылы қосылу үшін қолданылады.
Мақала пайдалы болды ма?