redis / redis-io

Application running http://redis.io

redis-io

This repository holds the source code for the website that runs redis.io.

Getting started

The required gems are listed in the .gems file. To get up and running, preferably using a gemset, run:

gem install dep
dep install

Now you need to clone the redis-doc project, and set its path in the REDIS_DOC environment variable before starting the server or running the tests.

Finally, you need to have a redis-server running on port 6379.

To start the website:

REDIS_DOC=/path/to/redis-doc rackup

To run the tests, you also need to install cutest and capybara:

gem install cutest capybara

Now, just run:

REDIS_DOC=/path/to/redis-doc rake

Or to run the tests in a particular file:

REDIS_DOC=/path/to/redis-doc cutest test/some_file.rb

redis-io's Issues

Grammar fix on homepage

I've raised redis/redis-doc#775 to fix a grammar issue on the homepage. Cross-referencing here.

EVAL sandbox

Add some kind of scripting sandbox. Use a separate Redis process per session. Put every process in its own control group to minimize risk of memory bloat. The process can be killed when it becomes unresponsive (when a script is running too long).

This could be combined with some kind of library with scripting examples.

Links:

• http://ace.ajax.org/

Pages fail to respond on Heroku

On the live deploy... I get errors on these pages:

http://redis.io/topics/pipelining
http://redis.io/topics/memory-optimization

Screenshot:
http://cl.ly/25052H19093q2x3X0B1n

Redis requires Password suddenly.

Redis Version = 2.8.17

Redis was already more than 3 months in use, and installed via chef cookbook (default chef supermarket cookbook).

since last week i started to get the following error on all my environments:
Uncaught exception 'Redis​Exception' with message 'Failed to AUTH connection' in /​var/​www/​shared/​t​3​sources/​typo​3_​src-​6.​2.​15/​typo​3/​sysext/​core/​Classes/​Cache/​Backend/​Redis​Backend.​php:​152

The Problem was reappearing after few hours all over again.

My Redis Configuration file has no requirepass:

################################## SECURITY ###################################

# Require clients to issue AUTH <PASSWORD> before processing any other
# commands.  This might be useful in environments in which you do not trust
# others with access to the host running redis-server.
#
# This should stay commented out for backward compatibility and because most
# people do not need auth (e.g. they run their own servers).
#
# Warning: since Redis is pretty fast an outside user can try up to
# 150k passwords per second against a good box. This means that you should
# use a very strong password otherwise it will be very easy to break.
#
# requirepass foobared

What should i do? ​

make test error

Ubuntu 16.04 - fresh install, only ssh and build-essentials (with tcl obviously) running in virtual box with 768 MB RAM and 1 Core.

[err]: With min-slaves-to-write: master not writable with lagged slave in te sts/integration/replication-4.tcl

!!! WARNING The following tests failed:

*** [err]: With min-slaves-to-write: master not writable with lagged slave in te sts/integration/replication-4.tcl
Expected 'NOREPLICAS_' to equal or match 'OK'
Cleanup: may take some time... OK
Makefile:215: recipe for target 'test' failed
make[1]: *_* [test] Error 1
make[1]: Leaving directory '/home/synovia/redis-3.2.0/src'
Makefile:6: recipe for target 'test' failed
make: *** [test] Error 2

Minor typo on http://redis.io/topics/introduction

A link in the section starting with "Other features include" says "Pub/Bub" instead of "Pub/Sub".

special chars error on tutorial

On the tutorial at http://try.redis-db.com/
Special chars like ç, ã, á, etc don't appear.

SET a "visão" => true
GET a
does not returns anything

Its the same using sets or lists. The insert operation works. The length is returned OK but when listing the contents using LRANGE or SMEMBERS, nothing is returned.

error style

when i run this server, and start up, then i get the fallowing error, how to solve it ? thank you

