rmacklin / anycable_demo

Anycable demo application

AnyCable Demo

Sample application demonstrating AnyCable concept.

AnyCable allows you to use any WebSocket server (written in any language) as a replacement for built-in Ruby Action Cable server.

With AnyCable you can use channels, client-side JS, broadcasting - (almost) all that you can do with Action Cable. You can even use Action Cable in development and not be afraid of compatibility issues.

Requirements

• Ruby ~> 2.4
• PostgreSQL >= 9.4
• Redis
• anycable-go
• hivemind (optional)
• Headless Chrome + Chrome Driver (for tests only)

Usage with Docker

You can use Docker to run the application with AnyCable server (Go version).

Run docker-compose up web and you'll be able to access the application on http://localhost:3000.

Usage without Docker

To launch AnyCable version:

# Run dev servers
hivemind Procfile.dev

# Run specs
make test

This runs 3 processes:

• Rails Web app
• Rails RPC server (GRPC)
• Go Websockets server

To launch AnyCable version with ErlyCable you should set ERLYCABLE_DIR env variable first (or provide when running commands) pointing to ErlyCable repo path (i.e. /my/path/to/erlycable).

ErlyCable also requires Erlang >=18.0 and rebar3.

# Run dev server
hivemind Procfile.erly

# Run specs
make test-erl

This runs 3 processes:

• Rails Web app
• Rails RPC server (GRPC)
• ErlyCable server (as rebar3 shell)

To launch plain Rails version:

# Run dev server
bundle exec rails server

# Run specs
bundle exec rspec