https://github.com/gavincarr/hosttag_rb

Hosttag is a client for tagging hostnames into classes, storing the mappings in a redis datastore.
https://github.com/gavincarr/hosttag_rb

Last synced: 28 days ago
JSON representation

Hosttag is a client for tagging hostnames into classes, storing the mappings in a redis datastore.

• Host: GitHub
• URL: https://github.com/gavincarr/hosttag_rb
• Owner: gavincarr
• License: gpl-3.0
• Created: 2011-02-03T19:02:16.000Z (almost 14 years ago)
• Default Branch: master
• Last Pushed: 2012-06-28T03:45:38.000Z (over 12 years ago)
• Last Synced: 2024-10-18T11:30:54.672Z (about 1 month ago)
• Language: Ruby
• Homepage:
• Size: 285 KB
• Stars: 3
• Watchers: 2
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README
  • Changelog: ChangeLog

Awesome Lists containing this project

README

        
Introduction

------------

Hosttag is a client for tagging hostnames into groups or classes, storing 

the mappings in a redis datastore. It requires the 'redis' rubygem.

Hosttag assumes your redis server is found on a server called 'hosttag' on

the default redis port (6379). You can either setup 'hosttag' as a hostname

alias in a local hosts file, or specify an alternative host to use in a

HOSTTAG_SERVER environment variable, or explicitly via a -s/--server

 argument. Similarly, an alternate port can be specified using a

HOSTTAG_PORT environment variable, or a -p/--port  command line

argument.

Basic Usage

-----------

  # Set some tags (-T says assume anything you don't know is a tag)

  $ htset -T zeus dell centos centos5 server

  $ htset -T minerva dell centos centos6 laptop

  $ htset -T hermes hp ubuntu lucid desktop

  $ htset -T athena hp ubuntu maverick server

  # Queries

  $ ht dell               

  minerva zeus

  $ ht ubuntu

  hermes athena

  $ ht -o hp dell         # -o/--or ORs arguments

  hermes minerva zeus

  $ ht -a ubuntu server   # -a/--and ANDs arguments

  athena

  $ ht -o de*             # tags and hosts may include globs (*, ?, [M-N])

  zeus minerva hermes

  $ ht -A                 # all hosts

  athena hermes minerva zeus

  $ ht -T                 # all tags

  centos centos5 centos6 dell desktop hp laptop lucid maverick server

Security

--------

A warning on security: basically, there isn't any. Anyone who can get write

to your redis server can write, rewrite, and delete all your hosttags. So

you should only use hosttag on a trusted network.

Redis supports a password-ed mode, and it might make sense to use that via

a config file or something, so you could at least restrict usage via file

permissions (although traffic would still be in the clear, I believe). For

now, though, there's no security.

Installation

------------

To install from source, unpack the tarball and run 'rake install' (requires

rubygems and rake). You can set GEM_HOME to an alternate install directory 

(e.g. ~/.gem) if you want to install somewhere other than your gem default.

RPMs are available for CentOS/RHEL {5,6} from the Open Fusion repository:

  http://www.openfusion.net/linux/openfusion_rpm_repository

Author

------

Gavin Carr , http://www.openfusion.net/

Copyright 2010-2011 Gavin Carr.

Licence

-------

This software is free software, licensed under the GNU Public License v3

or any later version.