Sass::SyntaxError: Illegal nesting: Nothing may be nested beneath mixin directives.
views/styles.sass:62
/usr/local/rvm/gems/ruby-2.1.2/gems/haml-3.1.4/vendor/sass/lib/sass/engine.rb:811:in parse_mixin_include' /usr/local/rvm/gems/ruby-2.1.2/gems/haml-3.1.4/vendor/sass/lib/sass/engine.rb:640:inparse_directive'
/usr/local/rvm/gems/ruby-2.1.2/gems/haml-3.1.4/vendor/sass/lib/sass/engine.rb:551:in parse_line' /usr/local/rvm/gems/ruby-2.1.2/gems/haml-3.1.4/vendor/sass/lib/sass/engine.rb:456:inbuild_tree'
/usr/local/rvm/gems/ruby-2.1.2/gems/haml-3.1.4/vendor/sass/lib/sass/engine.rb:475:in block in append_children' /usr/local/rvm/gems/ruby-2.1.2/gems/haml-3.1.4/vendor/sass/lib/sass/engine.rb:474:ineach'
/usr/local/rvm/gems/ruby-2.1.2/gems/haml-3.1.4/vendor/sass/lib/sass/engine.rb:474:in append_children' /usr/local/rvm/gems/ruby-2.1.2/gems/haml-3.1.4/vendor/sass/lib/sass/engine.rb:330:in_to_tree'
/usr/local/rvm/gems/ruby-2.1.2/gems/haml-3.1.4/vendor/sass/lib/sass/engine.rb:300:in _render' /usr/local/rvm/gems/ruby-2.1.2/gems/haml-3.1.4/vendor/sass/lib/sass/engine.rb:247:inrender'
/usr/local/rvm/gems/ruby-2.1.2/gems/tilt-1.4.1/lib/tilt/css.rb:24:in evaluate' /usr/local/rvm/gems/ruby-2.1.2/gems/tilt-1.4.1/lib/tilt/template.rb:103:inrender'
/usr/local/rvm/gems/ruby-2.1.2/gems/cuba-2.2.1/lib/cuba.rb:115:in render' /home/winkt/code/redisProject/redis-io-master/app.rb:108:inrender'
/home/winkt/code/redisProject/redis-io-master/app.rb:253:in block (2 levels) in <top (required)>' /usr/local/rvm/gems/ruby-2.1.2/gems/cuba-2.2.1/lib/cuba.rb:158:inblock in on'

Autocomplete demo broken

The autocomplete demo mentioned on http://redis.io/documentation and living on http://autocomplete.redis.io/ is broken. The AJAX request response is the following PHP error:

Warning: fsockopen() [function.fsockopen]: unable to connect to 127.0.0.1:10001 (Connection refused) in /var/virtual/autocomplete.redis.io/httpdocs/redis.php on line 29

Fatal error: Cannot open socket to 127.0.0.1:10001, error 111. in /var/virtual/autocomplete.redis.io/httpdocs/redis.php on line 37

This issue was already mentionned a few months ago on https://gist.github.com/antirez/11126283. We should consider fixing the problem, or removing the demo altogether.

redis.io/clients is blank

curl redis.io/clients returns empty

Project lacking explicit licensing

Hi there!

I notice when I reached this GitHub page that there's no explicit LICENSE or COPYING file in the root of the project. Also, on the README, there is no explicit licensing information.

I managed to find a few places where redis was listed as "open source" (here), and on this page it says that everything Redis is governed under three clause BSD -- which is great! But in this repo all I could spot regarding that was buried at the bottom of this file.

Not too big a deal, but just a thought that could shave a few minutes of searching for others like myself who were looking to use the site or its code samples in their projects.

Thanks!

extra margin on Developer Day callout

At desktop resolutions, there is a weird margin on the callout about Redis Developer Day.

I'm not able to build the entire site, but I think the problem lies in the style for aside in topics.sass. It seems like this style should only apply to aside elements in site-content. I'm guessing that changing the selector on line 73 from aside to .site-content aside will resolve the problem.

Small command box issue on Chrome 27

When using Chrome 27 and accessing a site like http://redis.io/commands#set you can see the top of hidden boxes from other commands.

http://i.imgur.com/FWyCll4.png

It's not a big deal, but still wanted to mention it ;)

Wrong command reference in http://redis.io/topics/data-types-intro

"When MSET is used, Redis returns an array of values."

Shoudn't it be MGET instead of MSET command ?

Keep the commands bar when viewing a command

So when you are on the commands page: http://redis.io/commands

You have a nice helpful bar at the top listing each category of commands: All Keys Strings Hashes etc.

As soon as you select an individual command though this bar goes away.

It would be really nice if this command category bar remained when looking at specific individual commands.

Autolinking can be too zealous

In some cases autolinking can behave too fanatically. For example, eval.md discusses the KEYS array and autolink links it to the command.

@badboy had suggested prefixing with a ! hence redis/redis-doc#562 which currently fails.

Redis 3.0 for Windows?

When we will get stable Redis 3.0 for Windows OS?

