There are a couple of posts about setting up Percona XtraDB Cluster on Vagrant and Percona Server on MySQL Sandbox – those are two of the top tools used by the Percona Support team for testing and bug processing among other things.
In this post, however, I will show you how to use Docker with Percona Server on Ubuntu 12.04.
As per Docker’s official site:
Docker is an open-source engine that automates the deployment of any application as a lightweight, portable, self-sufficient container that will run virtually anywhere.
Docker containers can encapsulate any payload, and will run consistently on and between virtually any server. The same container that a developer builds and tests on a laptop will run at scale, in production*, on VMs, bare-metal servers, OpenStack clusters, public instances, or combinations of the above.
To install Docker on Ubuntu 12.04 you need to follow instructions from Docker’s official documentation:
http://docs.docker.io/installation/ubuntulinux/#ubuntu-precise-1204-lts-64-bit
After installing Docker, you may either download docker images via ‘docker pull’ and store docker images on your server so you can spin a new docker container in an instance or you may choose to do a ‘docker run’ on the terminal and implicitly download/store the specific docker image from index.docker.io and run the image afterward.
|
1 |
root@Perconallc-Support / # docker images | grep centos<br>centos centos6 0b443ba03958 2 weeks ago 297.6 MB<br>centos latest 0b443ba03958 2 weeks ago 297.6 MB<br>centos 6.4 539c0211cd76 13 months ago 300.6 MB<br> |
Let us create a CentOS docker container by running the following command:
|
1 |
root@Perconallc-Support / # docker run -i -t centos:latest bash<br>bash-4.1# cat /etc/redhat-release<br>CentOS release 6.5 (Final)<br> |
As you may have noticed, we have just created a new interactive (-i) CentOS 6.5 docker container and ran bash in a single line of command. Detaching from the container is as easy as typing CTRL+p – CTRL+q, you’ll get to your terminal if you typed the right keys.
Verify the active containers:
|
1 |
root@Perconallc-Support / # docker ps<br>CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES<br>202765d754b7 centos:centos6 bash 11 minutes ago Up 11 minutes elegant_rosalind<br> |
To list all existing containers active or not use the following command:
|
1 |
root@Perconallc-Support / # docker ps -a<br>CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES<br>202765d754b7 centos:centos6 bash 12 minutes ago Up 12 minutes elegant_rosalind<br>aae47d193a22 centos:6.4 bash 2 hours ago Exited (1) 2 hours ago boring_bardeen<br> |
To attach to the active docker container:
|
1 |
root@Perconallc-Support / # docker attach 202765d754b7<br><br>bash-4.1#<br> |
*Tip: Hit enter twice to get to the container’s bash prompt.*
Now that you have a working docker container you will then have to install the needed packages and repository.
|
1 |
bash-4.1# rpm -Uhv https://www.percona.com/downloads/percona-release/percona-release-0.0-1.x86_64.rpm<br>Retrieving https://www.percona.com/downloads/percona-release/percona-release-0.0-1.x86_64.rpm<br>Preparing... ########################################### [100%]<br> 1:percona-release ########################################### [100%]<br>bash-4.1# yum install Percona-Server-server-56 Percona-Server-client-56 Percona-Server-shared-56<br>Loaded plugins: fastestmirror<br>Loading mirror speeds from cached hostfile<br> * base: ftp.hosteurope.de<br> * extras: ftp.plusline.de<br> * updates: ftp.plusline.de<br>Setting up Install Process<br>Resolving Dependencies<br>--> Running transaction check<br>---> Package Percona-Server-client-56.x86_64 0:5.6.17-rel65.0.el6 will be installed<br>--> Processing Dependency: /usr/bin/perl for package: Percona-Server-client-56-5.6.17-rel65.0.el6.x86_64<br>---> Package Percona-Server-server-56.x86_64 0:5.6.17-rel65.0.el6 will be installed<br>--> Processing Dependency: libaio.so.1(LIBAIO_0.1)(64bit) for package: Percona-Server-server-56-5.6.17-rel65.0.el6.x86_64<br>--> Processing Dependency: libaio.so.1(LIBAIO_0.4)(64bit) for package: Percona-Server-server-56-5.6.17-rel65.0.el6.x86_64<br>--> Processing Dependency: libaio.so.1()(64bit) for package: Percona-Server-server-56-5.6.17-rel65.0.el6.x86_64<br>---> Package Percona-Server-shared-56.x86_64 0:5.6.17-rel65.0.el6 will be installed<br>--> Running transaction check<br>---> Package libaio.x86_64 0:0.3.107-10.el6 will be installed<br>---> Package perl.x86_64 4:5.10.1-136.el6 will be installed<br>--> Processing Dependency: perl-libs = 4:5.10.1-136.el6 for package: 4:perl-5.10.1-136.el6.x86_64<br>--> Processing Dependency: perl-libs for package: 4:perl-5.10.1-136.el6.x86_64<br>--> Processing Dependency: perl(version) for package: 4:perl-5.10.1-136.el6.x86_64<br>--> Processing Dependency: perl(Pod::Simple) for package: 4:perl-5.10.1-136.el6.x86_64<br>--> Processing Dependency: perl(Module::Pluggable) for package: 4:perl-5.10.1-136.el6.x86_64<br>--> Processing Dependency: libperl.so()(64bit) for package: 4:perl-5.10.1-136.el6.x86_64<br>--> Running transaction check<br>---> Package perl-Module-Pluggable.x86_64 1:3.90-136.el6 will be installed<br>---> Package perl-Pod-Simple.x86_64 1:3.13-136.el6 will be installed<br>--> Processing Dependency: perl(Pod::Escapes) >= 1.04 for package: 1:perl-Pod-Simple-3.13-136.el6.x86_64<br>---> Package perl-libs.x86_64 4:5.10.1-136.el6 will be installed<br>---> Package perl-version.x86_64 3:0.77-136.el6 will be installed<br>--> Running transaction check<br>---> Package perl-Pod-Escapes.x86_64 1:1.04-136.el6 will be installed<br>--> Finished Dependency Resolution<br><br>Dependencies Resolved<br><br>========================================================================================================================================================================<br> Package Arch Version Repository Size<br>========================================================================================================================================================================<br>Installing:<br> Percona-Server-client-56 x86_64 5.6.17-rel65.0.el6 percona 6.8 M<br> Percona-Server-server-56 x86_64 5.6.17-rel65.0.el6 percona 19 M<br> Percona-Server-shared-56 x86_64 5.6.17-rel65.0.el6 percona 714 k<br>Installing for dependencies:<br> libaio x86_64 0.3.107-10.el6 base 21 k<br> perl x86_64 4:5.10.1-136.el6 base 10 M<br> perl-Module-Pluggable x86_64 1:3.90-136.el6 base 40 k<br> perl-Pod-Escapes x86_64 1:1.04-136.el6 base 32 k<br> perl-Pod-Simple x86_64 1:3.13-136.el6 base 212 k<br> perl-libs x86_64 4:5.10.1-136.el6 base 578 k<br> perl-version x86_64 3:0.77-136.el6 base 51 k<br><br>Transaction Summary<br>========================================================================================================================================================================<br>Install 10 Package(s)<br><br>Total download size: 38 M<br>Installed size: 158 M<br>Is this ok [y/N]: y<br>Downloading Packages:<br>(1/10): Percona-Server-client-56-5.6.17-rel65.0.el6.x86_64.rpm | 6.8 MB 00:02<br>(2/10): Percona-Server-server-56-5.6.17-rel65.0.el6.x86_64.rpm | 19 MB 00:00<br>(3/10): Percona-Server-shared-56-5.6.17-rel65.0.el6.x86_64.rpm | 714 kB 00:00<br>(4/10): libaio-0.3.107-10.el6.x86_64.rpm | 21 kB 00:00<br>(5/10): perl-5.10.1-136.el6.x86_64.rpm | 10 MB 00:00<br>(6/10): perl-Module-Pluggable-3.90-136.el6.x86_64.rpm | 40 kB 00:00<br>(7/10): perl-Pod-Escapes-1.04-136.el6.x86_64.rpm | 32 kB 00:00<br>(8/10): perl-Pod-Simple-3.13-136.el6.x86_64.rpm | 212 kB 00:00<br>(9/10): perl-libs-5.10.1-136.el6.x86_64.rpm | 578 kB 00:00<br>(10/10): perl-version-0.77-136.el6.x86_64.rpm | 51 kB 00:00<br>------------------------------------------------------------------------------------------------------------------------------------------------------------------------<br>Total 7.4 MB/s | 38 MB 00:05<br>Running rpm_check_debug<br>Running Transaction Test<br>Transaction Test Succeeded<br>Running Transaction<br>Warning: RPMDB altered outside of yum.<br>** Found 2 pre-existing rpmdb problem(s), 'yum check' output follows:<br>udev-147-2.51.el6.x86_64 has missing requires of /sbin/service<br>udev-147-2.51.el6.x86_64 has missing requires of MAKEDEV >= ('0', '3.11', None)<br> Installing : Percona-Server-shared-56-5.6.17-rel65.0.el6.x86_64 1/10<br> Installing : 1:perl-Pod-Escapes-1.04-136.el6.x86_64 2/10<br> Installing : 1:perl-Module-Pluggable-3.90-136.el6.x86_64 3/10<br> Installing : 4:perl-libs-5.10.1-136.el6.x86_64 4/10<br> Installing : 3:perl-version-0.77-136.el6.x86_64 5/10<br> Installing : 1:perl-Pod-Simple-3.13-136.el6.x86_64 6/10<br> Installing : 4:perl-5.10.1-136.el6.x86_64 7/10<br> Installing : Percona-Server-client-56-5.6.17-rel65.0.el6.x86_64 8/10<br> Installing : libaio-0.3.107-10.el6.x86_64 9/10<br> Installing : Percona-Server-server-56-5.6.17-rel65.0.el6.x86_64 10/10<br><br>...<br><br>Installed:<br> Percona-Server-client-56.x86_64 0:5.6.17-rel65.0.el6 Percona-Server-server-56.x86_64 0:5.6.17-rel65.0.el6 Percona-Server-shared-56.x86_64 0:5.6.17-rel65.0.el6<br><br>Dependency Installed:<br> libaio.x86_64 0:0.3.107-10.el6 perl.x86_64 4:5.10.1-136.el6 perl-Module-Pluggable.x86_64 1:3.90-136.el6 perl-Pod-Escapes.x86_64 1:1.04-136.el6<br> perl-Pod-Simple.x86_64 1:3.13-136.el6 perl-libs.x86_64 4:5.10.1-136.el6 perl-version.x86_64 3:0.77-136.el6<br><br>Complete!<br>bash-4.1# /etc/init.d/mysql start<br>Starting MySQL (Percona Server). SUCCESS!<br>bash-4.1# mysql<br>Welcome to the MySQL monitor. Commands end with ; or g.<br>Your MySQL connection id is 1<br>Server version: 5.6.17-65.0-56 Percona Server (GPL), Release 65.0, Revision 587<br><br>Copyright (c) 2009-2014 Percona LLC and/or its affiliates<br>Copyright (c) 2000, 2014, Oracle and/or its affiliates. All rights reserved.<br><br>Oracle is a registered trademark of Oracle Corporation and/or its<br>affiliates. Other names may be trademarks of their respective<br>owners.<br><br>Type 'help;' or 'h' for help. Type 'c' to clear the current input statement.<br><br>mysql><br> |
There you have it, a freshly installed Percona Server 5.6.17 on CentOS 6.5 Linux container. Yay!
You can now create a new MySQL user to access the server outside the container:
|
1 |
mysql> grant all privileges on *.* to 'test_user'@'%' identified by 'test_pass';<br>Query OK, 0 rows affected (0.00 sec)<br><br>mysql> flush privileges;<br>Query OK, 0 rows affected (0.00 sec)<br><br>root@Perconallc-Support / # mysql -h 172.17.0.2 -utest_user -p<br>Enter password:<br>Welcome to the MySQL monitor. Commands end with ; or g.<br>Your MySQL connection id is 4<br>Server version: 5.6.17-65.0-56 Percona Server (GPL), Release 65.0, Revision 587<br><br>Copyright (c) 2009-2014 Percona LLC and/or its affiliates<br>Copyright (c) 2000, 2014, Oracle and/or its affiliates. All rights reserved.<br><br>Oracle is a registered trademark of Oracle Corporation and/or its<br>affiliates. Other names may be trademarks of their respective<br>owners.<br><br>Type 'help;' or 'h' for help. Type 'c' to clear the current input statement.<br><br>mysql><br> |
We’re basically following installation instructions for Percona Server from the documentation.
Just the same way as you would do on any server, you can install other equally important Percona software on the same container to complete your docker environment.
As an added bonus, you can contribute to the Docker Community by commiting your container and pushing it to the docker registry.
I’ve shown you how easy it is to spin a docker container and install Percona Server 5.6 in it. This is by far one of the fastest ways to create test/staging environments to simulate production servers. For further reading you may want to read Docker’s official documentation here.
I hope that this has piqued your interest to try it out yourself. And if that happens we would love to know how Percona Server and other Percona software perform on your docker environment. Cheers!
Resources
RELATED POSTS
