アーカー

GitLabはirkerサーバーに更新メッセージをプッシュする方法を提供します。インテグレーションを設定すると、プロジェクトにプッシュするたびにインテグレーションが起動し、irkerサーバーに直接データを送信します。

irker インテグレーション API ドキュメントも参照してください。

詳しくはirkerプロジェクトのホームページをご覧ください。

irkerデーモンのセットアップ

irkerデーモンをセットアップする必要があります。そのためには

  1. リポジトリからirkerのコードをダウンロードしてください:

    git clone https://gitlab.com/esr/irker.git
    
  2. Python スクリプトirkerd を実行してください。これはゲートウェイスクリプトです。IRCサーバーにメッセージを送るIRCクライアントとしても、GitLabサービスからのメッセージを受け取るTCPサーバーとしても動作します。

irkerサーバーが同じマシン上で動いていれば完了です。そうでない場合は、次のセクションの最初のステップに従う必要があります。

caution
irkerは認証を内蔵していないので、ファイアウォールの外でホストしている場合、IRCチャンネルをスパムする脆弱性があります。悪用を防ぐには、デーモンをセキュリティで保護されたネットワーク上で実行するようにしてください。詳しくは、irkerのセキュリティ解析を読んでください。

GitLabで以下のステップを完了します。

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 設定]>[インテグレーション]を選択します。
  3. irker(IRCゲートウェイ)を選択します。
  4. アクティブ] トグルが有効になっていることを確認します。
  5. オプション。Server host] に、irkerd を実行するサーバー・ホスト・アドレスを入力します。空白の場合、デフォルトはlocalhost です。
  6. オプション。Server port] に、irkerd のサーバ・ポートを入力します。空白の場合、既定値は6659になります。
  7. 省略可能です。Default IRC URI には、デフォルトの IRC URI をirc[s]://domain.name の形式で入力してください。完全な URI ではなく、Recipientsで指定したチャンネルやユーザーの前に付加されます。
  8. 受信者」の下に、更新を受信するユーザーまたはチャンネルをスペースで区切って入力します (例:#channel1 user1)。詳細については、「irkerの受信者を入力する」を参照してください。
  9. オプション。メッセージをハイライトするには、[メッセージをカラー化] チェックボックスを選択します。
  10. オプション。Test settingsを選択します。
  11. 変更を保存を選択します。

irkerの受信者を入力します。

Default IRC URIフィールドを空欄にした場合は、 recipients に完全な URI を入力してください:irc[s]://irc.network.net[:port]/#channel 。デフォルトのIRC URIを入力した場合は、チャンネル名またはユーザー名だけを使用できます。

メッセージを送信するには

  • #chanirkerは、chan および#chanという形式のチャンネル名を受け付けます。
  • chan?key=hunter2パスワードで保護されたチャネルには、チャネル名にthesecretpassword の代わりに?key=thesecretpassword を付加し、チャネルパスワードを付加します。チャンネル名の前に#つけないでください。そうすると、irkerは#chan?key=password という名前のチャネルに参加しようとするので、/whois IRCコマンドを通して、チャネルのパスワードを漏らすことができます。これはirkerの長年のバグによるものです。
  • ユーザークエリでは、ユーザー名の後に,isnick を追加してください。たとえば、UserSmith,isnick