Some of Redis' longer commands are cropped in the side article

I feel like a 🚽 because I'm opening an issue without suggesting a fix:

Command reference > EVALSHA -- wrong description

This is copy-paste from EVAL command, should be more descriptive to show differences from EVAL.

Feature: Topics index page

There are a lot of great topics under redis.io/topics/. But unfortunately, many of them are not linked to on the site.

I think we should set up the URL http://redis.io/topics as an index page of topics to make them a bit easier to find.

BITOP example broken

Here is what I see here

NoMethodError: undefined method `path' for Cuba::Ron

Where is the 'path' method defined?

https://gist.github.com/1114606

Fixes for http://redis.io/topics/data-types-intro

I read http://redis.io/topics/data-types-intro last night, and found it very helpful as I tried to understand aspects of Redis. As I read, I also noticed some grammatical errors and typos that I'd like to fix and contribute back. I haven't been able to find the source for this page, other than the raw HTML source. Can you advise me on which version I should submit fixes against (i.e., do you have it in git somehwere)? Thanks.

HEAD request to http://redis.io returns 404 Not Found

With a GET request redis.io returns 200 as expected.

> curl -X GET -vso /dev/null http://redis.io/
*   Trying 109.74.203.151...
* Connected to redis.io (109.74.203.151) port 80 (#0)
> GET / HTTP/1.1
> Host: redis.io
> User-Agent: curl/7.43.0
> Accept: */*
> 
< HTTP/1.1 200 OK
...(rest of response as expected)

However with a HEAD request it returns 404:

> curl -X HEAD -vso /dev/null http://redis.io/
*   Trying 109.74.203.151...
* Connected to redis.io (109.74.203.151) port 80 (#0)
> HEAD / HTTP/1.1
> Host: redis.io
> User-Agent: curl/7.43.0
> Accept: */*
> 
< HTTP/1.1 404 Not Found
< Date: Sat, 17 Sep 2016 20:42:50 GMT
< Status: 404 Not Found
< Content-Type: text/html
< Via: 1.1 redis.io
< Vary: Accept-Encoding
* no chunk, no close, no size. Assume close to signal end
< 

This might seem irrelevant but it's causing sphinx's linkcheck to return WARNING: broken link: http://redis.io/.

Add ids to section headers

I often need to link people to sections of documentation (Example: Quorum at http://redis.io/topics/sentinel), but the Redis site doesn't expose ID tags on headers, so we can't do http://redis.io/topics/sentinel#quorum.

Proposal: fix it so all headers have their name (or _name) as the id attribute of the <h2>, etc.

http://redis.io/ down - 500 Internal Server Error

The http://redis.io/ website is returning 500 error for all pages.

Encoding::CompatibilityError at /commands/DUMP

https://redis.io/commands/DUMP

Encoding::CompatibilityError at /commands/DUMP
incompatible character encodings: ASCII-8BIT and UTF-8

Ruby /srv/redis-io/.gs/gems/haml-3.1.4/lib/haml/buffer.rb: in push_text, line 118
Web GET 127.0.0.1/commands/DUM

Interactive tutorial on redis.io not working.

The interactive tutorial link (http://try.redis-db.com/) under “Try it” on redis.io is not working. As far as I can tell, it hasn’t worked for at least a week.

spelling error in http://redis.io/topics/partitioning

As the following shows:

Partitioning when using Redis ad(should be "as" ?) a data store or cache is conceptually the same, however there is a huge difference.

Related Comments aren't all clickable

While at http://redis.io/commands/sadd I am able to click some of the related commands, but not all. In the image below you can see "SDIFF" is clickable, but "SDIFFSTORE" is not.

git push -u origin master

when i try to run

git push -u origin master

Received the following errors in my centos gitlab installed machine.....
/usr/local/lib/ruby/2.1.0/uri/common.rb:176:in `split': bad URI(is not URI?): 192.168.5.13:8080/api/v3/internal/allowed (URI::InvalidURIError)

from /usr/local/lib/ruby/2.1.0/uri/common.rb:211:in parse' from /usr/local/lib/ruby/2.1.0/uri/common.rb:747:inparse'
from /home/git/gitlab-shell/lib/gitlab_net.rb:93:in post' from /home/git/gitlab-shell/lib/gitlab_net.rb:27:inallowed?'
from /home/git/gitlab-shell/lib/gitlab_shell.rb:64:in validate_access' from /home/git/gitlab-shell/lib/gitlab_shell.rb:25:inexec'
from /home/git/gitlab-shell/bin/gitlab-shell:16:in `

'
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

TOUCH example shows error

The Examples section for TOUCH shows the following error: "ERR Unknown or disabled command 'TOUCH'". The same example also fails on http://try.redis.io

Is this because the redis version in the site backend is not updated?

Contact account for phpredis

Hello,

Congrats on the new website!

Could you please change the twitter account for phpredis? You're linking to the account of the original author, who has lost interest in the project before it was taken over and put on github more than a year ago.
I am in charge of the project now and use my personal account @yowgi to handle requests.

Thanks,

Nicolas

HTML anchors on pages?

Hi I was trying to link to a specific part of the redis.io website, specifically in http://redis.io/topics/cluster-tutorial I noticed that there aren't any anchors on the page. Is this something that can be implemented?

Keyspace Notifications SET documentation mildly confusing

On URL http://redis.io/topics/notifications

Under "Configuration" we see the list of notify-keyspace-events values, such as "s" for "Set Commands" and so on.

Further down it says "SET and all its variants [...] generate set events." But of course to see these events happen you need to have "$" String commands enabled, and not "s" Set commands. The confusion comes from using SET as a verb in this case, vs. set as a noun previously. Once you see it, it's obvious.

fresh gems cause deprecation notices

Installing fresh gems for redis-io with cat .gems | xargs gem install installs new compass, haml and sass which print some deprecation notices. When the server side gems get updated, and the deprecations are definitively deprecated, things will break. Is it time for bundler?

/cc @djanowski @soveran

No md5 checksum for downloads(or some other checksum)

can redis.io add a md5 checksum for downloads?
e.g.

> md5sum redis-3.0.3.tar.gz
76725490d6168cfb4b0ce014b89d4b54  redis-3.0.3.tar.gz

front page typo in intro paragraph

Looks to me there is a front page typo:

It supports data strucures -> It supports data structures

Feature request - nav improvment

Hi ... just a thought

When I am on http://redis.io/commands/sadd or other command pages can we have the menu that is on http://redis.io/commands

All Keys Strings Hashes Lists Sets Sorted Sets Pub/Sub Transactions Scripting Connection Server

It would be awesome for nav :)

Is this the code?

%nav
%a(href="#") All

- Reference::GROUPS.each do |name, description|
  %a(href="##{name}")= description

Thanks

Chris

Redis quickstart update

I just went through the quick start. REDIS_PORT is now REDISPORT.

Add a cache manifest

It would be nice to have a cache manifest for redis.io. This way the docs could be viewed offline. I know the docs can be downloaded manually but it would be convenient to just type redis.io in your browser.

This also has the advantage of speeding up page loads and reducing server load.

I'm not sure exactly what should be downloaded on visit but I think it should be at least the command reference and possibly cache articles when visited.

It's hard to find the redis git repository

I tried the front page, "Download", "Documentation", "Support" and even "License" links, and finally found it under "Community". Could you place the repository link to a place more related to code (e.g. the download page, where many open source software sites put their repository link on when they don't have a "Developer" page).

Redis services loses connection every day in same time

We use a Redis (version 2.8) with Windows in our production servers. And have next "master-slave" configuration:

• 3 services in separate servers (1 master and 2 slaves)
• 3 sentinels in each server

Until we do not have a lot of loading and big size of data, and replication works as we need. BUT every day we have strange behaviour. In Redis-service log we see:

IPs of our servers:
---.--.--.1
---.--.--.2
---.--.--.3

[3576] 30 Nov 00:15:07.271 # Connection with slave ---.--.-.2:6379 lost.
[3576] 30 Nov 00:15:07.282 # Connection with slave ---.--.-.3:6379 lost. 
[3576] 30 Nov 00:15:18.242 * SLAVE OF ---.--.-.3:6379 enabled (user request)
[3576] 30 Nov 00:15:18.245 # CONFIG REWRITE executed with success.
[3576] 30 Nov 00:15:18.801 * Connecting to MASTER ---.--.-.3:6379
[3576] 30 Nov 00:15:18.801 * MASTER <-> SLAVE sync started
[3576] 30 Nov 00:15:18.802 * Non blocking connect for SYNC fired the event.
[3576] 30 Nov 00:15:18.802 * Master replied to PING, replication can continue...
[3576] 30 Nov 00:15:18.803 * Partial resynchronization not possible (no cached master)  
[3576] 30 Nov 00:15:18.805 * Full resync from master: 2010f343b5b051924fb4826f826979f9683a73a9:24474754143
[3576] 30 Nov 00:15:20.772 * MASTER <-> SLAVE sync: receiving 66333159 bytes from master
[3576] 30 Nov 00:15:21.648 * MASTER <-> SLAVE sync: Flushing old data
[3576] 30 Nov 00:15:22.085 * MASTER <-> SLAVE sync: Loading DB in memory
[3576] 30 Nov 00:15:23.005 * MASTER <-> SLAVE sync: Finished with success

In two other servers logging same. But instead

[3576] 30 Nov 00:15:07.271 # Connection with slave ---.--.-.2:6379 lost.

logged

[6176] 30 Nov 00:15:12.451 # Connection with master lost.**strong text**

In sentinel logs next:

[6988] 30 Nov 00:06:25.031 # -sdown slave ---.--.-.3:6379 ---.--.-.3 6379 @ master ---.--.-.1 6379 
[6988] 30 Nov 00:06:25.031 # -sdown sentinel ---.--.-.3:10001 ---.--.-.3 10001 @ master ---.--.-.1 6379

This occurs ONLY 1 time per day in begin of day, but not in certain fixed time (can start in 00:12:00 / 00:15:00/ 00:17:00 etc.) Regarding redis-sentinel configuration we have just this

port 10001
logfile "C:\\REDIS\\logs\\redis_sentinel.log"
sentinel monitor master ---.--.-.1 6379 2
sentinel down-after-milliseconds master 4000
sentinel failover-timeout master 30000

In redis-servers configuration actually we use default configuration almost (Just changed "maxheap" and "maxmemory").

I had found that possibly cases of this can be not enough replication timeout (repl-timeout = 60 sec by default) and client buffer limit ("client-output-buffer-limit"). But it is not our cases because we have very quickly replication (about 1 sec) and until small size of data. Also we have checked physical connection to our servers(ports) in time of this issue -> Connection is always good...

So who have any ideas about this regular lost connection and start failover process without reason??

typo in the srandmember command page

hi,i just read the command srandmember, and find typo in the srandmember command page.The word bucked should be bucket, which occurs in the sentence Once a non empty bucket is found, since we use chaining in our hash table implementation, the number of elements inside the bucked is checked and a random element is selected.

Perl Redis::Client

There is another Redis client in Perl.
Website: http://search.cpan.org/dist/Redis-Client/
Repository: https://github.com/friedo/perl-redis-client

http://redis.io/ is returning 500s.

redis.io/topics/config out of date

Changing Redis configuration while the server is running

Note that modifying the configuration on the fly has no effects on the redis.conf file so at the next restart of Redis the old configuration will be used instead.

Make sure to also modify the redis.conf file accordingly to the configuration you set using CONFIG SET. There are plans to provide a CONFIG REWRITE command that will be able to run the redis.conf file rewriting the configuration accordingly to the current server configuration, without modifying the comments and the structure of the current file.

This section is out of date, CONFIG REWRITE has been introduced in version 2.8.

redis-stable still pointing to 3.0.1

Today read over the release notes and saw that Redis 3.0.3 was released with a critical security update about a week ago. I went ahead and re-downloaded redis-stable (http://download.redis.io/redis-stable.tar.gz) and I see it is still pointing at 3.0.1.

Looking at this line here, it appears that the STABLE_VERSION variable is pulled from a Redis database running on the web server. I suggest doing whatever is necessary to get this to point at 3.0.3.

Suggestion: Split Patterns from Commands

The patterns on redis.io are a great source of inspiration in my opinion. I think they should get more visibility as they are currently hidden in the Commands documentation. I suggest to introduce a new link in the top navigation called patterns, listening all of them. In the commands that now have the commands embedded, I would add a link to the according pattern. The Patterns in the documentation are:

• Time series
• Real-time metrics using bitmaps (with more information here).
• Reliable queues and another one here. Referenced here.
• Event notification
• Circular List. Referenced here.
• Counter
• Rate Limiter, Rate Limiter 1 and Rate Limiter 2
• A discouraged distributed lock pattern and another discouraged one. The encouraged pattern is available here.

There might also be other candidates in the documentation pages.

I'm more than happy to work on this. Just wanted to know beforehand, if this is ok.

Menu hides on small screens

Menu hides if screen is ~ less than 700 - 800px wide.