[
{
"path": ".gitmodules",
"content": ""
},
{
"path": "CNAME",
"content": "training.56kcloud.io"
},
{
"path": "Cloud/README.md",
"content": ""
},
{
"path": "DevOps/README.md",
"content": ""
},
{
"path": "DevOpsDays/readme.md",
"content": "## DevOpsDays Docker Training\n\n\n\nWelcome to [56K.Cloud](https://www.56k.cloud) Docker Introduction Training.\n\nThis Docker tutorial consists of the following sections:\n\n* [Docker Getting Started with Containers](https://training.play-with-docker.com/ops-s1-hello/)\n* [Docker Images](https://training.play-with-docker.com/ops-s1-images/)\n* [Docker Networking](https://training.play-with-docker.com/docker-networking-hol/)\n* [Docker Swarm](https://training.play-with-docker.com/ops-s1-swarm-intro/)\n"
},
{
"path": "Docker/12factor/00_application.md",
"content": "# Build the application\n\nTo illustrate the 12 factors, we start by creating a simple Node.js application as a HTTP Rest API exposing CRUD verbs on a *message* model.\n\nThere is a couple of prerequisite to build this application\n* [Node.js 4.4.5 (LTS)](https://nodejs.org/en/)\n* [mongo 3.2](https://docs.mongodb.org/manual/installation/)\n\n## Routes exposed\n\nHTTP verb | URI | Action\n----------| --- | ------\nGET | /message | list all messages\nGET | /message/ID | get message with ID\nPOST | /message | create a new message\nPUT | /message/ID | modify message with ID\nDELETE | /message/ID | delete message with ID\n\n## Setup\n\n* Install Sails.js (it's to Node.js what RoR is to Ruby): `sudo npm install sails -g`\n* Create the application: `sails new messageApp && cd messageApp`\n* Launch the application: `sails lift`\n\n## First tests\n\nCreate new messages\n\n```\ncurl -XPOST http://localhost:1337/message?text=hello\ncurl -XPOST http://localhost:1337/message?text=hola\n```\n\nGet list of messages\n\n```\ncurl http://localhost:1337/message\n\n[\n {\n \"text\": \"hello\",\n \"createdAt\": \"2015-11-08T13:15:15.363Z\",\n \"updatedAt\": \"2015-11-08T13:15:15.363Z\",\n \"id\": \"5638b363c5cd0825511690bd\"\n },\n {\n \"text\": \"hola\",\n \"createdAt\": \"2015-11-08T13:15:45.774Z\",\n \"updatedAt\": \"2015-11-08T13:15:45.774Z\",\n \"id\": \"5638b381c5cd0825511690be\"\n }\n]\n```\n\nModify a message\n\n```\ncurl -XPUT http://localhost:1337/message/5638b363c5cd0825511690bd?text=hey\n```\n\nDelete a message\n\n ```\n curl -XDELETE http://localhost:1337/message/5638b381c5cd0825511690be\n ```\n\nGet updates list of messages\n\n```\ncurl http://localhost:1337/message\n\n[\n {\n \"text\": \"hey\",\n \"createdAt\": \"2015-11-08T13:15:15.363Z\",\n \"updatedAt\": \"2015-11-08T13:19:40.179Z\",\n \"id\": \"5638b363c5cd0825511690bd\"\n }\n]\n```\n\n[Next](01_codebase.md)\n"
},
{
"path": "Docker/12factor/01_codebase.md",
"content": "# 1 - Codebase\n\n**one application <=> one codebase**\n\nIf there are several codebase, it's not an application, it's a distributed system containing multiple applications.\n\nOne codebase used for several deployments of the application\n* development\n* staging\n* production\n\n## What does that mean for our application ?\n\nWe will use Git versioning system (could have chosen subversion, ...) to handle our source code.\n\n* Create a repo on [Github](https://github.com)\n* Put the code under git\n\n```\n$ echo \"# messageApp\" >> README.md\n$ git init\n$ git add .\n$ git commit -m 'First commit'\n$ git remote add origin git@github.com:GITUSER/messageApp.git\n$ git push origin master\n```\n\nThe update we've done is not linked with Docker, but we'll see in a next chapter that this will greatly help the integration of several components of the Docker ecosystem.\n\n[Previous](00_application.md) - [Next](02_dependencies.md)\n"
},
{
"path": "Docker/12factor/02_dependencies.md",
"content": "# 2 - Dependencies\n\nApplication's dependencies must be declared and isolated\n\n## What does that mean for our application ?\n\nDeclaration are done in package.json file.\n\nLet's add sails-mongo (mongodb driver) as we'll need it very quicky\n\n`npm install sails-mongo --save`\n\nThe package.json file should look like the following:\n\n```\n{\n \"name\": \"messageApp\",\n \"private\": true,\n \"version\": \"0.0.0\",\n \"description\": \"a Sails application\",\n \"keywords\": [],\n \"dependencies\": {\n \"ejs\": \"2.3.4\",\n \"grunt\": \"0.4.5\",\n \"grunt-contrib-clean\": \"0.6.0\",\n \"grunt-contrib-coffee\": \"0.13.0\",\n \"grunt-contrib-concat\": \"0.5.1\",\n \"grunt-contrib-copy\": \"0.5.0\",\n \"grunt-contrib-cssmin\": \"0.9.0\",\n \"grunt-contrib-jst\": \"0.6.0\",\n \"grunt-contrib-less\": \"1.1.0\",\n \"grunt-contrib-uglify\": \"0.7.0\",\n \"grunt-contrib-watch\": \"0.5.3\",\n \"grunt-sails-linker\": \"~0.10.1\",\n \"grunt-sync\": \"0.2.4\",\n \"include-all\": \"~0.1.6\",\n \"rc\": \"1.0.1\",\n \"sails\": \"~0.12.3\",\n \"sails-disk\": \"~0.10.9\",\n \"sails-mongo\": \"^0.12.0\" // Newly added dependency\n },\n \"scripts\": {\n \"debug\": \"node debug app.js\",\n \"start\": \"node app.js\"\n },\n \"main\": \"app.js\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git://github.com/GITUSER/messageApp.git\"\n },\n \"author\": \"AUTHOR\",\n \"license\": \"\"\n}\n```\n\nDependencies are isolated within _node-modules_ folder where all the [npm](https://npmjs.org) libraries are compiled and installed.\n\n```\n$ ls node_modules/\nejs grunt-contrib-coffee grunt-contrib-cssmin grunt-contrib-uglify grunt-sync sails\ngrunt grunt-contrib-concat grunt-contrib-jst grunt-contrib-watch include-all sails-disk\ngrunt-contrib-clean grunt-contrib-copy grunt-contrib-less grunt-sails-linker rc sails-mongo\n```\n\n[Previous](01_codebase.md) - [Next](03_configuration.md)\n"
},
{
"path": "Docker/12factor/03_configuration.md",
"content": "# 3 - Configuration\n\nConfiguration (credentials, database connection string, ...) should be stored in the environment.\n\n## What does that mean for our application ?\n\nIn _config/connections.js_, we define the _mongo_ connection and use MONGO_URL environment variable to pass the mongo connection string.\n\n```node\nmodule.exports.connections = {\n mongo: {\n adapter: 'sails-mongo',\n url: process.env.MONGO_URL\n }\n};\n```\n\nIn _config/model.js_, we make sure the _mongo_ connection defined above is the one used.\n\n```node\nmodule.exports.models = {\n connection: 'mongo',\n migrate: 'safe'\n};\n```\n\nThose changes enable to provide a different _MONGO_URL_ very easily as it's defined in the environment.\n\n[Previous](02_dependencies.md) - [Next ](04_external_services.md)\n"
},
{
"path": "Docker/12factor/04_external_services.md",
"content": "# 4 - External services\n\nHandle external services as external resources of the application.\n\nExamples:\n* database\n* log services\n* ...\n\nThis ensure the application is loosely coupled with the services so it can easily switch provider or instance if needed\n\n## What does that mean for our application ?\n\nAt this point, the only external service the application is using is MongoDB database. The loose coupling is already done by the MONGO_URL used to pass the connection string.\n\nIf something wrong happens with our instance of MongoDB (assuming a single instance is used, which is generally a bad idea...), we can easily switch to a new instance, providing a new MONGO_URL environment variable and restarting the application.\n\n[Previous](03_configuration.md) - [Next](05_build_release_run.md)\n"
},
{
"path": "Docker/12factor/05_build_release_run.md",
"content": "# 5 - Build / Release / Run\n\nBuild / Release and Run phases must be kept separated\n\n\n\nA release is deployed on the execution environment and must be immutable.\n\n## What does that mean for our application ?\n\nWe'll use Docker in the whole development pipeline. We will start by adding a Dockerfile that will help define the build phase (during which the dependencies are compiled in _node-modules_ folder)\n\n```\nFROM node:4.4.5\nENV LAST_UPDATED 20160617T185400\n\n# Copy source code\nCOPY . /app\n\n# Change working directory\nWORKDIR /app\n\n# Install dependencies\nRUN npm install\n\n# Expose API port to the outside\nENV PORT 80\nEXPOSE 80\n\n# Launch application\nCMD [\"npm\",\"start\"]\n```\n\nLet's build our application `$ docker build -t message-app:v0.1 .`\n\nAnd verify the resulting image is in the list of available images\n\n```\n$ docker images\nREPOSITORY TAG IMAGE ID CREATED SIZE\nmessage-app v0.1 f35464cf4b0b 2 seconds ago 769 MB\n```\n\nNow the image (build) is available, execution environment must be injected to create a release.\n\nThere are several options to inject the configuration in the build, among them\n* create a new image based on the build\n* define a Compose file\n\nWe'll go for the second option and define a docker-compose file where the MONGO_URL will be set with the value of the execution environment\n\n```\nversion: '3'\nservices:\n mongo:\n image: mongo:3.2\n volumes:\n - mongo-data:/data/db\n expose:\n - \"27017\"\n app:\n image: message-app:v0.1\n ports:\n - \"8000:80\"\n links:\n - mongo\n depends_on:\n - mongo\n environment:\n - MONGO_URL=mongodb://mongo/messageApp\nvolumes:\n mongo-data:\n```\n\nThis file defines a release as it considers a given build and inject the execution environment.\n\nThe run phase can be done manually with Compose CLI or through an orchestrator (Docker Cloud).\n\nCompose CLI enables to run the global application as simple as `docker-compose up -d`\n\n[Previous](04_external_services.md) - [Next](06_processes.md)\n"
},
{
"path": "Docker/12factor/06_processes.md",
"content": "# 6 - Processes\n\nAn application is made up of several processes.\n\nEach process must be stateless and must not have local storage (sessions, ...).\n\nThis is required\n* for scalability\n* fault tolerance (crashes, ...)\n\nThe data that need to be persisted, must be saved in a stateful resources (Database, shared filesystem, ...)\n\nEg: sessions can easily be saved in a Redis kv store\n\nNote: Sticky session violate 12 factor.\n\n## What does that mean for our application ?\n\nIn _config/sessions.js_, we need to modify the adapter to store session in a distributed Redis kv store (MongoDB is another possible option).\n\n```\nmodule.exports.session = {\n ...\n adapter: 'redis',\n host: process.env.REDIS_HOST || 'localhost',\n ...\n};\n```\n\nOnce done, the app needs to be rebuilt `docker build -t message-app:v0.2 .`\n\n**REDIS_HOST** needs to be added to the docker-compose file as the new release will run against this kv store.\n\n```\nversion: '3'\nservices:\n mongo:\n image: mongo:3.2\n volumes:\n - mongo-data:/data/db\n expose:\n - \"27017\"\n kv:\n image: redis:alpine\n volumes:\n - redis-data:/data\n expose:\n - \"6379\"\n app:\n image: message-app:v0.2 # New version taking into account REDIS_URL\n ports:\n - \"8000:80\"\n links:\n - mongo\n depends_on:\n - mongo\n environment:\n - MONGO_URL=mongodb://mongo/messageApp\n - REDIS_URL=redis\nvolumes:\n mongo-data:\n redis-data:\n```\n\n[Previous](05_build_release_run.md) - [Next](07_port_binding.md)\n"
},
{
"path": "Docker/12factor/07_port_binding.md",
"content": "# 7 - Port binding\n\nThis factor is related to the exposition of the application to the outside.\n\nTo be compliant with 12 factor, an app must use specialized dependencies (such as http server, ...) and exposes its service through a port.\n\nThe host has the responsibility to route the request to the correct application through port mapping.\n\n## What does that mean for our application ?\n\nDocker already handles that for us, as we can see in the docker-compose file. The **app** container exposes port 80 internally and the host maps it against its port 8000.\n\n```\nversion: '3'\nservices:\n mongo:\n image: mongo:3.2\n volumes:\n - mongo-data:/data/db\n expose:\n - \"27017\"\n kv:\n image: redis:alpine\n volumes:\n - redis-data:/data\n expose:\n - \"6379\"\n app:\n image: message-app:v0.2 # New version taking into account REDIS_URL\n ports:\n - \"8000:80\" // app service is exposed on the port 8000 of the host\n links:\n - mongo\n depends_on:\n - mongo\n environment:\n - MONGO_URL=mongodb://mongo/messageApp\n - REDIS_URL=redis\nvolumes:\n mongo-data:\n redis-data:\n```\n\nIf several instances of the app services needs to be deployed, the configuration above cannot be used as a given port on the host cannot map several ports in the containers.\n\nIn this case, we can use a load balancer to which the host will map a port. The load balancer will then be in charge to balance the traffic on the different instances of the services. \n\n[Previous](06_processes.md) - [Next](08_concurrency.md)\n"
},
{
"path": "Docker/12factor/08_concurrency.md",
"content": "# 8 - Concurrency\n\nHorizontal scalability with the processes model.\n\nThe app can be seen as a set of processes of different types\n* web server\n* worker\n* cron\n\nEach process needs to be able to scale horizontally, it can have its own internal multiplexing.\n\n## What does that mean for our application ?\n\nThe messageApp only have one type of process (http server), it's doing the multiplexing using Node.js http server.\n\nThis process can be easily scalable (stateless process).\n\n[Previous](07_port_binding.md) - [Next](09_disposability.md)\n"
},
{
"path": "Docker/12factor/09_disposability.md",
"content": "# 9 - Disposability\n\nEach process of an application must be disposable.\n\n* it must have a quick startup\n * ease the horizontal scalability\n* it must ensure a clean shutdown\n * stop listening on the port\n * finish to handle the current request\n * usage of a queueing system for long lasting (worker type) process\n\n## What does that mean for our application ?\n\nOur application exposes HTTP endPoints that are easy and quick to handle. If we were to have some long lasting worker processes, the usage of a queueing system, like Apache Kafka, would be a great choice.\n\nKafka stores indexes of events processed by each worker. When a worker is restared, it can provide an index indicating at which point in time it needs to restart the event handling. Doing so no events are lost.\n\n[Docker Store](https://store.docker.com) offers several image of Kafka ([Spotify](https://store.docker.com/community/images/spotify/kafka), [Wurstmeister](https://store.docker.com/community/images/wurstmeister/kafka), ...) that can easily be integrated in the docker-compose file of the application.\n\nBelow is an example of how Kafka (and zookeeper) could be added to our docker-compose file. Of course, this means the application has been slightly changed to be able to write and read to/from Kafka.\n\n\n```\n# Kafka message broker\nzookeeper:\n image: wurstmeister/zookeeper\n ports:\n - \"2181:2181\"\nkafka:\n image: wurstmeister/kafka\n ports:\n - \"9092:9092\"\n links:\n - zookeeper:zk\n environment:\n KAFKA_ADVERTISED_HOST_NAME: 192.168.99.100\n KAFKA_CREATE_TOPICS: \"DATA:1:1\"\n volumes:\n - /var/run/docker.sock:/var/run/docker.sock\n```\n\n[Previous](08_concurrency.md) - [Next](10_dev_prod_parity.md)\n"
},
{
"path": "Docker/12factor/10_dev_prod_parity.md",
"content": "# 10 - Dev / Prod parity\n\nThe different environments must be as close as possible.\n\nDocker is very good at reducing the gap as the same services can be deployed on the developer machine as they could on any Docker Hosts.\n\nA lot of external services are available on the Docker Store and can be used in an existing application. Using those components enables a developer to use Postgres in development instead of SQLite or other lighter alternative. This reduces the risk of small differences that could show up later, when the app is on production.\n\nThis factor shows an orientation toward continuous deployment, where development can go from dev to production in a very short timeframe, thus avoiding the big bang effect at each release.\n\n\n## What does that mean for our application ?\n\nThe docker-compose file we built so far can be ran on the local machine or on any Docker Host. So Docker really shines at this level as it handles everything for us.\n\nThe exact same application can run on each environment.\n\n[Previous](09_disposability.md) - [Next](11_logs.md)\n"
},
{
"path": "Docker/12factor/11_logs.md",
"content": "# 11 - Logs\n\nLogs need to be handle as a timeseries of textual events\n\nThe application should not handle or save logs locally but must write them in stdout / stderr.\n\nA lot of services offer a centralized log management ([Elastic Stack / ELK](https://www.elastic.co/products) , [Splunk](http://splunk.com), [Logentries](https://logentries.com), ...), and most of them are very easily integrated with Docker.\n\nExample of Logentries dashboard:\n\n\n\n## What does that mean for our application ?\n\nIn order to centralize the logs, we can add a **log** service in our docker-compose file. The API token (provided by logentries) needs to be added to the service.\n\nAs we can see in the volume section, the Docker socket needs to be mounted so logentries container can retrieve each logs emitted by the running containers and send them to logentries external service.\n\n```\nlog:\n command: '-t XXXXXX-XXXXX-XXXXX-XXXXX'\n image: 'logentries/docker-logentries’\n restart: always\n volumes:\n - '/var/run/docker.sock:/var/run/docker.sock'\n```\n\n\n[Previous](10_dev_prod_parity.md) - [Next](12_admin_processes.md)\n"
},
{
"path": "Docker/12factor/12_admin_processes.md",
"content": "# 12 - Admin processes\n\nAdmin process should be seen as a one-off process (opposed to long running processes that make up an application).\n\nUsually used for maintenance task, though a REPL, admin process must be executed on the same release (codebase + configuration) than the application.\n\n## What does that mean for our application ?\n\nIn the docker-compose file we could define an admin service that is ran at the same time as the application and in which we could jump (`docker exec -ti ADMIN_CONTAINER_ID bash`) to execute some admin tasks. The container is able to access all the other containers of the application (provided it belongs to the same networks)\n\n[Previous](11_logs.md)\n"
},
{
"path": "Docker/12factor/README.md",
"content": "# 12 Factor Application\n\nToday, a lot of applications are services deployed in the cloud, on infrastructure of cloud providers such as Amazon AWS, Google Compute Engine, DigitalOcean, Rackspace, OVH, ...\n\nHeroku is PaaS (Platform as a Service) that relies on Amazon AWS and which makes the deployment of applications as easy as `git push heroku master` (ran from the root of your application).\n\nWith the huge number of applications deployed on Heroku, engineers of the company acquired a great knowledge of what should be done to get cloud native application.\n\n12 factor methodology is the result of their observations. As the name states, it presents 12 principles that will help application to be cloud ready, horizontally scalable, and portable.\n\n# Organisation of this lab\n\nIn this lab, we will start by building a simple Node.js application as an HTTP Rest API exposing CRUD (Create / Read / Update / Delete) verbs on a *message* model.\n\nHTTP verb | URI | Action\n----------| --- | ------\nGET | /message | list all messages\nGET | /message/ID | get message with ID\nPOST | /message | create a message user\nPUT | /message/ID | modify message with ID\nDELETE | /message/ID | delete message with ID\n\nWe will then follow each one of the 12 factor and see how this can leverage our application. At the same time, we will see that Docker is a really great fit for several of those factors.\n\n# Let's get started !\n\n[Build the application](00_application.md)\n\n[1 - Codebase](01_codebase.md)\n\n[2 - Dependencies](02_dependencies.md)\n\n[3 - Configuration](03_configuration.md)\n\n[4 - External services](04_external_services.md)\n\n[5 - Build / Release / Run](05_build_release_run.md)\n\n[6 - Processes](06_processes.md)\n\n[7 - Port binding](07_port_binding.md)\n\n[8 - Concurrency](08_concurrency.md)\n\n[9 - Disposability](09_disposability.md)\n\n[10 - Dev / Prod parity](10_dev_prod_parity.md)\n\n[11 - Logs](11_logs.md)\n\n[12 - Admin processes](12_admin_processes.md)\n\nDo not hesitate to provide comments / feedback you may have in order to improve this lab.\n"
},
{
"path": "Docker/Docker-Orchestration/readme.md",
"content": "## Advanced Docker Orchestration by Jérôme Petazzoni\n\n- [Slides](https://jpetazzo.github.io/orchestration-workshop)\n- [Orchestration Workshop](https://github.com/docker/orchestration-workshop)\n\n\n## Workshop Outline\n\n- Pre-requirements\n- VM environment\n- Our sample application\n- Running the application\n- Container port mapping\n- Identifying bottlenecks\n- Scaling HTTP on a single node\n- Put a load balancer on it\n- Connecting to containers on other hosts\n- Abstracting remote services with ambassadors\n- Various considerations about ambassadors\n- Docker for ops\n- Backups\n- Starting more containers from your container\n- Docker events stream\n- Attaching labels\n- Logs\n- Storing container logs in an ELK stack\n- Security upgrades\n- Network traffic analysis\n- Dynamic orchestration\n- Hands-on Swarm\n- Deploying Swarm\n- Cluster discovery\n- Resource allocation\n- Connecting containers with ambassadors\n- Setting up Consul and overlay networks\n- Multi-host networking\n- Building images with Swarm\n- Deploying a local registry\n- Scaling workers\n- Distributing Machine credentials\n- Highly available Swarm managers\n- Highly available containers\n- Conclusions\n"
},
{
"path": "Docker/README.md",
"content": "# Container, Cloud & DevOps Tutorials and Labs\n\n\n\nThis repo contains [Docker](https://docker.com) labs and tutorials authored both by Docker and by members of the community. We welcome contributions and want to grow the repo.\n\n#### Docker Tutorials:\n\n- [Docker Kickstart](kickstart/readme.md)\n- [Docker Training DevOpsDays](DevOpsDays/readme.md)\n- [Docker Swarm Mode](swarm-mode/README.md)\n- [Docker Security](security/README.md)\n- [Docker Networking](networking/)\n\n#### Additional Docker Labs\n\nBe sure to check out the additional Docker resources section aimed at Developers.\n\n- [Docker Additional Resources](additional-ressources/)\n\n#### Contributing\n\nWe want to see this repo grow, so if you have a tutorial to submit or contributions to existing tutorials, please see this guide:\n\n[Guide to submitting your tutorial](./../contribute.md)\n"
},
{
"path": "Docker/additional-ressources/README.md",
"content": "# Additional Docker Ressources\n\nThis repo contains [Docker](https://docker.com) labs and tutorials, useful links, newsletters, and general Docker ressources. We welcome contributions and want to grow the repo.\n\n#### Useful Links\n\n* [Awesome Docker](http://veggiemonk.github.io/awesome-docker/)\n* [Docker Documentation](http://docs.docker.com)\n* [Docker Labs](https://github.com/docker/labs)\n* [Play-with-Docker](https://labs.play-with-docker.com)\n* [More Hands-On Docker Training](http://training.play-with-docker.com/alacart/)\n\n\n#### Newsletters\n\n* [Docker Newsletter](http://email.docker.com/ZJI6a09YT0000w0vp30KLFC)\n* [5 for Friday](http://brianchristner.us3.list-manage.com/track/click?u=fc0e7be4fb674995b89251efb&id=7205e15ac9&e=f62a500248)\n* [The New Stack](https://thenewstack.io)\n* [Sysdig](https://sysdig.com/blog)\n* []\n\n#### Useful Projects\n\n* [Brian Christner](www.github.com/vegasbrianc/prometheus)\n* [Cloud Native Foundation](https://www.cncf.io)\n* [Jess Frazzle](https://github.com/jessfraz/dockerfiles)\n* [Prometheus](prometheus.io)\n* [Traefik Proxy](https://traefik.io)\n* \n\n\n#### Docker Tutorials:\n* [Configuring developer tools and programming languages](developer-tools/README.md)\n * Java\n * [Live Debugging Java with Docker](developer-tools/java-debugging)\n * [Docker for Java Developers](developer-tools/java/)\n * Node.js\n * [Live Debugging a Node.js application in Docker](developer-tools/nodejs-debugging)\n * [Dockerizing a Node.js application](developer-tools/nodejs/porting/)\n* [Docker for ASP.NET and Windows containers](windows/readme.md)\n* [Building a 12 Factor app with Docker](12factor/README.md)\n* [Hands-on Labs from DockerCon US 2017](dockercon-us-2017/)\n"
},
{
"path": "Docker/additional-ressources/developer-tools/README.md",
"content": "# Developer Tools Tutorials\n\nThis directory contains tutorials on how to set-up and use common developer tools and programming languages with Docker. We encourage you to [contribute](../contribute.md) your own tutorials here.\n\n## IDEs\n\nWith the introduction of [Docker for Mac](https://www.docker.com/products/docker#/mac) and [Docker for Windows](https://www.docker.com/products/docker#/windows), developers on those platforms got to use a feature that developers on [Docker for Linux](https://www.docker.com/products/docker#linux) had all along: in-container development. With improvements in volume management, Docker is able to detect when code in a volume changes, and update the code in the container. That means you get features like live debugging in a running container, without having to rebuild the container.\n\nYou can also have all your dependencies in a container. All you need is Docker and something to edit your source files on your machine, and you're good to go. That means you can, for instance, debug Node.js in your container without having Node.js on your local machine.\n\nIn order to take advantage of this feature in an IDE, there is some set-up required as there is for any project. The following sections describe how to configure different languages and IDEs to do in-container development.\n\n### [Java Developer Tools](https://github.com/docker/labs/tree/master/developer-tools/java-debugging) including:\n+ Eclipse\n+ IntelliJ\n+ Netbeans\n\n### [Node.js Developer Tools](https://github.com/docker/labs/blob/master/developer-tools/nodejs-debugging/README.md) including:\n+ Visual Studio Code\n\n## Programming languages\nThis is a more comprehensive section detailing how to set-up and optimize your experience using Docker with particular programming languages.\n\n+ [Java](java/)\n+ [Node.js](nodejs/porting/)\n"
},
{
"path": "Docker/additional-ressources/developer-tools/README_es.md",
"content": "# Tutoriales de Herramientas de Desarrollo\n\nEste directorio contiene tutoriales sobre como configurar y usar herramientas de desarrollo comunes con docker. Te animamos a [contribuir](../contribute.md) con tus propios tutoriales aquí.\n\n## IDEs\n\nCon la introducción de [Docker for Mac](https://www.docker.com/products/docker#/mac) y [Docker for Windows](https://www.docker.com/products/docker#/windows), los desarrolladores pueden ahora desarrollar dentro del contenedor de la misma manera que lo hacen los usuarios que utilizan [Docker for Linux](https://www.docker.com/products/docker#linux). Con mejoras en la administración de volúmenes, Docker permite detectar cuando el código en los volúmenes cambia, y actualizar el código en el contenedor. Esto significa que ahora es posible depurar un contenedor en vivo que se encuentra en ejecución, sin tener que reconstruir el contenedor.\n\n### [Herramientas de Desarrollo Java](https://github.com/docker/labs/tree/master/developer-tools/java-debugging) incluye:\n+ Eclipse\n+ IntelliJ\n+ Netbeans\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/appa-common-commands.adoc",
"content": "[appendix]\n[[Common_Docker_Commands]]\n== Common Docker Commands\n\nHere is the list of commonly used Docker commands:\n\n[width=\"100%\", options=\"header\"]\n|==================\n| Purpose| Command\n2+^s| Image\n| Build an image| `docker image build --rm=true .`\n| Install an image | `docker image pull ${IMAGE}`\n| List of installed images | `docker image ls`\n| List of installed images (detailed listing) | `docker image ls --no-trunc`\n| Remove an image | `docker image rm ${IMAGE_ID}`\n| Remove unused images | `docker image prune`\n| Remove all images | `docker image rm $(docker image ls -aq)`\n2+^s| Containers\n| Run a container | `docker container run`\n| List of running containers | `docker container ls`\n| List of all containers | `docker container ls -a`\n| Stop a container | `docker container stop ${CID}`\n| Stop all running containers | `docker container stop $(docker container ls -q)`\n| List all exited containers with status 1 | `docker container ls -a --filter \"exited=1\"`\n| Remove a container | `docker container rm ${CID}`\n| Remove container by a regular expression | `docker container ls -a \\| grep wildfly \\| awk '{print $1}' \\| xargs docker container rm -f`\n| Remove all exited containers | `docker container rm -f $(docker container ls -a \\| grep Exit \\| awk '{ print $1 }')`\n| Remove all containers | `docker container rm $(docker container ls -aq)`\n| Find IP address of the container | `docker container inspect --format '{{ .NetworkSettings.IPAddress }}' ${CID}`\n| Attach to a container | `docker container attach ${CID}`\n| Open a shell in to a container | `docker container \texec -it ${CID} bash`\n| Get container id for an image by a regular expression | `docker container ls \\| grep wildfly \\| awk '{print $1}'`\n|==================\n\n=== Exit code status\n\nThe exit code from `docker run` gives information about why the container failed to run or why it exited. The complete list of code is listed:\n\nhttps://docs.docker.com/engine/reference/run/#exit-status\n\nAll other codes are the exit code of the command running in the container."
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/appb-troubleshooting.adoc",
"content": "[appendix]\n[[Troubleshooting]]\n\n== Troubleshooting Docker\n\n=== Network Timed Out\n\nDepending upon the network speed and restrictions, you may not be able to download Docker images from Docker Store. The error message may look like:\n\n```console\n$ docker pull arungupta/wildfly-mysql-javaee7\nUsing default tag: latest\nPulling repository docker.io/arungupta/wildfly-mysql-javaee7\nNetwork timed out while trying to connect to https://index.docker.io/v1/repositories/arungupta/wildfly-mysql-javaee7/images. You may want to check your internet connection or if you are behind a proxy.\n```\n\nThis section provide a couple of alternatives to solve this.\n\n==== Restart Docker Machine\n\nIt seems like Docker Machine gets into a strange state and restarting it fixes that.\n\n```console\ndocker-machine restart \neval $(docker-machine env )\n```\n\n=== Cannot create Docker Machine on Windows\n\nAre you not able to create Docker Machine on Windows?\n\nTry starting a `cmd` with Administrator privileges and then give the command again.\n\n=== Docker machine creation fails with an error about dial tcp: i/o timeout\n\nIf you get the following error when creating a docker machine\n\n[source, text]\n----\nError creating machine: Error in driver during machine creation: Get https://api.github.com/repos/boot2docker/boot2docker/releases: dial tcp: i/o timeout\n----\n\nThen you need to go to the boot2docker releases page on\n\nhttps://github.com/boot2docker/boot2docker/releases\n\nAnd download the latest .iso\n\nAfter that you can move that iso to the docker cache directory. This is located in `~/.docker/machine/cache` on Mac & Linux and `/Users/yourUserName/.docker/machine/cache` on Windows.\n\nIssue: https://github.com/docker/machine/issues/2186 is raised so that the docker-machine team can hopefully find a way around this.\n\n=== \"`You may be getting rate limited by Github`\" error message\n\nCredits: https://github.com/docker/machine/blob/master/README.md#troubleshooting\n\nIn order to `create` or `upgrade` virtual machines running Docker, Docker\nMachine will check the Github API for the latest release of the [boot2docker\noperating system](https://github.com/boot2docker/boot2docker). The Github API\nallows for a small number of unauthenticated requests from a given client, but\nif you share an IP address with many other users (e.g. in an office), you may\nget rate limited by their API, and Docker Machine will error out with messages\nindicating this.\n\nIn order to work around this issue, you can https://help.github.com/articles/creating-an-access-token-for-command-line-use/[generate a\ntoken] and pass it to Docker Machine using the global `--github-api-token` flag:\n\n```console\n$ docker-machine --github-api-token=token create -d virtualbox newbox\n```\n\nThis should eliminate any issues you've been experiencing with rate limiting.\n\n=== Docker Machine Troubleshooting\n\nhttps://github.com/docker/machine/blob/master/README.md#troubleshooting[Docker Machine Troubleshooting] section has good tips on what can possibly go wrong with Docker Machine. Look there if your issue is not explained here.\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/appc-references.adoc",
"content": "[appendix]\n[[References]]\n\n== References\n\n. Docker Docs: http://docs.docker.com\n. Latest lab content: https://github.com/docker/labs/tree/master/developer-tools/java\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch01-setup.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n= Setup Environments\n\nThis section describes the hardware and software needed for this workshop, and how to configure them. This workshop is designed for a BYOL (Brying Your Own Laptop) style hands-on-lab.\n\n== Hardware & Software\n\n. Memory: At least 4 GB+, strongly preferred 8 GB\n. Operating System: Mac OS X (10.10.3+), Windows 10 Pro+ 64-bit, Ubuntu 12+, CentOS 7+.\n+\nNOTE: An older version of the operating system may be used. The installation instructions would differ slightly in that case and are explained in the next section.\n. Amazon Web Services credentials with the https://docs.docker.com/docker-for-aws/iam-permissions/[following permissions]. This is only needed for some parts of the workshop.\n\n== Install Docker\n\nDocker runs natively on Mac, Windows and Linux. This lab will use https://www.docker.com/community-edition[Docker Community Edition (CE)]. Download the Docker CE edition for your machine from the https://store.docker.com/search?type=edition&offering=community[Docker Store]. \n\nNOTE: Docker CE requires a fairly recent operating system version. If your machine does not meet the requirements, then you need to install https://www.docker.com/products/docker-toolbox[Docker Toolbox]. \n\nThis workshop is tested with Docker Community Edition `17.09.0-ce-rc2, build 363a3e7` on Mac OS X `10.12.5`.\n\n== Download Images\n\nThis tutorial uses a few Docker images and software. Let's download them before we start the tutorial.\n\nDownload the file from https://raw.githubusercontent.com/docker/labs/master/developer-tools/java/scripts/docker-compose-pull-images.yml and use the following command to pull the required images:\n\n docker-compose -f docker-compose-pull-images.yml pull --parallel\n\nNOTE: For Linux, `docker-compose` and `docker` commands need `sudo` access. So prefix all commands with `sudo`.\n\n== Other Software\n\nThe software in this section is specific to certain parts of the workshop. Install them only if you plan to attempt them.\n\n. Install https://git-scm.com//[git].\n. Install Docker Cloud CLI following the https://docs.docker.com/docker-cloud/installing-cli/[instructions].\n. Download Java IDE based upon your choice and install.\n.. https://netbeans.org/downloads/[NetBeans 8.2] (`\"Java SE\"` version)\n.. https://www.jetbrains.com/idea/download/[IntelliJ IDEA Community or Ultimate]\n.. http://www.eclipse.org/downloads/eclipse-packages/[Eclipse IDE for Java EE Developers]\n. Download https://maven.apache.org/download.cgi[Maven] and install.\n. Download the OpenJDK build of http://download.java.net/java/GA/jdk9/9/binaries/openjdk-9_linux-x64_bin.tar.gz[JDK 9 for Linux x64].\n (See also the http://jdk.java.net/9/[OpenJDK JDK 9 download page].)\n. Download the early-access Open JDK build of http://jdk.java.net/9/ea[JDK 9 for Alpine Linux].\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch02-basic-concepts.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n[[Docker_Basics]]\n= Docker Basic Concepts\n\n*PURPOSE*: This chapter introduces the basic terminology of Docker.\n\n[quote, docs.docker.com/]\nDocker is a platform for developers and sysadmins to build, ship, and run applications. Docker lets you quickly assemble applications from components and eliminates the friction that can come when shipping code. Docker lets you test and deploy your code into production as fast as possible.\n\nDocker simplifies software delivery by making it easy to build and share images that contain your application’s entire environment, or _application operating system_.\n\n**What does it mean by an application operating system ?**\n\nYour application typically requires specific versions for your operating system, application server, JDK, and database server, may require to tune the configuration files, and similarly multiple other dependencies. The application may need binding to specific ports and certain amount of memory. The components and configuration together required to run your application is what is referred to as application operating system.\n\nYou can certainly provide an installation script that will download and install these components. Docker simplifies this process by allowing to create an image that contains your application and infrastructure together, managed as one component. These images are then used to create Docker containers which run on the container virtualization platform, provided by Docker.\n\n== Main Components\n\nDocker has three main components:\n\n. __Images__ are the *build component* of Docker and are the read-only templates defining an application operating system.\n. __Containers__ are the *run component* of Docker and created from images. Containers can be run, started, stopped, moved, and deleted.\n. Images are stored, shared, and managed in a __registry__ and are the *distribution component* of Docker. Docker Store is a publicly available registry and is available at http://store.docker.com.\n\nIn order for these three components to work together, the *Docker Daemon* (or Docker Engine) runs on a host machine and does the heavy lifting of building, running, and distributing Docker containers. In addition, the *Client* is a Docker binary which accepts commands from the user and communicates back and forth with the Engine.\n\n.Docker architecture\nimage::docker-architecture.png[]\n\nThe Client communicates with the Engine that is either co-located on the same host or on a different host. Client uses the `pull` command to request the Engine to pull an image from the registry. The Engine then downloads the image from Docker Store, or whichever registry is configured. Multiple images can be downloaded from the registry and installed on the Engine. Client uses the `run` run the container.\n\n== Docker Image\n\nWe've already seen that Docker images are read-only templates from which Docker containers are launched. Each image consists of a series of layers. Docker makes use of union file systems to combine these layers into a single image. Union file systems allow files and directories of separate file systems, known as branches, to be transparently overlaid, forming a single coherent file system.\n\nOne of the reasons Docker is so lightweight is because of these layers. When you change a Docker image—for example, update an application to a new version— a new layer gets built. Thus, rather than replacing the whole image or entirely rebuilding, as you may do with a virtual machine, only that layer is added or updated. Now you don't need to distribute a whole new image, just the update, making distributing Docker images faster and simpler.\n\nEvery image starts from a base image, for example `ubuntu`, a base Ubuntu image, or `fedora`, a base Fedora image. You can also use images of your own as the basis for a new image, for example if you have a base Apache image you could use this as the base of all your web application images.\n\nNOTE: By default, Docker obtains these base images from Docker Store.\n\nDocker images are then built from these base images using a simple, descriptive set of steps we call instructions. Each instruction creates a new layer in our image. Instructions include actions like:\n\n. Run a command\n. Add a file or directory\n. Create an environment variable\n. Run a process when launching a container\n\nThese instructions are stored in a file called a Dockerfile. Docker reads this Dockerfile when you request a build of an image, executes the instructions, and returns a final image.\n\n== Docker Container\n\nA container consists of an operating system, user-added files, and meta-data. As we've seen, each container is built from an image. That image tells Docker what the container holds, what process to run when the container is launched, and a variety of other configuration data. The Docker image is read-only. When Docker runs a container from an image, it adds a read-write layer on top of the image (using a union file system as we saw earlier) in which your application can then run.\n\n== Docker Engine\n\nDocker Host is created as part of installing Docker on your machine. Once your Docker host has been created, it then allows you to manage images and containers. For example, the image can be downloaded and containers can be started, stopped and restarted.\n\n== Docker Client\n\nThe client communicates with the Docker Host and let's you work with images and containers.\n\nCheck if your client is working using the following command:\n\n docker -v\n\nIt shows the output:\n\n Docker version 17.09.0-ce-rc3, build 2357fb2\n\nNOTE: The exact version may differ based upon how recently the installation was performed.\n\nThe exact version of Client and Server can be seen using `docker version` command. This shows the output as:\n\n```\nClient:\n Version: 17.09.0-ce-rc3\n API version: 1.32\n Go version: go1.8.3\n Git commit: 2357fb2\n Built: Thu Sep 21 02:31:18 2017\n OS/Arch: darwin/amd64\n\nServer:\n Version: 17.09.0-ce-rc3\n API version: 1.32 (minimum version 1.12)\n Go version: go1.8.3\n Git commit: 2357fb2\n Built: Thu Sep 21 02:36:52 2017\n OS/Arch: linux/amd64\n Experimental: true\n```\n\nThe complete set of commands can be seen using `docker --help`.\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch03-build-image-java-9.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n= Build a Docker Image with JDK 9\n\n*PURPOSE*: This chapter explains how to create a Docker image with JDK 9.\n\nThe link:ch03-build-image.adoc[prior chapter] explained how, in general, to build a Docker image with Java.\nThis chapter expands on this topic and focuses on JDK 9 features.\n\n== Create a Docker Image using JDK 9\n\nCreate a new directory, for example `docker-jdk9`.\n\nIn that directory, create a new text file `jdk-9-debian-slim.Dockerfile`.\nUse the following contents:\n\n[source, text]\n----\n# A JDK 9 with Debian slim\nFROM debian:stable-slim\n# Download from http://jdk.java.net/9/\n# ADD http://download.java.net/java/GA/jdk9/9/binaries/openjdk-9_linux-x64_bin.tar.gz /opt\nADD openjdk-9_linux-x64_bin.tar.gz /opt\n# Set up env variables\nENV JAVA_HOME=/opt/jdk-9\nENV PATH=$PATH:$JAVA_HOME/bin\nCMD [\"jshell\", \"-J-XX:+UnlockExperimentalVMOptions\", \\\n \"-J-XX:+UseCGroupMemoryLimitForHeap\", \\\n \"-R-XX:+UnlockExperimentalVMOptions\", \\\n \"-R-XX:+UseCGroupMemoryLimitForHeap\"]\n----\n\nThis image uses `debian` slim as the base image and installs the OpenJDK build\nof JDK for linux x64 (see the link:ch01-setup.adoc[setup section] for how to download this into the\ncurrent directory).\n\nThe image is configured by default to run `jshell` the Java REPL. Read more JShell at link:https://docs.oracle.com/javase/9/jshell/introduction-jshell.htm[Introduction to JShell]. The\nexperimental flag `-XX:+UseCGroupMemoryLimitForHeap` is passed to the REPL\nprocess (the frontend Java process managing user input and the backend Java\nprocess managing compilation). This option will ensure container memory\nconstraints are honored.\n\nBuild the image using the command:\n\n docker image build -t jdk-9-debian-slim -f jdk-9-debian-slim.Dockerfile .\n\nList the images available using `docker image ls`:\n\n[source, text]\n----\nREPOSITORY TAG IMAGE ID CREATED SIZE\njdk-9-debian-slim latest 023f6999d94a 4 hours ago 400MB\ndebian stable-slim d30525fb4ed2 4 days ago 55.3MB\n----\n\nOther images may be shown as well but we are interested in these two images for\nnow. The large difference in size is attributed to JDK 9, which is larger\nin size than JDK 8 because it also explicitly provides Java modules that we\nshall see more of later on in this chapter.\n\nRun the container using the command:\n\n docker container run -m=200M -it --rm jdk-9-debian-slim\n\nto see the output:\n\n[source, text]\n----\nINFO: Created user preferences directory.\n| Welcome to JShell -- Version 9\n| For an introduction type: /help intro\n\njshell>\n----\n\nQuery the available memory of the Java process by typing the following\nexpression into the Java REPL:\n\n Runtime.getRuntime().maxMemory() / (1 << 20)\n\nto see the output:\n\n[source, text]\n----\njshell> Runtime.getRuntime().maxMemory() / (1 << 20)\n$1 ==> 100\n----\n\nNotice that the Java process is honoring memory constraints (see the `--memory`\nof `docker container run`) and will not allocate memory beyond that specified for the\ncontainer.\n\nIn a future release of the JDK it will no longer be necessary to specify an\nexperimental flag (`-XX:+UnlockExperimentalVMOptions`) once the mechanism by\nwhich memory constraints are efficiently detected is stable.\n\nJDK 9 supports the set CPUs constraint (see the `--cpuset-cpus` of\n`docker container run`) but does not currently support other CPU constraints such as\nCPU shares. This is ongoing work http://openjdk.java.net/jeps/8182070[tracked]\nin the OpenJDK project.\n\nNote: the support for CPU sets and memory constraints have also been backported\nto JDK 8 release 8u131 and above.\n\nType `Ctrl` + `D` to exit out of `jshell`.\n\nTo list all the Java modules distributed with JDK 9 run the following command:\n\n docker container run -m=200M -it --rm jdk-9-debian-slim java --list-modules\n\nThis will show an output:\n\n[source, text]\n----\njava.activation@9\njava.base@9\njava.compiler@9\njava.corba@9\njava.datatransfer@9\njava.desktop@9\njava.instrument@9\njava.logging@9\njava.management@9\njava.management.rmi@9\njava.naming@9\njava.prefs@9\njava.rmi@9\njava.scripting@9\njava.se@9\njava.se.ee@9\njava.security.jgss@9\njava.security.sasl@9\njava.smartcardio@9\njava.sql@9\njava.sql.rowset@9\njava.transaction@9\njava.xml@9\njava.xml.bind@9\njava.xml.crypto@9\njava.xml.ws@9\njava.xml.ws.annotation@9\njdk.accessibility@9\njdk.aot@9\njdk.attach@9\njdk.charsets@9\njdk.compiler@9\njdk.crypto.cryptoki@9\njdk.crypto.ec@9\njdk.dynalink@9\njdk.editpad@9\njdk.hotspot.agent@9\njdk.httpserver@9\njdk.incubator.httpclient@9\njdk.internal.ed@9\njdk.internal.jvmstat@9\njdk.internal.le@9\njdk.internal.opt@9\njdk.internal.vm.ci@9\njdk.internal.vm.compiler@9\njdk.jartool@9\njdk.javadoc@9\njdk.jcmd@9\njdk.jconsole@9\njdk.jdeps@9\njdk.jdi@9\njdk.jdwp.agent@9\njdk.jlink@9\njdk.jshell@9\njdk.jsobject@9\njdk.jstatd@9\njdk.localedata@9\njdk.management@9\njdk.management.agent@9\njdk.naming.dns@9\njdk.naming.rmi@9\njdk.net@9\njdk.pack@9\njdk.policytool@9\njdk.rmic@9\njdk.scripting.nashorn@9\njdk.scripting.nashorn.shell@9\njdk.sctp@9\njdk.security.auth@9\njdk.security.jgss@9\njdk.unsupported@9\njdk.xml.bind@9\njdk.xml.dom@9\njdk.xml.ws@9\njdk.zipfs@9\n----\n\nIn total there should be 75 modules:\n\n[source, text]\n----\n$ docker container run -m=200M -it --rm jdk-9-debian-slim java --list-modules | wc -l\n 75\n----\n\n== Create a Docker Image using JDK 9 and Alpine Linux\n\nInstead of `debian` as the base image it is possible to use Alpine Linux\nwith an early access build of JDK 9 that is compatible with the muslc library\nshipped with Alpine Linux.\n\nCreate a new text file `jdk-9-alpine.Dockerfile`.\nUse the following contents:\n\n[source, text]\n----\n# A JDK 9 with Alpine Linux\nFROM alpine:3.6\n# Add the musl-based JDK 9 distribution\nRUN mkdir /opt\n# Download from http://jdk.java.net/9/\n# ADD http://download.java.net/java/jdk9-alpine/archive/181/binaries/jdk-9-ea+181_linux-x64-musl_bin.tar.gz\nADD jdk-9-ea+181_linux-x64-musl_bin.tar.gz /opt\n# Set up env variables\nENV JAVA_HOME=/opt/jdk-9\nENV PATH=$PATH:$JAVA_HOME/bin\nCMD [\"jshell\", \"-J-XX:+UnlockExperimentalVMOptions\", \\\n \"-J-XX:+UseCGroupMemoryLimitForHeap\", \\\n \"-R-XX:+UnlockExperimentalVMOptions\", \\\n \"-R-XX:+UseCGroupMemoryLimitForHeap\"]\n----\n\nThis image uses `alpine` 3.6 as the base image and installs the OpenJDK build\nof JDK for Alpine Linux x64 (see the link:ch01-setup.adoc[Setup Environments]\nchapter for how to download this into the current directory).\n\nThe image is configured in the same manner as for the `debian`-based image.\n\nBuild the image using the command:\n\n docker image build -t jdk-9-alpine -f jdk-9-alpine.Dockerfile .\n\nList the images available using `docker image ls`:\n\n[source, text]\n----\nREPOSITORY TAG IMAGE ID CREATED SIZE\njdk-9-debian-slim latest 023f6999d94a 4 hours ago 400MB\njdk-9-alpine latest f5a57382f240 4 hours ago 356MB\ndebian stable-slim d30525fb4ed2 4 days ago 55.3MB\nalpine 3.6 7328f6f8b418 3 months ago 3.97MB\n----\n\nNotice the difference in image sizes. Alpine Linux by design has been carefully\ncrafted to produce a minimal running OS image. A cost of such a design is\nan alternative standard library https://www.musl-libc.org/[musl libc] that is\nnot compatible with the C standard library (libc). As a result the JDK requires\nmodifications to run on Alpine Linux. Such modifications have been proposed\nby the OpenJDK http://openjdk.java.net/projects/portola/[Portola Project].\n\n\n== Create a Docker Image using JDK 9 and a Java application\n\nClone the GitHib project https://github.com/PaulSandoz/helloworld-java-9 that\ncontains a simple Java 9-based project:\n\n git clone https://github.com/PaulSandoz/helloworld-java-9.git\n\n(If you have a github account you may wish to fork it and then clone the fork\nso you can make modifications.)\n\nEnter the directory `helloworld-java-9` and build the project from within a\nrunning Docker container with JDK 9 installed:\n\n docker container run --volume $PWD:/helloworld-java-9 --workdir /helloworld-java-9 \\\n -it --rm openjdk:9-jdk-slim \\\n ./mvnw package\n\n(If you have JDK 9 installed locally on the host system you can build directly\nwith `./mvnw package`.)\n\nIn this case we are using the `openjdk:9-jdk-slim` on Docker hub that has been\nconfigured to work with SSL certificates so that the maven wrapper tool can\nsuccessfully download the maven tool. This image is not produced or in anyway\nendorsed by the OpenJDK project (unlike the JDK 9 distributions that were\npreviously required). It is anticipated that future releases of the JDK from\nthe OpenJDK project will have root CA certificates (see issue\nhttps://bugs.openjdk.java.net/browse/JDK-8189131[JDK-8189131])\n\nTo build Docker image for this application use the file `helloworld-jdk-9.Dockerfile` from the checked out repo to build your image. The contents of the file are shown below:\n\n[source, text]\n----\n# Hello world application with JDK 9 and Debian slim\nFROM jdk-9-debian-slim\nCOPY target/helloworld-1.0-SNAPSHOT.jar /opt/helloworld/helloworld-1.0-SNAPSHOT.jar\n# Set up env variables\nCMD java -XX:+UnlockExperimentalVMOptions -XX:+UseCGroupMemoryLimitForHeap \\\n -cp /opt/helloworld/helloworld-1.0-SNAPSHOT.jar org.examples.java.App\n----\n\nBuild a Docker image containing the simple Java application based of the Docker\nimage `jdk-9-debian-slim`:\n\n docker image build -t helloworld-jdk-9 -f helloworld-jdk-9.Dockerfile .\n\nList the images available using `docker image ls`:\n\n[source, text]\n----\nREPOSITORY TAG IMAGE ID CREATED SIZE\nhelloworld-jdk-9 latest eb0539e9529a 19 seconds ago 400MB\njdk-9-debian-slim latest 023f6999d94a 5 hours ago 400MB\njdk-9-alpine latest f5a57382f240 5 hours ago 356MB\nopenjdk 9-jdk-slim 6dca67f4790e 3 days ago 372MB\ndebian stable-slim d30525fb4ed2 4 days ago 55.3MB\nalpine 3.6 7328f6f8b418 3 months ago 3.97MB\n----\n\nNotice how large the application image `helloworld-jdk-9`.\n\nRun the `jdeps` tool to see what modules the application depends on:\n\n docker container run -it --rm helloworld-jdk-9 jdeps --list-deps /opt/helloworld/helloworld-1.0-SNAPSHOT.jar\n\nand observe that the application only depends on the `java.base` module.\n\n== Reduce the size of a Docker Image using JDK 9 and a Java application\n\nThe Java application is extremely simple and as a result uses very little of the\nfunctionality shipped with JDK 9 distribution, specifically the application\nonly depends on functionality present in the `java.base` module. We can create\na custom Java runtime that only contains the `java.base` module and include\nthat in application Docker image.\n\nCreate a custom Java runtime that is small and only contains the `java.base`\nmodule:\n\n docker container run --rm \\\n --volume $PWD:/out \\\n jdk-9-debian-slim \\\n jlink --module-path /opt/jdk-9/jmods \\\n --verbose \\\n --add-modules java.base \\\n --compress 2 \\\n --no-header-files \\\n --output /out/target/openjdk-9-base_linux-x64\n\nThis command exists as `create-minimal-java-runtime.sh` script in the repo earlier checked out from link:https://github.com/PaulSandoz/helloworld-java-9[helloworld-java-9].\n\nThe JDK 9 tool `jlink` is used to create the custom Java runtime. Read more jlink in the https://docs.oracle.com/javase/9/tools/jlink.htm[Tools Reference]. The tool\nis executed from with the container containing JDK 9 and directory where the\nmodules reside, `/opt/jdk-9/jmods`, is declared in the module path. Only the\n`java.base` module is selected.\n\nThe custom runtime is output to the `target` directory:\n\n[source, text]\n----\n$ du -k target/openjdk-9-base_linux-x64/\n24 target/openjdk-9-base_linux-x64//bin\n12 target/openjdk-9-base_linux-x64//conf/security/policy/limited\n8 target/openjdk-9-base_linux-x64//conf/security/policy/unlimited\n24 target/openjdk-9-base_linux-x64//conf/security/policy\n68 target/openjdk-9-base_linux-x64//conf/security\n76 target/openjdk-9-base_linux-x64//conf\n44 target/openjdk-9-base_linux-x64//legal/java.base\n44 target/openjdk-9-base_linux-x64//legal\n72 target/openjdk-9-base_linux-x64//lib/jli\n16 target/openjdk-9-base_linux-x64//lib/security\n19824 target/openjdk-9-base_linux-x64//lib/server\n31656 target/openjdk-9-base_linux-x64//lib\n31804 target/openjdk-9-base_linux-x64/\n----\n\nTo build Docker image for this application use the file `helloworld-jdk-9-base.Dockerfile` from the checked out repo. The contents of the file are shown below:\n\n[source, text]\n----\n# Hello world application with custom Java runtime with just the base module and Debian slim\nFROM debian:stable-slim\nCOPY target/openjdk-9-base_linux-x64 /opt/jdk-9\nCOPY target/helloworld-1.0-SNAPSHOT.jar /opt/helloworld/helloworld-1.0-SNAPSHOT.jar\n# Set up env variables\nENV JAVA_HOME=/opt/jdk-9\nENV PATH=$PATH:$JAVA_HOME/bin\nCMD java -XX:+UnlockExperimentalVMOptions -XX:+UseCGroupMemoryLimitForHeap \\\n -cp /opt/helloworld/helloworld-1.0-SNAPSHOT.jar org.examples.java.App\n----\n\nBuild a Docker image containing the simple Java application based of the Docker\nimage `debian:stable-slim`:\n\n docker image build -t helloworld-jdk-9-base -f helloworld-jdk-9-base.Dockerfile .\n\nList the images available using `docker image ls`:\n\n[source, text]\n----\nREPOSITORY TAG IMAGE ID CREATED SIZE\nhelloworld-jdk-9-base latest 7052483fdb77 24 seconds ago 87.7MB\nhelloworld-jdk9 latest eb0539e9529a 17 minutes ago 400MB\njdk-9-debian-slim latest 023f6999d94a 5 hours ago 400MB\njdk-9-alpine latest f5a57382f240 5 hours ago 356MB\nopenjdk 9-jdk-slim 6dca67f4790e 3 days ago 372MB\ndebian stable-slim d30525fb4ed2 4 days ago 55.3MB\nalpine 3.6 7328f6f8b418 3 months ago 3.97MB\n[source, text]\n----\n\nThe `helloworld-jdk-9-base` is much smaller and could be reduced further if\nAlpine Linux was used instead of Debian Slim.\n\nA realistic application will depend on more JDK modules but it's still possible\nto significantly reduce the Java runtime to only the required modules (for\nexample many applications will not require Corba or RMI nor the compiler tools).\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch03-build-image.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n= Build a Docker Image\n\n*PURPOSE*: This chapter explains how to create a Docker image.\n\n== Dockerfile\n\nDocker build images by reading instructions from a _Dockerfile_. A _Dockerfile_ is a text document that contains all the commands a user could call on the command line to assemble an image. `docker image build` command uses this file and executes all the commands in succession to create an image.\n\n`build` command is also passed a context that is used during image creation. This context can be a path on your local filesystem or a URL to a Git repository.\n\n_Dockerfile_ is usually called _Dockerfile_. The complete list of commands that can be specified in this file are explained at https://docs.docker.com/reference/builder/. The common commands are listed below:\n\n.Common commands for Dockerfile\n[width=\"100%\", options=\"header\", cols=\"1,4,4\"]\n|==================\n| Command | Purpose | Example\n| FROM | First non-comment instruction in _Dockerfile_ | `FROM ubuntu`\n| COPY | Copies mulitple source files from the context to the file system of the container at the specified path | `COPY .bash_profile /home`\n| ENV | Sets the environment variable | `ENV HOSTNAME=test`\n| RUN | Executes a command | `RUN apt-get update`\n| CMD | Defaults for an executing container | `CMD [\"/bin/echo\", \"hello world\"]`\n| EXPOSE | Informs the network ports that the container will listen on | `EXPOSE 8093`\n|==================\n\n== Create your first image\n\nCreate a new directory `hellodocker`.\n\nIn that directory, create a new text file `Dockerfile`. Use the following contents:\n\n[source, text]\n----\nFROM ubuntu:latest\n\nCMD [\"/bin/echo\", \"hello world\"]\n----\n\nThis image uses `ubuntu` as the base image. `CMD` command defines the command that needs to run. It provides a different entry point of `/bin/echo` and gives the argument \"`hello world`\".\n\nBuild the image using the command:\n\n[source, text]\n----\n docker image build . -t helloworld\n----\n\n`.` in this command is the context for the command `docker image build`. `-t` adds a tag to the image.\n\nThe following output is shown:\n\n[source, text]\n----\nSending build context to Docker daemon 2.048kB\nStep 1/2 : FROM ubuntu:latest\nlatest: Pulling from library/ubuntu\n9fb6c798fa41: Pull complete \n3b61febd4aef: Pull complete \n9d99b9777eb0: Pull complete \nd010c8cf75d7: Pull complete \n7fac07fb303e: Pull complete \nDigest: sha256:31371c117d65387be2640b8254464102c36c4e23d2abe1f6f4667e47716483f1\nStatus: Downloaded newer image for ubuntu:latest\n ---> 2d696327ab2e\nStep 2/2 : CMD /bin/echo hello world\n ---> Running in 9356a508590c\n ---> e61f88f3a0f7\nRemoving intermediate container 9356a508590c\nSuccessfully built e61f88f3a0f7\nSuccessfully tagged helloworld:latest\n----\n\nList the images available using `docker image ls`:\n\n[source, text]\n----\nREPOSITORY TAG IMAGE ID CREATED SIZE\nhelloworld latest e61f88f3a0f7 3 minutes ago 122MB\nubuntu latest 2d696327ab2e 4 days ago 122MB\n----\n\nOther images may be shown as well but we are interested in these two images for now.\n\nRun the container using the command:\n\n docker container run helloworld\n\nto see the output:\n\n hello world\n\nIf you do not see the expected output, check your Dockerfile that the content exactly matches as shown above. Build the image again and now run it.\n\nChange the base image from `ubuntu` to `busybox` in `Dockerfile`. Build the image again:\n\n docker image build -t helloworld:2 .\n\nand view the images using `docker image ls` command:\n\n[source, text]\n----\nREPOSITORY TAG IMAGE ID CREATED SIZE\nhelloworld 2 7fbedda27c66 3 seconds ago 1.13MB\nhelloworld latest e61f88f3a0f7 5 minutes ago 122MB\nubuntu latest 2d696327ab2e 4 days ago 122MB\nbusybox latest 54511612f1c4 9 days ago 1.13MB\n----\n\n`helloworld:2` is the format that allows to specify the image name and assign a tag/version to it separated by `:`.\n\n== Create your first image using Java\n\n=== Create a simple Java application\n\n[NOTE]\n====\nIf you are running OpenJDK 9, `mvn package` may fail with\n[source, text]\n----\n[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.1:compile (default-compile) on project helloworld: Compilation failure: Compilation failure:\n[ERROR] Source option 1.5 is no longer supported. Use 1.6 or later.\n[ERROR] Target option 1.5 is no longer supported. Use 1.6 or later.\n----\nbecause support for Java 5 http://openjdk.java.net/jeps/182[was dropped in JDK9].\n\nYou can add\n[source, xml]\n----\n \n 1.6\n 1.6\n \n----\nto the generated `pom.xml` to target 1.6 instead. See also the link:chapters/ch03-build-image-java-9.adoc[Build a Docker Image for Java 9] chapter.\n====\n\nCreate a new Java project:\n\n[source, text]\n----\nmvn archetype:generate -DgroupId=org.examples.java -DartifactId=helloworld -DinteractiveMode=false\n----\n\nBuild the project:\n\n[source, text]\n----\ncd helloworld\nmvn package\n----\n\nRun the Java class:\n\n[source, text]\n----\njava -cp target/helloworld-1.0-SNAPSHOT.jar org.examples.java.App\n----\n\nThis shows the output:\n\n[source, text]\n----\nHello World!\n----\n\nLet's package this application as a Docker image.\n\n==== Java Docker image\n\nRun the OpenJDK container in an interactive manner:\n\n docker container run -it openjdk\n\nThis will open a terminal in the container. Check the version of Java:\n\n[source, text]\n----\nroot@8d0af9da5258:/# java -version\nopenjdk version \"1.8.0_141\"\nOpenJDK Runtime Environment (build 1.8.0_141-8u141-b15-1~deb9u1-b15)\nOpenJDK 64-Bit Server VM (build 25.141-b15, mixed mode)\n----\n\nA different JDK version may be shown in your case. \n\nExit out of the container by typing `exit` in the container shell.\n\n=== Package and run Java application as Docker image\n\nCreate a new Dockerfile in `helloworld` directory and use the following content:\n\n[source, text]\n----\nFROM openjdk:latest\n\nCOPY target/helloworld-1.0-SNAPSHOT.jar /usr/src/helloworld-1.0-SNAPSHOT.jar\n\nCMD java -cp /usr/src/helloworld-1.0-SNAPSHOT.jar org.examples.java.App\n----\n\nBuild the image:\n\n docker image build -t hello-java:latest .\n\nRun the image:\n\n docker container run hello-java:latest\n\nThis displays the output:\n\n Hello World!\n\nThis shows the exactly same output that was printed when the Java class was invoked using Java CLI.\n\n=== Package and run Java Application using Docker Maven Plugin\n\nhttps://github.com/fabric8io/docker-maven-plugin[Docker Maven Plugin] allows you to manage Docker images and containers using Maven. It comes with predefined goals:\n\n[options=\"header\"]\n|====\n|Goal | Description\n| `docker:build` | Build images\n| `docker:start` | Create and start containers\n| `docker:stop` | Stop and destroy containers\n| `docker:push` | Push images to a registry\n| `docker:remove` | Remove images from local docker host\n| `docker:logs` | Show container logs\n|====\n\nComplete set of goals are listed at https://github.com/fabric8io/docker-maven-plugin.\n\nClone the sample code from https://github.com/arun-gupta/docker-java-sample/.\n\nCreate the Docker image:\n\n mvn -f docker-java-sample/pom.xml package -Pdocker\n\nThis will show an output like:\n\n[source, text]\n----\n[INFO] Copying files to /Users/argu/workspaces/docker-java-sample/target/docker/hellojava/build/maven\n[INFO] Building tar: /Users/argu/workspaces/docker-java-sample/target/docker/hellojava/tmp/docker-build.tar\n[INFO] DOCKER> [hellojava:latest]: Created docker-build.tar in 87 milliseconds\n[INFO] DOCKER> [hellojava:latest]: Built image sha256:6f815\n[INFO] ------------------------------------------------------------------------\n[INFO] BUILD SUCCESS\n[INFO] ------------------------------------------------------------------------\n----\n\nThe list of images can be checked using the command `docker image ls | grep hello-java`:\n\n[source, text]\n----\nhello-java latest ea64a9f5011e 5 seconds ago 643 MB\n----\n\nRun the Docker container:\n\n mvn -f docker-java-sample/pom.xml install -Pdocker\n\nThis will show an output like:\n\n[source, text]\n----\n[INFO] DOCKER> [hellojava:latest]: Start container 30a08791eedb\n30a087> Hello World!\n[INFO] DOCKER> [hellojava:latest]: Waited on log out 'Hello World!' 510 ms\n----\n\nThis is similar output when running the Java application using `java` CLI or the Docker container using `docker container run` command.\n\nThe container is running in the foreground. Use `Ctrl` + `C` to interrupt the container and return back to terminal.\n\nOnly one change was required in the project to enable Docker packaging and running. A Maven profile is added in `pom.xml`:\n\n[source, text]\n----\n\n \n docker\n \n \n \n io.fabric8\n docker-maven-plugin\n 0.22.1\n \n \n \n hello-java\n \n openjdk:latest\n \n artifact\n \n java -cp maven/${project.name}-${project.version}.jar org.examples.java.App\n \n \n \n Hello World!\n \n \n \n \n \n \n \n docker:build\n package\n \n build\n \n \n \n docker:start\n install\n \n start\n logs\n \n \n \n \n \n \n \n\n----\n\n== Dockerfile Command Design Patterns\n\n=== Difference between CMD and ENTRYPOINT\n\n*TL;DR* `CMD` will work for most of the cases.\n\nDefault entry point for a container is `/bin/sh`, the default shell.\n\nRunning a container as `docker container run -it ubuntu` uses that command and starts the default shell. The output is shown as:\n\n```console\n> docker container run -it ubuntu\nroot@88976ddee107:/#\n```\n\n`ENTRYPOINT` allows to override the entry point to some other command, and even customize it. For example, a container can be started as:\n\n```console\n> docker container run -it --entrypoint=/bin/cat ubuntu /etc/passwd\nroot:x:0:0:root:/root:/bin/bash\ndaemon:x:1:1:daemon:/usr/sbin:/usr/sbin/nologin\nbin:x:2:2:bin:/bin:/usr/sbin/nologin\nsys:x:3:3:sys:/dev:/usr/sbin/nologin\n. . .\n```\n\nThis command overrides the entry point to the container to `/bin/cat`. The argument(s) passed to the CLI are used by the entry point.\n\n=== Difference between ADD and COPY\n\n*TL;DR* `COPY` will work for most of the cases.\n\n`ADD` has all capabilities of `COPY` and has the following additional features:\n\n. Allows tar file auto-extraction in the image, for example, `ADD app.tar.gz /opt/var/myapp`.\n. Allows files to be downloaded from a remote URL. However, the downloaded files will become part of the image. This causes the image size to bloat. So its recommended to use `curl` or `wget` to download the archive explicitly, extract, and remove the archive.\n\n=== Import and export images\n\nDocker images can be saved using `image save` command to a `.tar` file:\n\n docker image save helloworld > helloworld.tar\n\nThese tar files can then be imported using `load` command:\n\n docker image load -i helloworld.tar\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch04-run-container.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n= Run a Docker Container\n\nThe first step in running an application using Docker is to run a container. If you can think of an open source software, there is a very high likelihood that there will be a Docker image available for it at https://store.docker.com[Docker Store]. Docker client can simply run the container by giving the image name. The client will check if the image already exists on Docker Host. If it exists then it'll run the container, otherwise the host will first download the image.\n\n== Pull Image\n\nLet's check if any images are available:\n\n[source, text]\n----\ndocker image ls\n----\n\nAt first, this list is empty. If you've already downloaded the images as specified in the setup chapter, then all the images will be shown here. \n\nList of images can be seen again using the `docker image ls` command. This will show the following output:\n\n[source, text]\n----\nREPOSITORY TAG IMAGE ID CREATED SIZE\nhellojava latest 8d76bf5691c4 32 minutes ago 740MB\nhello-java latest 93b1180c5d91 36 minutes ago 740MB\nhelloworld 2 7fbedda27c66 41 minutes ago 1.13MB\nhelloworld latest e61f88f3a0f7 About an hour ago 122MB\nmysql latest b4e78b89bcf3 3 days ago 412MB\nubuntu latest 2d696327ab2e 4 days ago 122MB\njboss/wildfly latest 9adbdb00cded 8 days ago 592MB\nopenjdk latest 6077adce18ea 8 days ago 740MB\nbusybox latest 54511612f1c4 9 days ago 1.13MB\ntailtarget/hadoop 2.7.2 ee6b539c886e 6 months ago 1.15GB\ntailtarget/jenkins 2.32.3 71a7d9bcfe2b 6 months ago 859MB\narungupta/couchbase travel 7929a80707db 7 months ago 583MB\narungupta/couchbase-javaee travel 2bb52abaad5f 7 months ago 595MB\narungupta/javaee7-hol latest da5c9d4f85ca 2 years ago 582MB\n----\n\nMore details about the image can be obtained using `docker image history jboss/wildfly` command:\n\n[source, text]\n----\nIMAGE CREATED CREATED BY SIZE COMMENT\n9adbdb00cded 8 days ago /bin/sh -c #(nop) CMD [\"/opt/jboss/wildfl... 0B \n 8 days ago /bin/sh -c #(nop) EXPOSE 8080/tcp 0B \n 8 days ago /bin/sh -c #(nop) USER [jboss] 0B \n 8 days ago /bin/sh -c #(nop) ENV LAUNCH_JBOSS_IN_BAC... 0B \n 8 days ago /bin/sh -c cd $HOME && curl -O https:/... 163MB \n 8 days ago /bin/sh -c #(nop) USER [root] 0B \n 8 days ago /bin/sh -c #(nop) ENV JBOSS_HOME=/opt/jbo... 0B \n 8 days ago /bin/sh -c #(nop) ENV WILDFLY_SHA1=9ee3c0... 0B \n 8 days ago /bin/sh -c #(nop) ENV WILDFLY_VERSION=10.... 0B \n 8 days ago /bin/sh -c #(nop) ENV JAVA_HOME=/usr/lib/... 0B \n 8 days ago /bin/sh -c #(nop) USER [jboss] 0B \n 8 days ago /bin/sh -c yum -y install java-1.8.0-openj... 204MB \n 8 days ago /bin/sh -c #(nop) USER [root] 0B \n 8 days ago /bin/sh -c #(nop) MAINTAINER Marek Goldma... 0B \n 8 days ago /bin/sh -c #(nop) USER [jboss] 0B \n 8 days ago /bin/sh -c #(nop) WORKDIR /opt/jboss 0B \n 8 days ago /bin/sh -c groupadd -r jboss -g 1000 && us... 296kB \n 8 days ago /bin/sh -c yum update -y && yum -y install... 28.7MB \n 8 days ago /bin/sh -c #(nop) MAINTAINER Marek Goldma... 0B \n 8 days ago /bin/sh -c #(nop) CMD [\"/bin/bash\"] 0B \n 8 days ago /bin/sh -c #(nop) LABEL name=CentOS Base ... 0B \n 8 days ago /bin/sh -c #(nop) ADD file:1ed4d1a29d09a63... 197MB \n----\n\n== Run Container\n\n=== Interactively\n\nRun WildFly container in an interactive mode.\n\n[source, text]\n----\ndocker container run -it jboss/wildfly\n----\n\nThis will show the output as:\n\n[source, text]\n----\n=========================================================================\n\n JBoss Bootstrap Environment\n\n JBOSS_HOME: /opt/jboss/wildfly\n\n JAVA: /usr/lib/jvm/java/bin/java\n\n. . .\n\n00:26:27,455 INFO [org.jboss.as] (Controller Boot Thread) WFLYSRV0060: Http management interface listening on http://127.0.0.1:9990/management\n00:26:27,456 INFO [org.jboss.as] (Controller Boot Thread) WFLYSRV0051: Admin console listening on http://127.0.0.1:9990\n00:26:27,457 INFO [org.jboss.as] (Controller Boot Thread) WFLYSRV0025: WildFly Full 10.1.0.Final (WildFly Core 2.2.0.Final) started in 3796ms - Started 331 of 577 services (393 services are lazy, passive or on-demand)\n----\n\nThis shows that the server started correctly, congratulations!\n\nBy default, Docker runs in the foreground. `-i` allows to interact with the STDIN and `-t` attach a TTY to the process. Switches can be combined together and used as `-it`.\n\nHit Ctrl+C to stop the container.\n\n=== Detached container\n\nRestart the container in detached mode:\n\n[source, text]\n----\ndocker container run -d jboss/wildfly\n254418caddb1e260e8489f872f51af4422bc4801d17746967d9777f565714600\n----\n\n`-d`, instead of `-it`, runs the container in detached mode.\n\nThe output is the unique id assigned to the container. Logs of the container can be seen using the command `docker container logs `, where `` is the id of the container.\n\nStatus of the container can be checked using the `docker container ls` command:\n\n[source, text]\n----\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n254418caddb1 jboss/wildfly \"/opt/jboss/wildfl...\" 2 minutes ago Up 2 minutes 8080/tcp gifted_haibt\n----\n\nAlso try `docker container ls -a` to see all the containers on this machine.\n\n=== With default port\n\nIf you want the container to accept incoming connections, you will need to provide special options when invoking `docker run`. The container, we just started, can't be accessed by our browser. We need to stop it again and restart with different options.\n\n[source, text]\n----\ndocker container stop `docker container ps | grep wildfly | awk '{print $1}'`\n----\n\nRestart the container as:\n\n[source, text]\n----\ndocker container run -d -P --name wildfly jboss/wildfly\n----\n\n`-P` map any exposed ports inside the image to a random port on Docker host. In addition, `--name` option is used to give this container a name. This name can then later be used to get more details about the container or stop it. This can be verified using `docker container ls` command:\n\n[source, text]\n----\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n89fbfbceeb56 jboss/wildfly \"/opt/jboss/wildfl...\" 9 seconds ago Up 8 seconds 0.0.0.0:32768->8080/tcp wildfly\n----\n\nThe port mapping is shown in the `PORTS` column. Access WildFly server at http://localhost:32768. Make sure to use the correct port number as shown in your case.\n\nNOTE: Exact port number may be different in your case.\n\nThe page would look like:\n\nimage::wildfly-first-run-default-page.png[]\n\n=== With specified port\n\nStop and remove the previously running container as:\n\n[source, text]\n----\ndocker container stop wildfly\ndocker container rm wildfly\n----\n\nAlternatively, `docker container rm -f wildfly` can be used to stop and remove the container in one command. Be careful with this command because `-f` uses `SIGKILL` to kill the container.\n\nRestart the container as:\n\n[source, text]\n----\ndocker container run -d -p 8080:8080 --name wildfly jboss/wildfly\n----\n\nThe format is `-p hostPort:containerPort`. This option maps a port on the host to a port in the container. This allows us to access the container on the specified port on the host.\n\nNow we're ready to test http://localhost:8080. This works with the exposed port, as expected.\n\nLet's stop and remove the container as:\n\n[source, text]\n----\ndocker container stop wildfly\ndocker container rm wildfly\n----\n\n=== Deploy a WAR file to application server\n\nNow that your application server is running, lets see how to deploy a WAR file to it.\n\nCreate a new directory `hellojavaee`. Create a new text file and name it `Dockerfile`. Use the following contents:\n\n[source, text]\n----\nFROM jboss/wildfly:latest\n\nRUN curl -L https://github.com/javaee-samples/javaee7-simple-sample/releases/download/v1.10/javaee7-simple-sample-1.10.war -o /opt/jboss/wildfly/standalone/deployments/javaee-simple-sample.war\n----\n\nCreate an image:\n\n[source, text]\n----\ndocker image build -t javaee-sample .\n----\n\nStart the container:\n\n[source, text]\n----\ndocker container run -d -p 8080:8080 --name wildfly javaee-sample\n----\n\nAccess the endpoint:\n\n[source, text]\n----\ncurl http://localhost:8080/javaee-simple-sample/resources/persons\n----\n\nSee the output:\n\n[source, text]\n----\n\n\t\n\t\t\n\t\tPenny\n\t\t\n\t\n\t\n\t\t\n\t\tLeonard\n\t\t\n\t\n\t\n\t\t\n\t\tSheldon\n\t\t\n\t\n\t\n\t\t\n\t\tAmy\n\t\t\n\t\n\t\n\t\t\n\t\tHoward\n\t\t\n\t\n\t\n\t\t\n\t\tBernadette\n\t\t\n\t\n\t\n\t\t\n\t\tRaj\n\t\t\n\t\n\t\n\t\t\n\t\tPriya\n\t\t\n\t\n\n----\n\nOptional: `brew install XML-Coreutils` will install XML formatting utility on Mac. This output can then be piped to `xml-fmt` to display a formatted result.\n\n== Stop container\n\nStop a specific container by id or name:\n\n[source, text]\n----\ndocker container stop \ndocker container stop \n----\n\nStop all running containers:\n\n[source, text]\n----\ndocker container stop $(docker container ps -q)\n----\n\nStop only the exited containers:\n\n[source, text]\n----\ndocker container ps -a -f \"exited=-1\"\n----\n\n== Remove container\n\nRemove a specific container by id or name:\n\n[source, text]\n----\ndocker container rm \ndocker container rm \n----\n\nRemove containers meeting a regular expression\n\n[source, text]\n----\ndocker container ps -a | grep wildfly | awk '{print $1}' | xargs docker container rm\n----\n\nRemove all containers, without any criteria\n\n[source, text]\n----\ndocker container rm $(docker container ps -aq)\n----\n\n== Additional ways to find port mapping\n\nThe exact mapped port can also be found using `docker port` command:\n\n[source, text]\n----\ndocker container port or \n----\n\nThis shows the output as:\n\n[source, text]\n----\n8080/tcp -> 0.0.0.0:8080\n----\n\nPort mapping can be also be found using `docker inspect` command:\n\n[source, text]\n----\ndocker container inspect --format='{{(index (index .NetworkSettings.Ports \"8080/tcp\") 0).HostPort}}' \n----\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch05-compose.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n[[Docker_Compose]]\n= Multi-container application using Docker Compose\n\n== What is Docker Compose\n\n[quote, github.com/docker/compose]\nDocker Compose is a tool for defining and running complex applications with Docker. With Compose, you define a multi-container application in a single file, then spin your application up in a single command which does everything that needs to be done to get it running.\n\nAn application using Docker containers will typically consist of multiple containers. With Docker Compose, there is no need to write shell scripts to start your containers. All the containers are defined in a configuration file using _services_, and then `docker-compose` script is used to start, stop, and restart the application and all the services in that application, and all the containers within that service. The complete list of commands is:\n\n[options=\"header\"]\n|====\n| Command | Purpose\n| `build` | Build or rebuild services\n| `help` | Get help on a command\n| `kill` | Kill containers\n| `logs` | View output from containers\n| `port` | Print the public port for a port binding\n| `ps` | List containers\n| `pull` | Pulls service images\n| `restart` | Restart services\n| `rm` | Remove stopped containers\n| `run` | Run a one-off command\n| `scale` | Set number of containers for a service\n| `start` | Start services\n| `stop` | Stop services\n| `up` | Create and start containers\n| `migrate-to-labels Recreate containers to add labels\n|====\n\nThe application used in this section is a Java EE application talking to a database. The application publishes a REST endpoint that can be invoked using `curl. It is deployed using http://wildfly-swarm.io/[WildFly Swarm] that communicates to MySQL database.\n\nWildFly Swarm and MySQL will be running in two separate containers, and thus making this a multi-container application.\n\n== Configuration file\n\nTh entry point to Docker Compose is a Compose file, usually called `docker-compose.yml`. Create a new directory `javaee`. In that directory, create a new file `docker-compose.yml` in it. Use the following contents:\n\n```\nversion: '3.3'\nservices:\n db:\n container_name: db\n image: mysql:8\n environment:\n MYSQL_DATABASE: employees\n MYSQL_USER: mysql\n MYSQL_PASSWORD: mysql\n MYSQL_ROOT_PASSWORD: supersecret\n ports:\n - 3306:3306\n web:\n image: arungupta/docker-javaee:dockerconeu17\n ports:\n - 8080:8080\n - 9990:9990\n depends_on:\n - db\n```\n\nIn this Compose file:\n\n. Two services in this Compose are defined by the name `db` and `web` attributes\n. Image name for each service defined using `image` attribute\n. The `mysql:8` image starts the MySQL server.\n. `environment` attribute defines environment variables to initialize MySQL server.\n.. `MYSQL_DATABASE` allows you to specify the name of a database to be created on image startup.\n.. `MYSQL_USER` and `MYSQL_PASSWORD` are used in conjunction to create a new user and to set that user's password. This user will be granted superuser permissions for the database specified by the `MYSQL_DATABASE` variable.\n.. `MYSQL_ROOT_PASSWORD` is mandatory and specifies the password that will be set for the MySQL root superuser account.\n. Java EE application uses the `db` service as specified in the `connection-url` as specified at https://github.com/arun-gupta/docker-javaee/blob/master/employees/src/main/resources/project-defaults.yml/.\n. The `arungupta/docker-javaee:dockerconeu17` image starts WildFly Swarm application server. It consists of the Java EE application built from https://github.com/arun-gupta/docker-javaee. Clone that project if you want to build your own image.\n. Port forwarding is achieved using `ports` attribute.\n. `depends_on` attribute allows to express dependency between services. In this case, MySQL will be started before WildFly. Application-level health check are still user's responsibility.\n\n== Start application\n\nAll services in the application can be started, in detached mode, by giving the command:\n\n```\ndocker-compose up -d\n```\n\nAn alternate Compose file name can be specified using `-f` option.\n\nAn alternate directory where the compose file exists can be specified using `-p` option.\n\nThis shows the output as:\n\n```\ndocker-compose up -d\nCreating network \"javaee_default\" with the default driver\nCreating db ... \nCreating db ... done\nCreating javaee_web_1 ... \nCreating javaee_web_1 ... done\n```\n\nThe output may differ slightly if the images are downloaded as well.\n\nStarted services can be verified using the command `docker-compose ps`:\n\n```\n Name Command State Ports \n------------------------------------------------------------------------------------------------------\ndb docker-entrypoint.sh mysqld Up 0.0.0.0:3306->3306/tcp \njavaee_web_1 /bin/sh -c java -jar /opt/ ... Up 0.0.0.0:8080->8080/tcp, 0.0.0.0:9990->9990/tcp\n```\n\nThis provides a consolidated view of all the services, and containers within each of them.\n\nAlternatively, the containers in this application, and any additional containers running on this Docker host can be verified by using the usual `docker container ls` command:\n\n```\n Name Command State Ports \n------------------------------------------------------------------------------------------------------\ndb docker-entrypoint.sh mysqld Up 0.0.0.0:3306->3306/tcp \njavaee_web_1 /bin/sh -c java -jar /opt/ ... Up 0.0.0.0:8080->8080/tcp, 0.0.0.0:9990->9990/tcp\njavaee $ docker container ls\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\ne862a5eb9484 arungupta/docker-javaee:dockerconeu17 \"/bin/sh -c 'java ...\" 38 seconds ago Up 36 seconds 0.0.0.0:8080->8080/tcp, 0.0.0.0:9990->9990/tcp javaee_web_1\n08792c20c066 mysql:8 \"docker-entrypoint...\" 39 seconds ago Up 37 seconds 0.0.0.0:3306->3306/tcp db\n```\n\nService logs can be seen using `docker-compose logs` command, and looks like:\n\n[source, text]\n----\nAttaching to dockerjavaee_web_1, db\nweb_1 | 23:54:21,584 INFO [org.jboss.msc] (main) JBoss MSC version 1.2.6.Final\nweb_1 | 23:54:21,688 INFO [org.jboss.as] (MSC service thread 1-8) WFLYSRV0049: WildFly Core 2.0.10.Final \"Kenny\" starting\nweb_1 | 2017-10-06 23:54:22,687 INFO [org.wildfly.extension.io] (ServerService Thread Pool -- 20) WFLYIO001: Worker 'default' has auto-configured to 8 core threads with 64 task threads based on your 4 available processors\n\n. . .\n\nweb_1 | 2017-10-06 23:54:23,259 INFO [org.jboss.as.connector.subsystems.datasources] (MSC service thread 1-3) WFLYJCA0001: Bound data source [java:jboss/datasources/ExampleDS]\nweb_1 | 2017-10-06 23:54:24,962 INFO [org.jboss.as] (Controller Boot Thread) WFLYSRV0025: WildFly Core 2.0.10.Final \"Kenny\" started in 3406ms - Started 112 of 124 services (21 services are lazy, passive or on-demand)\nweb_1 | 2017-10-06 23:54:25,020 INFO [org.wildfly.extension.undertow] (MSC service thread 1-4) WFLYUT0006: Undertow HTTP listener default listening on 0.0.0.0:8080\nweb_1 | 2017-10-06 23:54:26,146 INFO [org.wildfly.swarm.runtime.deployer] (main) deploying docker-javaee.war\nweb_1 | 2017-10-06 23:54:26,169 INFO [org.jboss.as.server.deployment] (MSC service thread 1-3) WFLYSRV0027: Starting deployment of \"docker-javaee.war\" (runtime-name: \"docker-javaee.war\")\nweb_1 | 2017-10-06 23:54:27,748 INFO [org.jboss.as.jpa] (MSC service thread 1-2) WFLYJPA0002: Read persistence.xml for MyPU\nweb_1 | 2017-10-06 23:54:27,887 WARN [org.jboss.as.dependency.private] (MSC service thread 1-7) WFLYSRV0018: Deployment \"deployment.docker-javaee.war\" is using a private module (\"org.jboss.jts:main\") which may be changed or removed in future versions without notice.\n\n. . .\n\nweb_1 | 2017-10-06 23:54:29,128 INFO [stdout] (ServerService Thread Pool -- 4) Hibernate: create table EMPLOYEE_SCHEMA (id integer not null, name varchar(40), primary key (id))\nweb_1 | 2017-10-06 23:54:29,132 INFO [stdout] (ServerService Thread Pool -- 4) Hibernate: INSERT INTO EMPLOYEE_SCHEMA(ID, NAME) VALUES (1, 'Penny')\nweb_1 | 2017-10-06 23:54:29,133 INFO [stdout] (ServerService Thread Pool -- 4) Hibernate: INSERT INTO EMPLOYEE_SCHEMA(ID, NAME) VALUES (2, 'Sheldon')\nweb_1 | 2017-10-06 23:54:29,133 INFO [stdout] (ServerService Thread Pool -- 4) Hibernate: INSERT INTO EMPLOYEE_SCHEMA(ID, NAME) VALUES (3, 'Amy')\nweb_1 | 2017-10-06 23:54:29,133 INFO [stdout] (ServerService Thread Pool -- 4) Hibernate: INSERT INTO EMPLOYEE_SCHEMA(ID, NAME) VALUES (4, 'Leonard')\n\n. . .\n\nweb_1 | 2017-10-06 23:54:30,050 INFO [org.wildfly.extension.undertow] (ServerService Thread Pool -- 4) WFLYUT0021: Registered web context: /\nweb_1 | 2017-10-06 23:54:30,518 INFO [org.jboss.as.server] (main) WFLYSRV0010: Deployed \"docker-javaee.war\" (runtime-name : \"docker-javaee.war\")\nweb_1 | 2017-10-06 23:56:01,766 INFO [stdout] (default task-1) Hibernate: select employee0_.id as id1_0_, employee0_.name as name2_0_ from EMPLOYEE_SCHEMA employee0_\ndb | Initializing database\n\n. . .\n\ndb | \ndb | \ndb | MySQL init process done. Ready for start up.\ndb | \n\n. . .\n\ndb | 2017-10-06T23:54:29.434423Z 0 [Note] /usr/sbin/mysqld: ready for connections. Version: '8.0.3-rc-log' socket: '/var/run/mysqld/mysqld.sock' port: 3306 MySQL Community Server (GPL)\ndb | 2017-10-06T23:54:30.281973Z 0 [Note] InnoDB: Buffer pool(s) load completed at 171006 23:54:30\n----\n\n`depends_on` attribute in the Compose definition file ensures the container start up order. But application-level start up needs to be ensured by the applications running inside container. In our case, this can be achieved by WildFly Swarm using `swarm.datasources.data-sources.KEY.stale-connection-checker-class-name` as defined at https://reference.wildfly-swarm.io/fractions/datasources.html.\n\n== Verify application\n\nNow that the WildFly Swarm and MySQL have been configured, let's access the application. You need to specify IP address of the host where WildFly is running (`localhost` in our case).\n\nThe endpoint can be accessed in this case as:\n\n curl -v http://localhost:8080/resources/employees\n\nThe output is shown as:\n\n```\ncurl -v http://localhost:8080/resources/employees\n* Trying ::1...\n* TCP_NODELAY set\n* Connected to localhost (::1) port 8080 (#0)\n> GET /resources/employees HTTP/1.1\n> Host: localhost:8080\n> User-Agent: curl/7.51.0\n> Accept: */*\n> \n< HTTP/1.1 200 OK\n< Connection: keep-alive\n< Content-Type: application/xml\n< Content-Length: 478\n< Date: Sat, 07 Oct 2017 00:05:41 GMT\n< \n* Curl_http_done: called premature == 0\n* Connection #0 to host localhost left intact\n1Penny2Sheldon3Amy4Leonard5Bernadette6Raj7Howard8Priya\n```\n\nThis shows the result from querying the database.\n\nA single resource can be obtained:\n\n curl -v http://localhost:8080/resources/employees/1\n\nIt shows the output:\n\n```\ncurl -v http://localhost:8080/resources/employees/1\n* Trying ::1...\n* TCP_NODELAY set\n* Connected to localhost (::1) port 8080 (#0)\n> GET /resources/employees/1 HTTP/1.1\n> Host: localhost:8080\n> User-Agent: curl/7.51.0\n> Accept: */*\n> \n< HTTP/1.1 200 OK\n< Connection: keep-alive\n< Content-Type: application/xml\n< Content-Length: 104\n< Date: Sat, 07 Oct 2017 00:06:33 GMT\n< \n* Curl_http_done: called premature == 0\n* Connection #0 to host localhost left intact\n1Penny\n```\n\n== Shutdown application\n\nShutdown the application using `docker-compose down`:\n\n```\nStopping javaee_web_1 ... done\nStopping db ... done\nRemoving javaee_web_1 ... done\nRemoving db ... done\nRemoving network javaee_default\n```\n\nThis stops the container in each service and removes all the services. It also deletes any networks that were created as part of this application.\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch06-swarm.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n[[Swarm_Mode]]\n= Deploy application using Swarm mode\n\nDocker Engine includes swarm mode for natively managing a cluster of Docker Engines. The Docker CLI can be used to create a swarm, deploy application services to a swarm, and manage swarm behavior. Complete details are available at: https://docs.docker.com/engine/swarm/. It's important to understand the https://docs.docker.com/engine/swarm/key-concepts/[Swarm mode key concepts] before starting with this chapter.\n\nSwarm is typically a cluster of multiple Docker Engines. But for simplicity we'll run a single node Swarm.\n\nThis section will deploy an application that will provide a CRUD/REST interface on a data bucket in https://www.mysql.com/[MySQL]. This is achieved by using a Java EE application deployed on http://wildfly.org[WildFly] to access the database.\n\n== Initialize Swarm\n\nInitialize Swarm mode using the following command:\n\n docker swarm init\n\nThis starts a Swarm Manager. By default, a manager node is also a worker but can be configured to be a manager-only.\n\nFind some information about this one-node cluster using the command `docker info`\n\n```\nContainers: 0\n Running: 0\n Paused: 0\n Stopped: 0\nImages: 17\nServer Version: 17.09.0-ce\nStorage Driver: overlay2\n Backing Filesystem: extfs\n Supports d_type: true\n Native Overlay Diff: true\nLogging Driver: json-file\nCgroup Driver: cgroupfs\nPlugins:\n Volume: local\n Network: bridge host ipvlan macvlan null overlay\n Log: awslogs fluentd gcplogs gelf journald json-file logentries splunk syslog\nSwarm: active\n NodeID: p9a1tqcjh58ro9ucgtqxa2wgq\n Is Manager: true\n ClusterID: r3xdxly8zv82e4kg38krd0vog\n Managers: 1\n Nodes: 1\n Orchestration:\n Task History Retention Limit: 5\n Raft:\n Snapshot Interval: 10000\n Number of Old Snapshots to Retain: 0\n Heartbeat Tick: 1\n Election Tick: 3\n Dispatcher:\n Heartbeat Period: 5 seconds\n CA Configuration:\n Expiry Duration: 3 months\n Force Rotate: 0\n Autolock Managers: false\n Root Rotation In Progress: false\n Node Address: 192.168.65.2\n Manager Addresses:\n 192.168.65.2:2377\nRuntimes: runc\nDefault Runtime: runc\nInit Binary: docker-init\ncontainerd version: 06b9cb35161009dcb7123345749fef02f7cea8e0\nrunc version: 3f2f8b84a77f73d38244dd690525642a72156c64\ninit version: 949e6fa\nSecurity Options:\n seccomp\n Profile: default\nKernel Version: 4.9.49-moby\nOperating System: Alpine Linux v3.5\nOSType: linux\nArchitecture: x86_64\nCPUs: 4\nTotal Memory: 1.952GiB\nName: moby\nID: TJSZ:O44Y:PWGZ:ZWZM:SA73:2UHI:VVKV:KLAH:5NPO:AXQZ:XWZD:6IRJ\nDocker Root Dir: /var/lib/docker\nDebug Mode (client): false\nDebug Mode (server): true\n File Descriptors: 35\n Goroutines: 142\n System Time: 2017-10-05T20:57:14.037442426Z\n EventsListeners: 1\nRegistry: https://index.docker.io/v1/\nExperimental: true\nInsecure Registries:\n 127.0.0.0/8\nLive Restore Enabled: false\n```\n\nThis cluster has 1 node, and that is a manager. By default, the manager node is also a worker node. This means the containers can run on this node.\n\n== Multi-container application\n\nThis section describes how to deploy a multi-container application using Docker Compose to Swarm mode use Docker CLI. \n\nCreate a new directory and `cd` to it:\n\n mkdir webapp\n cd webapp\n\nCreate a new Compose definition `docker-compose.yml` using this link:ch05-compose.adoc#configuration-file[ configuration file].\n\nThis application can be started as:\n\n docker stack deploy --compose-file=docker-compose.yml webapp\n\nThis shows the output as:\n\n```\nIgnoring deprecated options:\n\ncontainer_name: Setting the container name is not supported.\n\nCreating network webapp_default\nCreating service webapp_db\nCreating service webapp_web\n```\n\nWildFly Swarm and MySQL services are started on this node. Each service has a single container. If the Swarm mode is enabled on multiple nodes then the containers will be distributed across them.\n\nA new overlay network is created. This can be verified using the command `docker network ls`. This network allows multiple containers on different hosts to communicate with each other.\n\n== Verify service and containers in application\n\nVerify that the WildFly and MySQL services are running using `docker service ls`:\n\n```\nID NAME MODE REPLICAS IMAGE PORTS\nj21lwelj529f webapp_db replicated 1/1 mysql:8 *:3306->3306/tcp\nm0m44axt35cg webapp_web replicated 1/1 arungupta/docker-javaee:dockerconeu17 *:8080->8080/tcp,*:9990->9990/tcp\n```\n\nMore details about the service can be obtained using `docker service inspect webapp_web`:\n\n[source, yml]\n----\n[\n {\n \"ID\": \"m0m44axt35cgjetcjwzls7u9r\",\n \"Version\": {\n \"Index\": 22\n },\n \"CreatedAt\": \"2017-10-07T00:17:44.038961419Z\",\n \"UpdatedAt\": \"2017-10-07T00:17:44.040746062Z\",\n \"Spec\": {\n \"Name\": \"webapp_web\",\n \"Labels\": {\n \"com.docker.stack.image\": \"arungupta/docker-javaee:dockerconeu17\",\n \"com.docker.stack.namespace\": \"webapp\"\n },\n \"TaskTemplate\": {\n \"ContainerSpec\": {\n \"Image\": \"arungupta/docker-javaee:dockerconeu17@sha256:6a403c35d2ab4442f029849207068eadd8180c67e2166478bc3294adbf578251\",\n \"Labels\": {\n \"com.docker.stack.namespace\": \"webapp\"\n },\n \"Privileges\": {\n \"CredentialSpec\": null,\n \"SELinuxContext\": null\n },\n \"StopGracePeriod\": 10000000000,\n \"DNSConfig\": {}\n },\n \"Resources\": {},\n \"RestartPolicy\": {\n \"Condition\": \"any\",\n \"Delay\": 5000000000,\n \"MaxAttempts\": 0\n },\n \"Placement\": {\n \"Platforms\": [\n {\n \"Architecture\": \"amd64\",\n \"OS\": \"linux\"\n }\n ]\n },\n \"Networks\": [\n {\n \"Target\": \"bwnp1nvkkga68dirhp1ue7qey\",\n \"Aliases\": [\n \"web\"\n ]\n }\n ],\n \"ForceUpdate\": 0,\n \"Runtime\": \"container\"\n },\n \"Mode\": {\n \"Replicated\": {\n \"Replicas\": 1\n }\n },\n \"UpdateConfig\": {\n \"Parallelism\": 1,\n \"FailureAction\": \"pause\",\n \"Monitor\": 5000000000,\n \"MaxFailureRatio\": 0,\n \"Order\": \"stop-first\"\n },\n \"RollbackConfig\": {\n \"Parallelism\": 1,\n \"FailureAction\": \"pause\",\n \"Monitor\": 5000000000,\n \"MaxFailureRatio\": 0,\n \"Order\": \"stop-first\"\n },\n \"EndpointSpec\": {\n \"Mode\": \"vip\",\n \"Ports\": [\n {\n \"Protocol\": \"tcp\",\n \"TargetPort\": 8080,\n \"PublishedPort\": 8080,\n \"PublishMode\": \"ingress\"\n },\n {\n \"Protocol\": \"tcp\",\n \"TargetPort\": 9990,\n \"PublishedPort\": 9990,\n \"PublishMode\": \"ingress\"\n }\n ]\n }\n },\n \"Endpoint\": {\n \"Spec\": {\n \"Mode\": \"vip\",\n \"Ports\": [\n {\n \"Protocol\": \"tcp\",\n \"TargetPort\": 8080,\n \"PublishedPort\": 8080,\n \"PublishMode\": \"ingress\"\n },\n {\n \"Protocol\": \"tcp\",\n \"TargetPort\": 9990,\n \"PublishedPort\": 9990,\n \"PublishMode\": \"ingress\"\n }\n ]\n },\n \"Ports\": [\n {\n \"Protocol\": \"tcp\",\n \"TargetPort\": 8080,\n \"PublishedPort\": 8080,\n \"PublishMode\": \"ingress\"\n },\n {\n \"Protocol\": \"tcp\",\n \"TargetPort\": 9990,\n \"PublishedPort\": 9990,\n \"PublishMode\": \"ingress\"\n }\n ],\n \"VirtualIPs\": [\n {\n \"NetworkID\": \"vysfza7wgjepdlutuwuigbws1\",\n \"Addr\": \"10.255.0.5/16\"\n },\n {\n \"NetworkID\": \"bwnp1nvkkga68dirhp1ue7qey\",\n \"Addr\": \"10.0.0.4/24\"\n }\n ]\n }\n }\n]\n----\n\nLogs for the service can be seen using `docker service logs -f webapp_web`:\n\n```\nwebapp_web.1.lf3y5k7pkpt9@moby | 00:17:47,296 INFO [org.jboss.msc] (main) JBoss MSC version 1.2.6.Final\nwebapp_web.1.lf3y5k7pkpt9@moby | 00:17:47,404 INFO [org.jboss.as] (MSC service thread 1-8) WFLYSRV0049: WildFly Core 2.0.10.Final \"Kenny\" starting\nwebapp_web.1.lf3y5k7pkpt9@moby | 2017-10-07 00:17:48,636 INFO [org.wildfly.extension.io] (ServerService Thread Pool -- 20) WFLYIO001: Worker 'default' has auto-configured to 8 core threads with 64 task threads based on your 4 available processors\n\n. . .\n\nwebapp_web.1.lf3y5k7pkpt9@moby | 2017-10-07 00:17:56,619 INFO [org.jboss.resteasy.resteasy_jaxrs.i18n] (ServerService Thread Pool -- 12) RESTEASY002225: Deploying javax.ws.rs.core.Application: class org.javaee.samples.employees.MyApplication\nwebapp_web.1.lf3y5k7pkpt9@moby | 2017-10-07 00:17:56,621 WARN [org.jboss.as.weld] (ServerService Thread Pool -- 12) WFLYWELD0052: Using deployment classloader to load proxy classes for module com.fasterxml.jackson.jaxrs.jackson-jaxrs-json-provider:main. Package-private access will not work. To fix this the module should declare dependencies on [org.jboss.weld.core, org.jboss.weld.spi]\nwebapp_web.1.lf3y5k7pkpt9@moby | 2017-10-07 00:17:56,682 INFO [org.wildfly.extension.undertow] (ServerService Thread Pool -- 12) WFLYUT0021: Registered web context: /\nwebapp_web.1.lf3y5k7pkpt9@moby | 2017-10-07 00:17:57,094 INFO [org.jboss.as.server] (main) WFLYSRV0010: Deployed \"docker-javaee.war\" (runtime-name : \"docker-javaee.war\")\n```\n\nMake sure to wait for the last log statement to show.\n\n== Access application\n\nNow that the WildFly and MySQL servers have been configured, let's access the application. You need to specify IP address of the host where WildFly is running (`localhost` in our case).\n\nThe endpoint can be accessed in this case as:\n\n curl -v http://localhost:8080/resources/employees\n\nThe output is shown as:\n\n```\n* Trying ::1...\n* TCP_NODELAY set\n* Connected to localhost (::1) port 8080 (#0)\n> GET /resources/employees HTTP/1.1\n> Host: localhost:8080\n> User-Agent: curl/7.51.0\n> Accept: */*\n> \n< HTTP/1.1 200 OK\n< Connection: keep-alive\n< Content-Type: application/xml\n< Content-Length: 478\n< Date: Sat, 07 Oct 2017 00:22:59 GMT\n< \n* Curl_http_done: called premature == 0\n* Connection #0 to host localhost left intact\n1Penny2Sheldon3Amy4Leonard5Bernadette6Raj7Howard8Priya\n```\n\nThis shows all employees stored in the database.\n\n== Stop application\n\nIf you only want to stop the application temporarily while keeping any networks that were created as part of this application, the recommended way is to set the amount of service replicas to 0.\n\n docker service scale webapp_db=0 webapp_web=0\n\nIt shows the output:\n\n```\nwebapp_db scaled to 0\nwebapp_web scaled to 0\nSince --detach=false was not specified, tasks will be scaled in the background.\nIn a future release, --detach=false will become the default.\n```\n\nThis is especially useful if the stack contains volumes and you want to keep the data. It allows you to simply start the stack again with setting the replicas to a number higher than 0.\n\n== Remove application completely\n\nShutdown the application using `docker stack rm webapp`:\n\n```\nRemoving service webapp_db\nRemoving service webapp_web\nRemoving network webapp_default\n```\n\nThis stops the container in each service and removes the services. It also deletes any networks that were created as part of this application.\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch07-eclipse.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n[[Docker_Eclipse]]\n== Docker and Eclipse\n\nThis chapter will show you basic Docker tooling with Eclipse:\n\n- Pull/Push/Build Docker images\n- Run/Start/Stop/Kill Docker containers\n- Customize views\n\nWatch a quick video explaining the key steps in https://www.youtube.com/watch?v=XmhEZiS26os.\n\n=== Install Docker Tooling in Eclipse\n\nDownload http://www.eclipse.org/downloads/eclipse-packages/[Eclipse IDE for Java EE Developers] and install.\n\nGo to \"`Help`\" menu, \"`Install New Software...`\".\n\nSelect Eclipse update site for the release, search for Docker, select \"`Docker Tooling`\".\n\nimage::docker-eclipse-update-site-selection.png[]\n\nClick on \"`Next>`\", \"`Next>`\", accept the license agreement, click on \"`Finish`\" to start the installation.\n\nRestart Eclipse for the installation to complete.\n\n=== Docker Perspective and View\n\nGo to \"`Window`\", \"`Perspective`\", \"`Open Perspective`\", \"`Other...`\", \"`Docker Tooling`\".\n\nimage::docker-eclipse-docker-perspective.png[]\n\nClick on \"`OK`\" to see the perspective.\n\nimage::docker-eclipse-docker-perspective-default-look.png[]\n\nThis has three views:\n\n- *Docker Explorer*: a tree view listing all connected Docker instances, with image and containers.\n- *Docker Images*: a table view listing containers for selected Docker connection.\n- *Docker Containers*: a table view listing containers for selected Docker connection\n\nClick on the text in Docker Explorer to create a new connection. If you are on Mac/Windows, you are likely using Docker for Mac/Windows or Docker Toolbox to setup Docker Host. Eclipse allows to configure Docker Engine using both Docker for Mac/Windows and Docker Toolbox.\n\nIf you are using Docker for Mac/Windows, then the default values are shown:\n\nimage::docker-eclipse-docker-connection.png[]\n\nClick on \"`Test Connection`\" to test the connection.\n\nimage::docker-eclipse-docker-connection-test.png[]\n\nIf you are using Toolbox, enter the values as shown:\n\nimage::docker-eclipse-docker-connection-toolbox.png[]\n\nThe exact value of TCP Connection can be found using `docker-machine ls` command. The path for authentication is the directory name where certificates for your Docker Machine, `couchbase` in this case, are stored.\n\nClick on \"`Test Connection`\" to make sure the connection is successfully configured.\n\nimage::docker-eclipse-docker-connection-test-toolbox.png[]\n\nIn either case, the configuration can be completed once the connection is tested. Click on \"`Finish`\" to complete the configuration.\n\nDocker Explorer is updated to show the connection.\n\nContainers and Images configured for the Docker Machine are shown in tabs. They can be expanded to see the list in Explorer itself.\n\n=== Pull an Image\n\nExpand the connection to see \"`Containers`\" and \"`Images`\".\n\nRight-click on \"`Images`\" and select \"`Pull...`\".\n\nType the image name and click on \"`Finish`\".\n\nimage::docker-eclipse-pull-image.png[]\n\nThis image is now shown in Explorer and Docker Images tab.\n\nimage::docker-eclipse-pulled-image.png[]\n\nAny existing images on the Docker Host will be shown here.\n\n=== Run a Container\n\nSelect an image, right-click on it, and click on \"`Run...`\". It shows the options that can be configured for running the container. Some of them are:\n\n- Publish ports on Docker host interface (`-P` or `-p` in `docker run` command)\n- Keep STDIN open and allocate pseudo-TTY (`-it` on CLI)\n- Remove container after it exits (`--rm` on CLI)\n- Volume mapping (`-v` on CLI)\n- Environment variables (`-e` on CLI)\n\nUncheck \"`Publish all exposed ports`\" box to map to corresponding ports.\n\nimage::docker-eclipse-run-container-config.png[]\n\nClick on \"`Finish`\" to run the container.\n\nRight-click on the started container, select \"`Display Log`\" to show the log.\n\nimage::docker-eclipse-container-display-log.png[]\n\nThe container can be paused, stopped and killed from here as well.\n\nTo see more details about the container, right-click on the container, select \"`Show In`\", \"`Properties`\".\n\nimage::docker-eclipse-container-properties.png[]\n\n=== Build an Image\n\nIn Docker Images tab, click on the hammer icon on top right.\n\nGive the image name, specify an empty directory, click on \"`Edit Dockerfile`\" to edit the contents of Dockerfile\n\nimage::docker-eclipse-build-image.png[]\n\nClick on \"`Save`\" and \"`Finish`\" to create the image.\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch07-intellij.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n[[Docker_IntelliJ]]\n== Docker and IntelliJ IDEA\n\nThis chapter will show you basic Docker tooling with IntelliJ IDEA:\n\n- Pull Docker images\n- Run, stop, delete a Container\n- Build an Image\n\n=== Install Docker Plugin in IDEA\n\nGo to \"`Preferences`\", \"`Plugins`\", \"`Install JetBrains plugin...`\", search on \"`docker`\" and click on \"`Install`\"\n\nimage::docker-intellij-plugin-install.png[]\n\nRestart IntelliJ IDEA to active plugin.\n\nClick on \"`Create New Project`\", select \"`Java`\", \"`Web Application`\"\n\nimage::docker-intellij-create-java-project.png[]\n\nClick on \"`Next`\", give the project a name \"`dockercon`\", click on \"`Finish`\". This will open up the project in IntelliJ window.\n\nGo to \"`Preferences`\", \"`Clouds`\", add a new deployment by clicking on \"`+`\". Click on \"`Import credentials from Docker Machine`\", \"`Detect`\", and see a successful connection. You may have to check the IP address of your Docker Machine. Find the IP address of your Docker Machine as `docker-machine ip ` and specify the correct IP address here.\n\nimage::docker-intellij-cloud-connection.png[]\n\nGo to \"`View`\", \"`Tool Windows`\", \"`Docker Tooling Window`\". Click on \"`Connect`\"\" to connect with Docker Machine. Make sure Docker Machine is running. \n\nWARNING: IDEA does not work with \"`Docker for Mac`\" at this time. (ADD BUG #)\n\nimage::docker-intellij-tool-window.png[]\n\n=== Pull an Image\n\nSelect top-level node with the name \"`Docker`\", click on \"`Pull image`\"\n\nimage::docker-intellij-pull-image.png[]\n\nType an image name, such as `arungupta/couchbase`, and \"`OK`\"\n\nimage::docker-intellij-repository-name.png[]\n\nExpand \"`Containers`\" and \"`Images`\" to see existing running containers and images.\n\nThe specified image is now downloaded and shown as well.\n\n=== Run a Container\n\nSelect the downloaded image, click on \"`Create container`\"\n\nSelect \"`After launch`\" and enter the URL as `http://192.168.99.100:8091`. Make sure to match the IP address of your Docker Machine.\n\nimage::docker-intellij-deployment-after-launch.png[]\n\nIn \"`Container`\" tab, add \"`Port bindings`\" for `8091:8091`\n\nimage::docker-intellij-container-ports.png[]\n\nClick on \"`Run`\" to run the container.\n\nThis will bring up the browser window and display the page http://192.168.99.100:8091 and looks like:\n\nimage::docker-intellij-run-container-browser.png[]\n\nThis image uses http://developer.couchbase.com/documentation/server/current/rest-api/rest-endpoints-all.html[Couchbase REST API] to configure the Couchbase server. \n\nRight-click on the running container, select \"`Inspect`\" to see more details about the container.\n\nimage::docker-intellij-container-inspect.png[]\n\nClick on \"`Stop container`\" to stop the container and \"`Delete container`\" to delete the container.\n\n=== Build an Image\n\n. Refer to the instructions https://www.jetbrains.com/help/idea/2016.1/docker.html\n\n. Right-click on the project, create a new directory `docker-dir`\n. Artifact\n.. Click on top-right for \"`Project Structure`\"\n.. select \"`Artifacts`\"\n.. change \"`Type:`\" to \"`Web Application: Archive`\"\n.. change the name to `dockercon`\n.. change `Output directory` to `docker-dir`\n. Create \"`Dockerfile`\" in this directory. Use the contents\n+\n```\nFROM jboss/wildfly\n\nADD dockercon.war /opt/jboss/wildfly/standalone/deployments/\n```\n+\n. \"`Run`\", \"`Edit Configurations`\", add new \"`Docker Deployment`\"\n.. \"`Deployment`\" tab\n... Change the name to `dockercon`\n... Select \"`After launch`\", change the URL to \"`http://192.168.99.100:18080/dockercon/index.jsp`\"\n... In \"`Before launch`\", add \"`Build Artifacts`\" and select the artifact\n.. \"`Container`\" tab\n... Add \"`Port bindings`\" for \"`8080:18080`\"\n. View, Tool Windows, Docker, connect to it\n. Run the project\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch07-netbeans.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n[[Docker_NetBeans]]\n== Docker and NetBeans\n\nThis chapter will show you basic Docker tooling with NetBeans:\n\n- Pull/Build Docker images\n- Run/Start/Stop Docker containers\n\nNOTE: NetBeans only supports configuring Docker Engine running using Docker Toolbox. This means that if you are running Docker for Mac or Docker for Windows then NetBeans cannot be used.\n\n=== Configure Docker Host\n\nIn \"`Services`\" window, right-click on \"`Docker`\", click on \"`Add Docker...`\"\n\nimage::docker-netbeans-add-docker.png[]\n\nSpecify Docker Machine coordinates, click on \"`Test Connection`\" to validate the connection:\n\nimage::docker-netbeans-add-docker-instance.png[]\n\nNOTE: No support for Docker for Mac/Windows, filed as https://netbeans.org/bugzilla/show_bug.cgi?id=262398[#262398].\n\nClick on \"`Finish`\" to see:\n\nimage::docker-netbeans-added-docker-instance.png[]\n\nExpand the connection to see \"`Images`\" and \"`Containers`\".\n\n=== Pull an Image\n\nRight-click on Docker node and select \"`Pull...`\".\n\nimage::docker-netbeans-pull-image.png[]\n\nType the image name to narrow down the search from Docker Store:\n\nimage::docker-netbeans-search-image.png[]\n\nClick on \"`Pull`\" to pull the image.\n\nLog is updated in the Output window:\n\nimage::docker-netbeans-pull-image-output.png[]\n\nThis image is now shown in Services tab\n\nimage::docker-netbeans-pulled-image.png[]\n\nAny existing images on the Docker Host will be shown here as well.\n\n=== Run a Container\n\nSelect an image, right-click on it, and click on \"`Run...`\".\n\nimage::docker-netbeans-run-container.png[]\n\nThis brings up a dialog that allows the options that can be configured for running the container. Some of them are:\n\n- Container name\n- Override the command\n- Keep STDIN open and allocate pseudo-TTY (`-it` on CLI)\n- Publish ports on Docker host interface (`-P` or `-p` in `docker run` command)\n\nimage::docker-netbeans-run-container-option1.png[]\n\nClick on \"`Next>`\" to see the options to configure exposed ports. Click on \"`Add`\" to explicitly map host port \"`8091`\" to container port \"`8091`\".\n\nimage::docker-netbeans-run-container-option2.png[]\n\nClick on \"`Finish`\" to run the container. \"`Services`\" window is updated as:\n\nimage::docker-netbeans-run-container-services.png[]\n\nLog is shown in the \"`Output`\" window:\n\nimage::docker-netbeans-run-container-log.png[]\n\nRight-click on the container, select \"`Show Log`\" to show the log generated by the container. The container can be paused and stopped from here as well.\n\n=== Build an Image\n\nOn the configured Docker Host, right-click and select \"`Build...`\" to build a new image:\n\nimage::docker-netbeans-build-image.png[]\n\nSpecify a directory where `Dockerfile` exists, give the image name:\n\nimage::docker-netbeans-build-image-option1.png[]\n\nClick on \"`Next>`\", choose the options that matter:\n\nimage::docker-netbeans-build-image-option2.png[]\n\nClick on \"`Finish`\" to build the image. The image is shown in the \"`Services`\" window:\n\nimage::docker-netbeans-build-image-services.png[]\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch08-aws.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n= Docker for AWS\n\nhttps://docs.docker.com/docker-for-aws/[Docker for AWS] is a CloudFormation template that configures Docker in swarm-mode, running on EC2 instances backed by custom AMIs. This allows to create a cluster of Docker Engine in swarm-mode with a single click. This workshop will take the https://github.com/docker/labs/blob/master/developer-tools/java/chapters/ch06-swarm.adoc#multi-container-application[multi-container application] and deploy it on multiple hosts.\n\n== Requirements\n\nWhat is required for creating this CloudFormation template?\n\n. https://docs.docker.com/docker-for-aws/iam-permissions/[Permissions]\n. SSH key in AWS in the region where you want to deploy (required to access the completed Docker install). http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html[Amazon EC2 Key Pair] explains how to add SSH key to your account\n. AWS account that support EC2-VPC\n\n== Create cluster\n\nhttps://console.aws.amazon.com/cloudformation/home#/stacks/new?stackName=Docker&templateURL=https://editions-us-east-1.s3.amazonaws.com/aws/stable/Docker.tmpl[Launch Stack] to create the CloudFormation template.\n\n.Select template\nimage::docker-aws-1.png[]\n\nClick on `Next`\n\n.Swarm size\nimage::docker-aws-2.png[]\n\nSelect the number of Swarm manager (3) and worker (5) nodes. This wll create a 8 node cluster. Each node will initialize a new EC2 instance. Feel free to alter the number of master and worker nodes. For example, a more reasonable number for testing may be 1 master and 3 worker nodes.\n\nSelect the SSH key that will be used to access the cluster.\n\nBy default, the template is configured to redirect all log statements to CloudWatch. Until https://github.com/moby/moby/issues/30691[#30691] is fixed, the logs will only be available using CloudWatch. Alternatively, you may select to not redirect logs to CloudWatch. In this case, the usual command to get the logs will work.\n\nScroll down to select manager and worker properties.\n\n.Swarm manager/worker properties\nimage::docker-aws-3.png[]\n\n`m4.large` (2 vCPU and 8 GB memory) is a good start for manager. `m4.xlarge` (4 vCPU and 16 GB memory) is a good start for worker node. Feel free to choose `m3.medium` (1 vCPU and 3.75 GB memory) for manager and `m3.large` (2 vCPU and 7.5 GB memory) for a smaller cluster. Make sure the EC2 instance size is chosen to accommodate the processing and memory needs of containers that will run there.\n\nClick on `Next`\n\n.Swarm options\nimage::docker-aws-4.png[]\n\nTake default for all the options and click on `Next`.\n\n.Swarm review\nimage::docker-aws-5.png[]\n\n.Swarm IAM accept\nimage::docker-aws-6.png[]\n\nAccept the checkbox for CloudFormation to create IAM resources. Click on `Create` to create the Swarm cluster.\n\nIt will take a few minutes for the CloudFormation template to complete. The output will look like:\n\n.Swarm CloudFormation complete\nimage::docker-aws-7.png[]\n\nhttps://console.aws.amazon.com/ec2/v2/home?#Instances:search=docker;sort=instanceState[EC2 Console] will show the EC2 instances for manager and worker.\n\n.EC2 console\nimage::docker-aws-8.png[]\n\nSelect one of the manager nodes, copy the public IP address:\n\n[[Swarm_manager]]\n.Swarm manager\nimage::docker-aws-9.png[]\n\nCreate a SSH tunnel using the command:\n\n ssh -i ~/.ssh/arun-us-east1.pem -o StrictHostKeyChecking=no -NL localhost:2374:/var/run/docker.sock docker@ec2-34-200-216-30.compute-1.amazonaws.com &\n\nGet more details about the cluster using the command `docker -H localhost:2374 info`. This shows the output:\n\n```\nContainers: 5\n Running: 4\n Paused: 0\n Stopped: 1\nImages: 5\nServer Version: 17.09.0-ce\nStorage Driver: overlay2\n Backing Filesystem: extfs\n Supports d_type: true\n Native Overlay Diff: true\nLogging Driver: awslogs\nCgroup Driver: cgroupfs\nPlugins:\n Volume: local\n Network: bridge host ipvlan macvlan null overlay\n Log: awslogs fluentd gcplogs gelf journald json-file logentries splunk syslog\nSwarm: active\n NodeID: rb6rju2eln0bn80z7lqocjkuy\n Is Manager: true\n ClusterID: t38bbbex5w3bpfmnogalxn5k1\n Managers: 3\n Nodes: 8\n Orchestration:\n Task History Retention Limit: 5\n Raft:\n Snapshot Interval: 10000\n Number of Old Snapshots to Retain: 0\n Heartbeat Tick: 1\n Election Tick: 3\n Dispatcher:\n Heartbeat Period: 5 seconds\n CA Configuration:\n Expiry Duration: 3 months\n Force Rotate: 0\n Autolock Managers: false\n Root Rotation In Progress: false\n Node Address: 172.31.46.94\n Manager Addresses:\n 172.31.26.163:2377\n 172.31.46.94:2377\n 172.31.8.136:2377\nRuntimes: runc\nDefault Runtime: runc\nInit Binary: docker-init\ncontainerd version: 06b9cb35161009dcb7123345749fef02f7cea8e0\nrunc version: 3f2f8b84a77f73d38244dd690525642a72156c64\ninit version: 949e6fa\nSecurity Options:\n seccomp\n Profile: default\nKernel Version: 4.9.49-moby\nOperating System: Alpine Linux v3.5\nOSType: linux\nArchitecture: x86_64\nCPUs: 2\nTotal Memory: 7.785GiB\nName: ip-172-31-46-94.ec2.internal\nID: F65G:UTHH:7YEM:XPEZ:NBIZ:XN25:ONG6:QN5R:7MGJ:I3RS:BAX3:UO7A\nDocker Root Dir: /var/lib/docker\nDebug Mode (client): false\nDebug Mode (server): true\n File Descriptors: 299\n Goroutines: 399\n System Time: 2017-10-07T01:04:00.971903882Z\n EventsListeners: 0\nRegistry: https://index.docker.io/v1/\nLabels:\n os=linux\n region=us-east-1\n availability_zone=us-east-1c\n instance_type=m4.large\n node_type=manager\nExperimental: true\nInsecure Registries:\n 127.0.0.0/8\nLive Restore Enabled: false\n```\n\nList of nodes in the cluster can be seen using `docker -H localhost:2374 node ls`:\n\n```\nID HOSTNAME STATUS AVAILABILITY MANAGER STATUS\nxdhwdiglfs5wsvkcl0j65wl04 ip-172-31-4-89.ec2.internal Ready Active \nxbrejk2g7mk9v15hg9xzu3syq ip-172-31-8-136.ec2.internal Ready Active Leader\nbhwc67r78cfqtquri82qdwtnk ip-172-31-13-38.ec2.internal Ready Active \nygxdfloly3x203x9p5wbpk34d ip-172-31-17-74.ec2.internal Ready Active \ntoyfec889wuqdix6z618mlj85 ip-172-31-26-163.ec2.internal Ready Active Reachable\n37lzvgrtlnnq0lnr3cip0fwhw ip-172-31-28-204.ec2.internal Ready Active \nk2aprr08b3q28nvze9uv26821 ip-172-31-39-252.ec2.internal Ready Active \nrb6rju2eln0bn80z7lqocjkuy * ip-172-31-46-94.ec2.internal Ready Active Reachable\n```\n\n== Multi-container application to multi-host\n\nUse the link:ch05-compose.adoc#configuration-file[Compose file] to deploy a multi-container application to this Docker cluster. This will deploy a multi-container application to multiple hosts.\n\nCreate a new directory and `cd` to it:\n\n mkdir webapp\n cd webapp\n\nCreate a new Compose definition `docker-compose.yml` using the configuration file from https://github.com/docker/labs/blob/master/developer-tools/java/chapters/ch05-compose.adoc#configuration-file.\n\nThe command is:\n\n```\ndocker -H localhost:2374 stack deploy --compose-file=docker-compose.yml webapp\n```\n\nThe output is:\n\n```\nIgnoring deprecated options:\n\ncontainer_name: Setting the container name is not supported.\n\nCreating network webapp_default\nCreating service webapp_web\nCreating service webapp_db\n```\n\nWildFly Swarm and MySQL services are started on this cluster. Each service has a single container. A new overlay network is created. This allows multiple containers on different hosts to communicate with each other.\n\n== Verify service and containers in application\n\nVerify that the WildFly and Couchbase services are running using `docker -H localhost:2374 service ls`:\n\n```\nID NAME MODE REPLICAS IMAGE PORTS\nq4d578ime45e webapp_db replicated 1/1 mysql:8 *:3306->3306/tcp\nqt5qrzp1jpyq webapp_web replicated 1/1 arungupta/docker-javaee:dockerconeu17 *:8080->8080/tcp,*:9990->9990/tcp\n```\n\n`REPLICAS` colum shows that one of one replica for the container is running for each service. It might take a few minutes for the service to be running as the image needs to be downloaded on the host where the container is started.\n\nLet's find out which node the services are running. Do this for the web application first:\n\n```\ndocker -H localhost:2374 service ps webapp_web\nID NAME IMAGE NODE DESIRED STATE CURRENT STATE ERROR PORTS\nnpmunk4ll9f4 webapp_web.1 arungupta/docker-javaee:dockerconeu17 ip-172-31-39-252.ec2.internal Running Running 2 hours ago\n```\n\nThe `NODE` column shows the internal IP address of the node where this service is running.\n\nNow, do this for the database:\n\n```\ndocker -H localhost:2374 service ps webapp_db\nID NAME IMAGE NODE DESIRED STATE CURRENT STATE ERROR PORTS\nvzaji4xdi2qh webapp_db.1 mysql:8 ip-172-31-17-74.ec2.internal Running Running 2 hours ago \n```\n\nThe `NODE` column for this service shows that the service is running on a different node.\n\nMore details about the service can be obtained using `docker -H localhost:2374 service inspect webapp_web`:\n\n```\n[\n {\n \"ID\": \"qt5qrzp1jpyq1ur7qhg55ijf1\",\n \"Version\": {\n \"Index\": 58\n },\n \"CreatedAt\": \"2017-10-07T01:09:32.519975146Z\",\n \"UpdatedAt\": \"2017-10-07T01:09:32.535587602Z\",\n \"Spec\": {\n \"Name\": \"webapp_web\",\n \"Labels\": {\n \"com.docker.stack.image\": \"arungupta/docker-javaee:dockerconeu17\",\n \"com.docker.stack.namespace\": \"webapp\"\n },\n \"TaskTemplate\": {\n \"ContainerSpec\": {\n \"Image\": \"arungupta/docker-javaee:dockerconeu17@sha256:6a403c35d2ab4442f029849207068eadd8180c67e2166478bc3294adbf578251\",\n \"Labels\": {\n \"com.docker.stack.namespace\": \"webapp\"\n },\n \"Privileges\": {\n \"CredentialSpec\": null,\n \"SELinuxContext\": null\n },\n \"StopGracePeriod\": 10000000000,\n \"DNSConfig\": {}\n },\n \"Resources\": {},\n \"RestartPolicy\": {\n \"Condition\": \"any\",\n \"Delay\": 5000000000,\n \"MaxAttempts\": 0\n },\n \"Placement\": {\n \"Platforms\": [\n {\n \"Architecture\": \"amd64\",\n \"OS\": \"linux\"\n }\n ]\n },\n \"Networks\": [\n {\n \"Target\": \"b0ig9m1qsjax95tp9m1i2m4yo\",\n \"Aliases\": [\n \"web\"\n ]\n }\n ],\n \"ForceUpdate\": 0,\n \"Runtime\": \"container\"\n },\n \"Mode\": {\n \"Replicated\": {\n \"Replicas\": 1\n }\n },\n \"UpdateConfig\": {\n \"Parallelism\": 1,\n \"FailureAction\": \"pause\",\n \"Monitor\": 5000000000,\n \"MaxFailureRatio\": 0,\n \"Order\": \"stop-first\"\n },\n \"RollbackConfig\": {\n \"Parallelism\": 1,\n \"FailureAction\": \"pause\",\n \"Monitor\": 5000000000,\n \"MaxFailureRatio\": 0,\n \"Order\": \"stop-first\"\n },\n \"EndpointSpec\": {\n \"Mode\": \"vip\",\n \"Ports\": [\n {\n \"Protocol\": \"tcp\",\n \"TargetPort\": 8080,\n \"PublishedPort\": 8080,\n \"PublishMode\": \"ingress\"\n },\n {\n \"Protocol\": \"tcp\",\n \"TargetPort\": 9990,\n \"PublishedPort\": 9990,\n \"PublishMode\": \"ingress\"\n }\n ]\n }\n },\n \"Endpoint\": {\n \"Spec\": {\n \"Mode\": \"vip\",\n \"Ports\": [\n {\n \"Protocol\": \"tcp\",\n \"TargetPort\": 8080,\n \"PublishedPort\": 8080,\n \"PublishMode\": \"ingress\"\n },\n {\n \"Protocol\": \"tcp\",\n \"TargetPort\": 9990,\n \"PublishedPort\": 9990,\n \"PublishMode\": \"ingress\"\n }\n ]\n },\n \"Ports\": [\n {\n \"Protocol\": \"tcp\",\n \"TargetPort\": 8080,\n \"PublishedPort\": 8080,\n \"PublishMode\": \"ingress\"\n },\n {\n \"Protocol\": \"tcp\",\n \"TargetPort\": 9990,\n \"PublishedPort\": 9990,\n \"PublishMode\": \"ingress\"\n }\n ],\n \"VirtualIPs\": [\n {\n \"NetworkID\": \"i41xh4kmuwl5vc47h536l3mxs\",\n \"Addr\": \"10.255.0.10/16\"\n },\n {\n \"NetworkID\": \"b0ig9m1qsjax95tp9m1i2m4yo\",\n \"Addr\": \"10.0.0.2/24\"\n }\n ]\n }\n }\n]\n```\n\nLogs for the service are redirected to CloudWatch and thus cannot be seen using `docker service logs`. This will be fixed with https://github.com/moby/moby/issues/30691[#30691]. Let's view the logs using using https://console.aws.amazon.com/cloudwatch/home?#logs:prefix=Docker[CloudWatch Logs].\n\n.CloudWatch log group\nimage::docker-aws-10.png[]\n\nSelect the log group:\n\n.CloudWatch log stream\nimage::docker-aws-11.png[]\n\nPick `webapp_web.xxx` log stream to see the log statements from WildFly Swarm:\n\n.CloudWatch application log stream\nimage::docker-aws-12.png[]\n\n== Access application\n\nApplication is accessed using manager's IP address and on port 8080. By default, the port 8080 is not open. \n\nIn https://console.aws.amazon.com/ec2/v2/home?#Instances:search=docker;sort=instanceState[EC2 Console], select an EC2 instance with name `Docker-Manager`, click on `Docker-Managerxxx` in `Security groups`. Click on `Inbound`, `Edit`, `Add Rule`, and create a rule to enable TCP traffic on port 8080.\n\n.Open port 8080 in Docker manager\nimage::docker-aws-13.png[]\n\nClick on `Save` to save the rules.\n\nNow, the application is accessible using the command `curl -v http://ec2-34-200-216-30.compute-1.amazonaws.com:8080/resources/employees` and shows output:\n\n```\n* Trying 34.200.216.30...\n* TCP_NODELAY set\n* Connected to ec2-34-200-216-30.compute-1.amazonaws.com (34.200.216.30) port 8080 (#0)\n> GET /resources/employees HTTP/1.1\n> Host: ec2-34-200-216-30.compute-1.amazonaws.com:8080\n> User-Agent: curl/7.51.0\n> Accept: */*\n> \n< HTTP/1.1 200 OK\n< Connection: keep-alive\n< Content-Type: application/xml\n< Content-Length: 478\n< Date: Sat, 07 Oct 2017 02:53:11 GMT\n< \n* Curl_http_done: called premature == 0\n* Connection #0 to host ec2-34-200-216-30.compute-1.amazonaws.com left intact\n1Penny2Sheldon3Amy4Leonard5Bernadette6Raj7Howard8Priya\n```\n\n== Shutdown application\n\nShutdown the application using the command `docker -H localhost:2374 stack rm webapp`:\n\n```\nRemoving service webapp_db\nRemoving service webapp_web\nRemoving network webapp_default\n```\n\nThis stops the container in each service and removes the services. It also deletes any networks that were created as part of this application.\n\n== Shutdown cluster\n\nDocker cluster can be shutdown by deleting the stack created by CloudFormation:\n\n.Delete CloudFormation template\nimage::docker-aws-14.png[]\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch08-azure.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n= Docker for Azure\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch08-cloud.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n= Docker Cloud\n\n== Key Concepts\n\nDocker Cloud is a SaaS that allows you to build, deploy and manage Docker containers in physical servers, virtual machine or cloud providers.\n\nThe main concepts of Docker Cloud are: \n\n- *Nodes* are individual Linux hosts/VMs used to deploy and run your applications. New nodes can be provisioned to increase the capacity. Docker Cloud does not provide hosting services. Nodes are provisioned using physical servers, virtual machine or cloud providers.\n- *Node Clusters* are logical groups of nodes of the same type. Node Clusters allow to scale the infrastructure easily by provisioning more nodes.\n- *Services* are logical groups of containers from the same image. Services make it simple to scale your application across different nodes.\n\nThis chapter will show how to use TomEE Docker image and deploy it using Docker Cloud CLI.\n\n=== Docker Cloud CLI\n\nInstall Docker Cloud CLI following the https://docs.docker.com/docker-cloud/installing-cli/[instructions].\n\n== Create new Docker Cloud Node\n\nCreate a new node cluster:\n\n[source, text]\n----\ndocker-cloud nodecluster create -t 1 --tag wildfly wildfly-node aws us-west-1 m3.large\n----\n\nThis node cluster has a single node (`-t 1`) and uses the tag \"`wildfly`\" (`--tag wildfly`). Last four parameters are nodecluster name (`couchbase-node`), provider (`aws`), region (`us-west-1`) and node type (`m3.large`).\n\nEach node in this node cluster will be given the assigned tag. This will be used later to assign services to a specific node or node cluster.\n\nDeploying a node can take a few minutes. Current status can also be seen https://cloud.docker.com/app/arungupta/nodecluster/list/1?page_size=10[Docker Cloud dashboard]:\n\nimage::docker-cloud-nodecluster.png[]\n\n== Create a new Docker Cloud Service\n\nCreate a Docker Cloud Service:\n\n[source, text]\n----\ndocker-cloud service create --name wildfly --tag wildfly -p 8080:8080 jboss/wildfly\n124aa470-4e44-4f19-b0f0-d0c2616510a7\n----\n\nhttps://cloud.docker.com/app/arungupta/service/list/1?name__icontains=wildfly&page=1&page_size=10[Docker Cloud dashboard] will look like:\n\nimage::docker-cloud-services.png[]\n\nStart the Service:\n\n[source, text]\n----\ndocker-cloud service start 124aa470-4e44-4f19-b0f0-d0c2616510a7\n----\n\nCheck the service logs:\n\n[source, text]\n----\ndocker-cloud service logs 124aa470-4e44-4f19-b0f0-d0c2616510a7\n----\n\nIt shows the output as:\n\n[source, text]\n----\nwildfly-1 | 2017-02-04T00:00:22.752881989Z =========================================================================\nwildfly-1 | 2017-02-04T00:00:22.752982683Z \nwildfly-1 | 2017-02-04T00:00:22.753058247Z JBoss Bootstrap Environment\nwildfly-1 | 2017-02-04T00:00:22.753149954Z \nwildfly-1 | 2017-02-04T00:00:22.753228180Z JBOSS_HOME: /opt/jboss/wildfly\nwildfly-1 | 2017-02-04T00:00:22.753313935Z \nwildfly-1 | 2017-02-04T00:00:22.753385039Z JAVA: /usr/lib/jvm/java/bin/java\nwildfly-1 | 2017-02-04T00:00:22.753537123Z \nwildfly-1 | 2017-02-04T00:00:22.753926931Z JAVA_OPTS: -server -Xms64m -Xmx512m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djava.net.preferIPv4Stack=true -Djboss.modules.system.pkgs=org.jboss.byteman -Djava.awt.headless=true\n\n. . .\n\nwildfly-1 | 2017-02-04T00:00:28.062486850Z 00:00:28,062 INFO [org.jboss.ws.common.management] (MSC service thread 1-2) JBWS022052: Starting JBossWS 5.1.5.Final (Apache CXF 3.1.6) \nwildfly-1 | 2017-02-04T00:00:28.360806943Z 00:00:28,359 INFO [org.jboss.as] (Controller Boot Thread) WFLYSRV0060: Http management interface listening on http://127.0.0.1:9990/management\nwildfly-1 | 2017-02-04T00:00:28.361466490Z 00:00:28,360 INFO [org.jboss.as] (Controller Boot Thread) WFLYSRV0051: Admin console listening on http://127.0.0.1:9990\nwildfly-1 | 2017-02-04T00:00:28.362342136Z 00:00:28,361 INFO [org.jboss.as] (Controller Boot Thread) WFLYSRV0025: WildFly Full 10.1.0.Final (WildFly Core 2.2.0.Final) started in 5505ms - Started 331 of 577 services (393 services are lazy, passive or on-demand)\n----\n\n== Access WildFly Server in Docker Cloud\n\nInspect the Docker Cloud service for the exposed container ports:\n\n```\ndocker-cloud service inspect 124aa470-4e44-4f19-b0f0-d0c2616510a7 | jq \".container_ports\"\n```\n\nThis shows the output as:\n\n```\n[\n {\n \"protocol\": \"tcp\",\n \"outer_port\": 8080,\n \"inner_port\": 8080,\n \"port_name\": \"http-alt\",\n \"published\": true,\n \"endpoint_uri\": \"http://wildfly.124aa470.svc.dockerapp.io:8080/\"\n }\n]\n```\n\nAccess the main page of TomEE at http://wildfly.124aa470.svc.dockerapp.io:8080/ to see:\n\nimage::docker-cloud-wildfly.png[]\n\n== Terminate the Docker Cloud Service and Node\n\nCheck the list of Docker Cloud services running using the command `docker-cloud service ps`:\n\n```\nNAME UUID STATUS #CONTAINERS IMAGE DEPLOYED PUBLIC DNS STACK\nwildfly 124aa470 ▶ Running 1 jboss/wildfly:latest 7 minutes ago wildfly.124aa470.svc.dockerapp.io\n```\n\nUse the UUID to terminate the service:\n\n[source, text]\n----\ndocker-cloud service terminate 124aa470\n----\n\nCheck the list of nodes using `docker-cloud node ls` command:\n\n```\nUUID FQDN LASTSEEN STATUS CLUSTER DOCKER_VER\n0240951d 0240951d-27b6-4295-8ff8-ea443d668765.node.dockerapp.io 28 seconds ago ▶ Deployed wildfly-node 1.11.2-cs5\n```\n\nTerminate the node as:\n\n```\ndocker-cloud node rm 0240951d\n```\n\nCheck the list of nodecluster using `docker-cloud nodecluster ls` command:\n\n```\nNAME UUID REGION TYPE DEPLOYED STATUS CURRENT#NODES TARGET#NODES\nwildfly-node fb2f6292 us-west-1 m3.large 23 minutes ago Empty cluster 0 0\n```\n\nRemove the nodecluster as:\n\n```\ndocker-cloud nodecluster rm wildfly-node\n```\n\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch09-cicd.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n= CI/CD using Docker\n\n*PURPOSE*: This chapter explains how to use Jenkins and Docker to run continuous integration and continuous delivery.\n\nThere are several possible approaches to run Docker builds with Jenkins:\n\n. Install Jenkins on your Docker host machine. Run Docker commands from your build, either using one of the several Jenkins Docker plugins, or by running Docker commands from a build step.\n. Install Jenkins on your host machine and have a Jenkins slave machine with Docker installed to run your Docker builds\n. Run Jenkins on Docker and use the underlying Docker installed on the host to run Docker commands.\n\nNOTE: Another option is running Jenkins on Docker and do a complete Docker installation inside the Jenkins Docker container. This technique is called Docker in Docker and it is usually a bad idea. There are several discussions about the problems with this approach, like this one: http://jpetazzo.github.io/2015/09/03/do-not-use-docker-in-docker-for-ci/ . A better approach is using Docker outside of Docker, as explained here: http://container-solutions.com/running-docker-in-jenkins-in-docker/\n\n== Run Jenkins on Docker\n\nIn this example, we will run Jenkins on Docker and use the underlying Docker installed on the host to run Docker commands. This technique is known as Docker outside of Docker.\n\nFirst, clone the project:\n\n git clone https://github.com/fabianenardon/jenkins-docker-demo\n\nThen, in the project folder, run:\n\n docker-compose up\n\nNOTE: if running on Windows, run `dos2unix plugins.txt` before running `docker-compose up`, to avoid possible errors if your file is in the Windows format.\n\nWait for jenkins to start and then go to the browser and open `http://localhost:8081`. Jenkins should be running.\n\nThe Jenkins installation on this lab comes pre-configured. To login use the username `jenkins` and the password `jenkins`.\n\n== Running integration tests Jenkins\n\nFor this Continuous Integration demo, we will run a simple application that saves data on MongoDB. We will then run integration tests to check if the data was correctly saved on the database.\n\nWhen running integration tests, you want to test your application in an environment as close to production as possible, so you can test interactions between the several components, services, databases, network communication, etc. Fortunately, docker can help you a lot with integration tests. There are several strategies to run integration tests, but in this application we are going to use the following:\n\n. Start the services with a `docker-compose.yml` file created for testing purposes. This file won't have any volumes mapped, so when the test is over, no state will be saved. The test `docker-compose.yml` file won't publish any port on the host machine, so we can run simultaneous tests.\n. Run the application, using the services started with the `docker-compose.yml` test file.\n. Run Maven integration tests to check if the application execution produced the expected results. This will be done by checking what was saved on the MongoDB database.\n. Stop the services. No state will be stored, so next time you run the integration tests, you will have a clean environment.\n\nCreate a new job on jenkins:\n\n. Select Freestyle project\n+\nimage::docker-ci-cd-01.png[]\n+\n. In Source Code Management, select Git and add the repository URL: `https://github.com/fabianenardon/mongo-docker-demo.git`\n+\nimage::docker-ci-cd-02.png[]\n+\n. In Build, select Add build step and select Execute shell\n+\nimage::docker-ci-cd-03.png[]\n+\n. In the shell Command, add these instructions:\n+\n[source, text]\n----\ncd sample\n\n# Generates the images\nsudo /var/jenkins_home/tools/hudson.tasks.Maven_MavenInstallation/maven/bin/mvn clean install -Papp-docker-image\n\n# Starts the mongo service. The -p option allows multiple builds to run at the same time, \n# since we can start multiple instances of the containers\nsudo docker-compose -p app-$BUILD_NUMBER --file src/test/resources/docker-compose.yml up -d mongo\n\n# Waits for containers to start\nsleep 30\n\n# Run the application\nsudo docker-compose -p app-$BUILD_NUMBER --file src/test/resources/docker-compose.yml \\\n run mongo-docker-demo \\\n java -jar /maven/jar/mongo-docker-demo-1.0-SNAPSHOT-jar-with-dependencies.jar mongo \n\n# Run the integration tests\nsudo docker-compose -p app-$BUILD_NUMBER --file src/test/resources/docker-compose.yml \\\n run mongo-docker-demo-tests \\\n mvn -f /maven/code/pom.xml -Dmaven.repo.local=/m2/repository \\\n -Pintegration-test verify \n----\n+\n. Click on Add post-build action and select Execute a set of scripts\n+\nimage::docker-ci-cd-04.png[]\n+\n. In Post-build Actions, select Execute shell\n+\nimage::docker-ci-cd-05.png[]\n+\n. In the Command box, add:\n+\n[source, text]\n----\ncd sample\nsudo docker-compose -p app-$BUILD_NUMBER --file src/test/resources/docker-compose.yml down\n----\n+\n. Uncheck the `Execute script only if build succeeds` and `Execute script only if build fails` options, so this script will run always when the build ends. This way, we make sure to always stop the services.\n+\n[NOTE]\n====\n. The `-p app-$BUILD_NUMBER` option allows multiple builds to run at the same time, since we can start multiple instances of the containers. We are using Jenkins $BUILD_NUMBER variable to isolate the containers. This way, each set of services will run on its own network.\n. We are running the commands with sudo because we are actually running the Docker socket on the host. Jenkins runs with the jenkins user and we added the jenkins user to the sudoers list in our image. Obviously, this can have security consequences in a production environment, since one could create a build that would access root level services on the host. You can avoid this by configuring the jenkins user on the host, so it will have access to the Docker socket and then run the commands without sudo.\n====\n+\n. Save the build and then click on `Build now` to run it. You should see a progress bar when the build is running. You can click on the progress bar to see the build console output.\n+\nimage::docker-ci-cd-06.png[]\n+\n. If the build is successful, you should see this on the build console output:\n+\nimage::docker-ci-cd-07.png[]\n\n== Run integration tests outside Jenkins\n\nWhen creating integration tests, it is useful to be able to run and debug them outside Jenkins. In order to do that, you can simply run the same commands you ran in the Jenkins build:\n\n[source, text]\n----\ncd jenkins_home/workspace/ci-test/sample\n\n# Generates the images\nmvn -f pom.xml clean install -Papp-docker-image\n\n# Starts mongo service\ndocker-compose --file src/test/resources/docker-compose.yml up -d mongo \n\n# Waits for services do start\nsleep 30\n\n# Run our application\ndocker-compose --file src/test/resources/docker-compose.yml \\\n run mongo-docker-demo \\\n java -jar /maven/jar/mongo-docker-demo-1.0-SNAPSHOT-jar-with-dependencies.jar mongo \n\n# Run our integration tests\ndocker-compose --file src/test/resources/docker-compose.yml \\\n run mongo-docker-demo-tests mvn -f /maven/code/pom.xml \\\n -Dmaven.repo.local=/m2/repository -Pintegration-test verify \n\n# Stop all the services\ndocker-compose --file src/test/resources/docker-compose.yml down\n----\n\n== Debug integration tests outside Jenkins\n\nYou can debug integration tests. This can be achieved by making your test wait for a connection at a port for debugging. You can then attach your IDE to this port and debug. The source code for this project is available at https://github.com/fabianenardon/mongo-docker-demo.git.\n\nYou need to start Mongo service and run the application again as shown in previous section.\n\nHere is how you can debug tests in NetBeans:\n\n. Run the integration tests in debug mode with the command shown below:\n+\n```\n# Run integration tests in debug mode\ndocker run -v ~/.m2/repository:/m2/repository \\\n -p 5005:5005 --link mongo:mongo \\\n --net resources_default mongo-docker-demo-tests \\\n mvn -f /maven/code/pom.xml \\\n -Dmaven.repo.local=/m2/repository \\\n -Pintegration-test verify -Dmaven.failsafe.debug\n```\n+\nThis command will wait for a connection at port 5005 for debugger.\n+\n. Open the project in NetBeans and setup breakpoint in your test code:\n+\nimage::docker-ci-cd-08.png[]\n+\n. Use `Debug` menu item to attach the debugger:\n+\nimage::docker-ci-cd-09.png[]\n+\n. Attach the debugger by specifying the correct value of `host` and `port`:\n+\nimage::docker-ci-cd-10.png[]\n+\n. Hit a breakpoint in tests:\n+\nimage::docker-ci-cd-11.png[]\n\n== Continuous delivery with Jenkins\n\nContinuous Delivery strategies depend greatly on the application architecture. With a dockerized application like the one in our demo, the continuous delivery strategy could be to publish a new version of the application image if the tests passed. This way, next time the application runs on production, the new image will be downloaded and automatically deployed. You can publish images with Jenkins just like you invoked all the other docker commands in the build.\n\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch10-monitoring.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n= Monitoring Docker Containers\n\nThis chapter will cover different ways to monitor a Docker container.\n\n== Docker CLI\n\n`docker container stats` command displays a live stream of container(s) runtime metrics. The command supports CPU, memory usage, memory limit, and network IO metrics.\n\n. Start a container: `docker container run --name web -d jboss/wildfly:10.1.0.Final`\n. Check the container stats using `docker container stats web`. It shows the output as:\n+\n```\nCONTAINER CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O PIDS\nweb 0.14% 274.9MiB / 1.952GiB 13.75% 828B / 0B 96.7MB / 4.1kB 53\n```\n+\nThe output is continually updated. It shows:\n+\n.. Container name\n.. Percent CPU utilization\n.. Total memory usage vs amount available to the container\n.. Percent memory utilization\n.. Network activity\n.. Disk activity\n.. PIDS??\n+\n. Check stats for multiple containers\n.. Terminate single instance of the container\n+\n```\ndocker container stop web\ndocker container rm web\n```\n+\n.. Create a service with multiple replicas of the container\n+\n```\ndocker swarm init\ndocker service create --name=web jboss/wildfly\n```\n+\n.. Now check the stats again:\n+\n```\ndocker stats\n```\n+\nto see the output:\n+\n```\nCONTAINER CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O PIDS\n1f9d5a1c08a8 0.24% 294.9MiB / 1.952GiB 14.75% 828B / 0B 96.5MB / 4.1kB 115\n```\n+\nNote that the container id is shown instead of container's name in this case.\n+\n. Scale the service to 3 replicas:\n+\n```\ndocker service scale web=3\n```\n+\n. The stats are now shown for all three containers:\n+\n```\nCONTAINER CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O PIDS\n1f9d5a1c08a8 0.14% 287.8MiB / 1.952GiB 14.40% 1.03kB / 0B 96.5MB / 4.1kB 53\na3395efbb6ff 0.77% 263.4MiB / 1.952GiB 13.18% 578B / 0B 0B / 4.1kB 114\nf484ff2f4c12 0.06% 294.8MiB / 1.952GiB 14.75% 578B / 0B 0B / 4.1kB 114\n```\n+\n. Display only container id and percent CPU utilization using the command `docker container stats --format \"{{.Container}}: {{.CPUPerc}}\"`:\n+\n```\n55198043b6aa: 0.10%\n5b5dd33b675d: 0.11%\n6e98a9597e6a: 0.10%\n```\n+\n. Format the output in a table. The results should include container name, percent CPU utilization and percent memory utilization. This can be achieved using the command:\n+\n```\ndocker container stats --format \"table {{.Name}}\\t{{.CPUPerc}}\\t{{.MemUsage}}\"\n```\n+\nIt shows the output:\n+\n```\nNAME CPU % MEM USAGE / LIMIT\nweb.2.1ic0vevvvu2nwwyc6css58ref 0.10% 267.5MiB / 1.952GiB\nweb.3.pwcgr58s1xo28gwa1znlrn2s3 0.11% 274.7MiB / 1.952GiB\nweb.1.bg1dcwagl9tzz0azuegxzoys8 0.12% 274MiB / 1.952GiB\n```\n+\n. Display only the first result using the command `docker container stats --no-stream`:\n+\n```\nCONTAINER CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O PIDS\n55198043b6aa 0.12% 267.5MiB / 1.952GiB 13.39% 1.44kB / 0B 0B / 4.1kB 51\n5b5dd33b675d 0.07% 274.7MiB / 1.952GiB 13.75% 1.51kB / 0B 0B / 4.1kB 51\n6e98a9597e6a 0.26% 274.1MiB / 1.952GiB 13.71% 1.69kB / 0B 0B / 4.1kB 51\n```\n\n== Docker Remote API\n\nDocker Remote API provides a lot more details about the health of the container. It can be invoked using the following format:\n\n curl --unix-socket /var/run/docker.sock http://localhost/containers//stats\n\nOn Docker for Mac, enabling remote HTTP API still requires a few steps. So this command uses the `--unix-socket` option to invoke the Remote API.\n\nA specific invocation for a container can be done as:\n\n curl --unix-socket /var/run/docker.sock http://localhost/containers/web.1.bg1dcwagl9tzz0azuegxzoys8/stats\n\nNote, the container name is from the previous run of the service. It will show the output:\n\n```\n{\"read\":\"2017-10-13T14:08:38.045217731Z\",\"preread\":\"0001-01-01T00:00:00Z\",\"pids_stats\":{\"current\":51},\"blkio_stats\":{\"io_service_bytes_recursive\":[{\"major\":8,\"minor\":0,\"op\":\"Read\",\"value\":0},{\"major\":8,\"minor\":0,\"op\":\"Write\",\"value\":4096},{\"major\":8,\"minor\":0,\"op\":\"Sync\",\"value\":0},{\"major\":8,\"minor\":0,\"op\":\"Async\",\"value\":4096},{\"major\":8,\"minor\":0,\"op\":\"Total\",\"value\":4096}],\"io_serviced_recursive\":[{\"major\":8,\"minor\":0,\"op\":\"Read\",\"value\":0},{\"major\":8,\"minor\":0,\"op\":\"Write\",\"value\":1},{\"major\":8,\"minor\":0,\"op\":\"Sync\",\"value\":0},{\"major\":8,\"minor\":0,\"op\":\"Async\",\"value\":1},{\"major\":8,\"minor\":0,\"op\":\"Total\",\"value\":1}],\"io_queue_recursive\":[],\"io_service_time_recursive\":[],\"io_wait_time_recursive\":[],\"io_merged_recursive\":[],\"io_time_recursive\":[],\"sectors_recursive\":[]},\"num_procs\":0,\"storage_stats\":{},\"cpu_stats\":{\"cpu_usage\":{\"total_usage\":11130296115,\"percpu_usage\":[2687118654,3014514615,2971860160,2456802686],\"usage_in_kernelmode\":2700000000,\"usage_in_usermode\":7630000000},\"system_cpu_usage\":952826800000000,\"online_cpus\":4,\"throttling_data\":{\"periods\":0,\"throttled_periods\":0,\"throttled_time\":0}},\"precpu_stats\":{\"cpu_usage\":{\"total_usage\":0,\"usage_in_kernelmode\":0,\"usage_in_usermode\":0},\"throttling_data\":{\"periods\":0,\"throttled_periods\":0,\"throttled_time\":0}},\"memory_stats\":{\"usage\":288051200,\"max_usage\":297189376,\"stats\":{\"active_anon\":283893760,\"active_file\":0,\"cache\":135168,\"dirty\":16384,\"hierarchical_memory_limit\":9223372036854771712,\"hierarchical_memsw_limit\":9223372036854771712,\"inactive_anon\":0,\"inactive_file\":135168,\"mapped_file\":32768,\"pgfault\":83204,\"pgmajfault\":0,\"pgpgin\":78441,\"pgpgout\":9093,\"rss\":283914240,\"rss_huge\":0,\"swap\":0,\"total_active_anon\":283893760,\"total_active_file\":0,\"total_cache\":135168,\"total_dirty\":16384,\"total_inactive_anon\":0,\"total_inactive_file\":135168,\"total_mapped_file\":32768,\"total_pgfault\":83204,\"total_pgmajfault\":0,\"total_pgpgin\":78441,\"total_pgpgout\":9093,\"total_rss\":283914240,\"total_rss_huge\":0,\"total_swap\":0,\"total_unevictable\":0,\"total_writeback\":0,\"unevictable\":0,\"writeback\":0},\"limit\":2095874048},\"name\":\"/web.1.bg1dcwagl9tzz0azuegxzoys8\",\"id\":\"6e98a9597e6af085e73a4d211fff9a164aa012727a46525d4fbaa164b572e23f\",\"networks\":{\"eth0\":{\"rx_bytes\":1882,\"rx_packets\":37,\"rx_errors\":0,\"rx_dropped\":0,\"tx_bytes\":0,\"tx_packets\":0,\"tx_errors\":0,\"tx_dropped\":0}}}\n```\n\nAs you can see, far more details about container's health are shown here. These stats are refereshed every one second. The continuous refresh of metrics can be terminated using `Ctrl + C`.\n\n== Docker Events\n\n`docker system events` provide real time events for the Docker host.\n\n. In one terminal (T1), type `docker system events`. The command does not show output and waits for any event worth reporting to occur. The list of events is listed at https://docs.docker.com/engine/reference/commandline/events/#/extended-description.\n. In a new terminal (T2), kill existing container using `docker service scale web=2`.\n. T1 shows the updated list of events as:\n+\n```\n2017-10-13T07:12:00.223791013-07:00 service update r4i0x8ujnn2q8osj8dowgvw72 (name=web, replicas.new=2, replicas.old=3)\n2017-10-13T07:12:00.332724880-07:00 container kill 5b5dd33b675d3b6be3e6aaf0ecde928b3ac882b0a221ff71e57c86faae8181ab (build-date=20170911, com.docker.swarm.node.id=wgujclh0492kkszpil81d3ugb, com.docker.swarm.service.id=r4i0x8ujnn2q8osj8dowgvw72, com.docker.swarm.service.name=web, com.docker.swarm.task=, com.docker.swarm.task.id=pwcgr58s1xo28gwa1znlrn2s3, com.docker.swarm.task.name=web.3.pwcgr58s1xo28gwa1znlrn2s3, image=jboss/wildfly:latest@sha256:d3af084d024753e4799809c10cd188f675a5b254a8e279b34709035b95d27dc7, license=GPLv2, name=web.3.pwcgr58s1xo28gwa1znlrn2s3, signal=15, vendor=CentOS)\n2017-10-13T07:12:00.613143701-07:00 container die 5b5dd33b675d3b6be3e6aaf0ecde928b3ac882b0a221ff71e57c86faae8181ab (build-date=20170911, com.docker.swarm.node.id=wgujclh0492kkszpil81d3ugb, com.docker.swarm.service.id=r4i0x8ujnn2q8osj8dowgvw72, com.docker.swarm.service.name=web, com.docker.swarm.task=, com.docker.swarm.task.id=pwcgr58s1xo28gwa1znlrn2s3, com.docker.swarm.task.name=web.3.pwcgr58s1xo28gwa1znlrn2s3, exitCode=0, image=jboss/wildfly:latest@sha256:d3af084d024753e4799809c10cd188f675a5b254a8e279b34709035b95d27dc7, license=GPLv2, name=web.3.pwcgr58s1xo28gwa1znlrn2s3, vendor=CentOS)\n2017-10-13T07:12:00.897831488-07:00 network disconnect 8f8e6ce771d6db6065f2472a7e83612ff6a657de3b6d08dab0617b8a596234fa (container=5b5dd33b675d3b6be3e6aaf0ecde928b3ac882b0a221ff71e57c86faae8181ab, name=bridge, type=bridge)\n2017-10-13T07:12:01.017523717-07:00 container stop 5b5dd33b675d3b6be3e6aaf0ecde928b3ac882b0a221ff71e57c86faae8181ab (build-date=20170911, com.docker.swarm.node.id=wgujclh0492kkszpil81d3ugb, com.docker.swarm.service.id=r4i0x8ujnn2q8osj8dowgvw72, com.docker.swarm.service.name=web, com.docker.swarm.task=, com.docker.swarm.task.id=pwcgr58s1xo28gwa1znlrn2s3, com.docker.swarm.task.name=web.3.pwcgr58s1xo28gwa1znlrn2s3, image=jboss/wildfly:latest@sha256:d3af084d024753e4799809c10cd188f675a5b254a8e279b34709035b95d27dc7, license=GPLv2, name=web.3.pwcgr58s1xo28gwa1znlrn2s3, vendor=CentOS)\n2017-10-13T07:12:01.023414108-07:00 container destroy 5b5dd33b675d3b6be3e6aaf0ecde928b3ac882b0a221ff71e57c86faae8181ab (build-date=20170911, com.docker.swarm.node.id=wgujclh0492kkszpil81d3ugb, com.docker.swarm.service.id=r4i0x8ujnn2q8osj8dowgvw72, com.docker.swarm.service.name=web, com.docker.swarm.task=, com.docker.swarm.task.id=pwcgr58s1xo28gwa1znlrn2s3, com.docker.swarm.task.name=web.3.pwcgr58s1xo28gwa1znlrn2s3, image=jboss/wildfly:latest@sha256:d3af084d024753e4799809c10cd188f675a5b254a8e279b34709035b95d27dc7, license=GPLv2, name=web.3.pwcgr58s1xo28gwa1znlrn2s3, vendor=CentOS)\n```\n+\nThe output shows a list of events, one in each line. The events shown here are `container kill`, `container die`, `network disconnect`, `container stop`, and `container destroy`. Date and timestamp for each event is displayed at the beginning of the line. Other event specific information is displayed as well.\n+\n. In T2, scale the service back to 3 replicas: `docker service scale web=3`\n. The output in T1 is updated to show:\n+\n```\n2017-10-13T07:13:47.161848609-07:00 service update r4i0x8ujnn2q8osj8dowgvw72 (name=web, replicas.new=3, replicas.old=2)\n2017-10-13T07:13:47.429074382-07:00 container create 0574d1fd74bef2e6fc54174e1fbeda25efd7ed270dce1d6dbede4ead19c7c485 (build-date=20170911, com.docker.swarm.node.id=wgujclh0492kkszpil81d3ugb, com.docker.swarm.service.id=r4i0x8ujnn2q8osj8dowgvw72, com.docker.swarm.service.name=web, com.docker.swarm.task=, com.docker.swarm.task.id=xcmylcwlag5vot4tp3l5z6oam, com.docker.swarm.task.name=web.3.xcmylcwlag5vot4tp3l5z6oam, image=jboss/wildfly:latest@sha256:d3af084d024753e4799809c10cd188f675a5b254a8e279b34709035b95d27dc7, license=GPLv2, name=web.3.xcmylcwlag5vot4tp3l5z6oam, vendor=CentOS)\n2017-10-13T07:13:47.445010259-07:00 network connect 8f8e6ce771d6db6065f2472a7e83612ff6a657de3b6d08dab0617b8a596234fa (container=0574d1fd74bef2e6fc54174e1fbeda25efd7ed270dce1d6dbede4ead19c7c485, name=bridge, type=bridge)\n2017-10-13T07:13:47.778855117-07:00 container start 0574d1fd74bef2e6fc54174e1fbeda25efd7ed270dce1d6dbede4ead19c7c485 (build-date=20170911, com.docker.swarm.node.id=wgujclh0492kkszpil81d3ugb, com.docker.swarm.service.id=r4i0x8ujnn2q8osj8dowgvw72, com.docker.swarm.service.name=web, com.docker.swarm.task=, com.docker.swarm.task.id=xcmylcwlag5vot4tp3l5z6oam, com.docker.swarm.task.name=web.3.xcmylcwlag5vot4tp3l5z6oam, image=jboss/wildfly:latest@sha256:d3af084d024753e4799809c10cd188f675a5b254a8e279b34709035b95d27dc7, license=GPLv2, name=web.3.xcmylcwlag5vot4tp3l5z6oam, vendor=CentOS)\n```\n+\nThe list of events shown here are `container create`, `network connect`, and `container start`.\n\n=== Use filters\n\nThe list of events can be restricted by filters specified using `--filter` or `-f` option. The currently supported filters are:\n\n. container (`container=`)\n. daemon (`daemon=`)\n. event (`event=`)\n. image (`image=`)\n. label (`label=` or `label==`)\n. network (`network=`)\n. plugin (`plugin=`)\n. type (`type=`)\n. volume (`volume=`)\n\nLet's look at the list of running containers first using `docker container ls`, and then learn how to apply these filters.\n\nHere is the list of running containers from the service:\n\n```\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n074447f26452 jboss/wildfly:latest \"/opt/jboss/wildfl...\" 3 minutes ago Up 3 minutes 8080/tcp web.1.ytyv0gqi7dzxtetssrlsgvvbu\n0574d1fd74be jboss/wildfly:latest \"/opt/jboss/wildfl...\" 8 minutes ago Up 8 minutes 8080/tcp web.3.xcmylcwlag5vot4tp3l5z6oam\n55198043b6aa jboss/wildfly:latest \"/opt/jboss/wildfl...\" 25 minutes ago Up 25 minutes 8080/tcp web.2.1ic0vevvvu2nwwyc6css58ref\n```\n\nLet's apply the filters.\n\n. Show events for a container by name\n.. In T1, give the command to listen to a specific container as:\n+\n```\ndocker system events -f container=web.1.ytyv0gqi7dzxtetssrlsgvvbu\n```\n+\nYou may have to terminate previous run of `docker system events` using `Ctrl` + `C` to give this new command. \n+\n.. In T2, terminate the second replica of the service as `docker container rm -f web.2.1ic0vevvvu2nwwyc6css58ref`. \n.. T1 does not show any events because its only listening for events from the first replica of the service.\n. Show events for an event\n.. In T1, give the command `docker system events -f event=create`.\n.. In T2, scale the service by one more replica:\n+\n```\ndocker service scale web=4\n```\n.. T1 shows the event for container creation\n+\n```\n2017-10-13T07:24:22.971050949-07:00 container create 84e4604ffd983cfcc53ad619b4c11156518834fe23e4a0a8b299905b978a0022 (build-date=20170911, com.docker.swarm.node.id=wgujclh0492kkszpil81d3ugb, com.docker.swarm.service.id=r4i0x8ujnn2q8osj8dowgvw72, com.docker.swarm.service.name=web, com.docker.swarm.task=, com.docker.swarm.task.id=38unfmcsxmnvr844gysn28lwa, com.docker.swarm.task.name=web.4.38unfmcsxmnvr844gysn28lwa, image=jboss/wildfly:latest@sha256:d3af084d024753e4799809c10cd188f675a5b254a8e279b34709035b95d27dc7, license=GPLv2, name=web.4.38unfmcsxmnvr844gysn28lwa, vendor=CentOS)\n```\n+\nThis is accurate as a new container is created and the event is shown in T1 console.\n.. In T2, scale the service back to 2 using the command `docker servie scale web=2`\n.. T1 does not show any additional events because its only looking for create events\n.. More samples are explained at https://docs.docker.com/engine/reference/commandline/events/#/filter-events-by-criteria.\n\n== Prometheus\n\nhttps://prometheus.io/[Prometheus] is an open-source systems monitoring and alerting toolkit. Prometheus collects metrics from monitored targets by scraping metrics from HTTP endpoints on these targets. Docker instance can be configured as Prometheus target.\n\nDifferent targets to scrape are defined in the https://prometheus.io/docs/operating/configuration/[Prometheus configuration file]. Targets may be statically configured via the `static_configs` parameter in the configuration fle or dynamically discovered using one of the supported service-discovery mechanisms (Consul, DNS, Etcd, etc.).\n\nPrometheus collects metrics from monitored targets by scraping metrics from HTTP endpoints on these targets. Since Prometheus also exposes data in the same manner about itself, it can also scrape and monitor its own health.\n\n=== Docker metrics for Prometheus\n\nDocker exposes Prometheus-compatible metrics on port `9323`. This support is only available as an experimental feature.\n\n. For Docker for Mac, click on Docker icon in the status menu\n. Select `Preferences...`, `Daemon`, `Advanced` tab\n. Update daemon settings:\n+\n```\n{\n \"metrics-addr\" : \"0.0.0.0:9323\",\n \"experimental\" : true\n}\n```\n+\n. Click on `Apply & Restart` to restart the daemon\n+\nimage::prometheus-metrics-config.png[]\n+\n. Show the complete list of metrics using `curl http://localhost:9323/metrics`\n. Show the list of engine metrics using `curl http://localhost:9323/metrics | grep engine`\n\n==== Start Prometheus\n\nIn this section, we'll start Prometheus and use it to scrape it's own health.\n\n. Create a new directory `prometheus` and change to that directory\n. Create a text file `prometheus.yml` and use the following content\n+\n```\n# A scrape configuration scraping a Node Exporter and the Prometheus server\n# itself.\nscrape_configs:\n # Scrape Prometheus itself every 5 seconds.\n - job_name: 'prometheus'\n scrape_interval: 5s\n static_configs:\n - targets: ['localhost:9090']\n```\n+\nThis configuration file scrapes data from the Prometheus container which will be started subsequently on port 9090.\n+\n. Start a single-replica Prometheus service:\n+\n```\ndocker service create \\\n --replicas 1 \\\n --name metrics \\\n --mount type=bind,source=`pwd`/prometheus.yml,destination=/etc/prometheus/prometheus.yml \\\n --publish 9090:9090/tcp \\\n prom/prometheus\n```\n+\nThis will start the Prometheus container on port 9090.\n+\n. Prometheus dashboard is at http://localhost:9090. Check the list of enabled targets at http://localhost:9090/targets (also accessible from `Status` -> `Targets` menu).\n+\nimage::prometheus-metrics-target.png[]\n+\nIt shows that the Prometheus endpoint is available for scraping.\n+\n. Click on `Graph` and click on `-insert metric at cursor-` to see the list of metrics available:\n+\nimage::prometheus-metrics1.png[]\n+\nThese are all the metrics published by the Prometheus endpoint.\n+\n. Choose `http_request_total` metrics, click on `Execute`\n+\nimage::prometheus-metrics2.png[]\n+\n. Switch from `Console` to `Graph`\n+\nimage::prometheus-metrics3.png[]\n+\n. Change the duration from `1h` to `5m`\n+\nimage::prometheus-metrics4.png[]\n+\n. Click on `Add Graph`, select a different metric, say `http_requests_duration_microseconds`, and click on `Execute`\n+\nimage::prometheus-metrics5.png[]\n+\n. Switch from `Console` to `Graph` and change the duration from `1h` to `5m`\n+\nimage::prometheus-metrics6.png[]\n+\n. Stop the container: `docker container rm -f metrics`\n\nMultiple graphs can be added this way.\n\n=== Node health\n\nIn this section, we'll start Prometheus node exporter that will publish machine metrics. Then we'll use Prometheus to scrape its health information about the node running Docker.\n\n==== Start Node Exporter\n\n. All containers need to use the same overlay network so that they can communicate with each other. Let's create an overlay network:\n+\n```\ndocker network create --driver overlay prom\n```\n+\n. Start Prometheus node exporter:\n+\n```\ndocker service create --name node \\\n --mode global \\\n --mount type=bind,source=/proc,target=/host/proc \\\n --mount type=bind,source=/sys,target=/host/sys \\\n --mount type=bind,source=/,target=/rootfs \\\n --network prom \\\n --publish 9100:9100 \\\n prom/node-exporter:v0.15.0 \\\n --path.procfs /host/proc \\\n --path.sysfs /host/sys \\\n --collector.filesystem.ignored-mount-points \"^/(sys|proc|dev|host|etc)($|/)\"\n```\n+\nA few observations in this command:\n+\n.. This is started as a global service such that it is started on all nodes of the cluster.\n.. As explained in https://github.com/prometheus/node_exporter/issues/610, node exporter only works with host network on Mac OSX. This is not needed if you are running on Linux.\n.. It uses the overlay network previously created.\n.. It needs access to host's filesystems such that the metrics about the node can be published.\n\n==== Restart Prometheus\n\n. Update `prometheus.yml` to the following text:\n+\n```\nglobal:\n scrape_interval: 10s\nscrape_configs:\n - job_name: 'prometheus'\n static_configs:\n - targets:\n - 'localhost:9090'\n - job_name: 'node resources'\n dns_sd_configs:\n - names: ['tasks.node']\n type: 'A'\n port: 9100\n params:\n collect[]:\n - cpu\n - meminfo\n - diskstats\n - netdev\n - netstat\n\n - job_name: 'node storage'\n scrape_interval: 1m\n dns_sd_configs:\n - names: ['tasks.node']\n type: 'A'\n port: 9100\n params:\n collect[]:\n - filefd\n - filesystem\n - xfs\n```\n+\nA few observations:\n+\n.. DNS-based service discovery is used to discover the scraper for node-exporter. This is further explained at https://prometheus.io/docs/operating/configuration/#[dns_sd_configs]. A record-based queries are used to discover the service.\n.. Two different jobs are created even though they are scraping from the same endpoint. This provides a more logical way to represent data.\n+\n. Terminate previously running Prometheus service:\n+\n```\ndocker service rm metrics\n```\n+\n. Restart the Prometheus service, this time using the overlay network, as:\n+\n```\ndocker service create \\\n --replicas 1 \\\n --name metrics \\\n --network prom \\\n --mount type=bind,source=`pwd`/prometheus.yml,destination=/etc/prometheus/prometheus.yml \\\n --publish 9090:9090/tcp \\\n prom/prometheus\n```\n\n==== Check metrics\n\n. Confirm that both the services have started:\n+\n```\nID NAME MODE REPLICAS IMAGE PORTS\nlzl41s2i66jd metrics replicated 1/1 prom/prometheus:latest *:9090->9090/tcp\ndro3ncpyuchp node global 1/1 prom/node-exporter:latest \n```\n+\n. Confirm that all the targets are configured correctly at http://localhost:9090/targets[Prometheus dashboard]:\n+\nimage::prometheus-metrics-target2.png[]\n+\n. Now a lot more metrics, this time from the node, are also available:\n+\nimage::prometheus-metrics7.png[]\n+\nConsole output and graphs for all these metrics is now available:\n+\nimage::prometheus-metrics8.png[]\n+\nComplete list of metrics is available at https://github.com/prometheus/node_exporter.\n\n=== Query using PromQL (TODO)\n\nAdd some fun queries from https://prometheus.io/docs/querying/basics/.\n\n== cAdvisor\n\nhttps://github.com/google/cadvisor[cAdvisor] (Container Advisor) provides resource usage and performance characteristics running containers. Let's take a look on how cAdvisor can be used to get these metrics from containers.\n\n. Run `cAdvisor`\n+\n```\ndocker container run \\\n --volume=/:/rootfs:ro \\\n --volume=/var/run:/var/run:rw \\\n --volume=/sys:/sys:ro \\\n --volume=/var/lib/docker/:/var/lib/docker:ro \\\n --publish=8080:8080 \\\n --detach=true \\\n --name=cadvisor \\\n google/cadvisor:latest\n```\n+\n. Dashboard is available at http://localhost:8080\n+\nimage::cadvisor-default-dashboard.png[]\n+\n. A high-level CPU and Memory utilization is shown. More details about CPU, memory, network and filesystem usage is shown in the same page. CPU usage looks like as shown:\n+\nimage::cadvisor-cpu-snapshot.png[]\n+\n. All Docker containers are in `/docker` sub-container.\n+\nimage::cadvisor-docker-metrics.png[]\n+\nClick on any of the containers and see more details about the container.\n\ncAdvisor samples once a second and has historical data for only one minute. The data generated from https://github.com/google/cadvisor/blob/master/docs/storage/influxdb.md[cAdvisor can be exported to InfluxDB]. Optionally, you may use a Grafana front end to visualize the data as explained in https://www.brianchristner.io/how-to-setup-docker-monitoring/[How to setup Docker monitoring].\n\n=== Prometheus and cAdvisor\n\ncAdvisor also exposes container statistics as Prometheus metrics out of the box. By default, these metrics are served under the `/metrics` HTTP endpoint. Let's take a look at how these container metrics can be observed using Prometheus.\n\n. Terminate previously running cAdvisor:\n+\n```\ndocker container rm -f cadvisor\n```\n+\n. Start a new cAdvisor service, using the `prom` overlay network created earlier:\n+\n```\ndocker service create \\\n --name cadvisor \\\n --network prom \\\n --mode global \\\n --mount type=bind,source=/,target=/rootfs \\\n --mount type=bind,source=/var/run,target=/var/run \\\n --mount type=bind,source=/sys,target=/sys \\\n --mount type=bind,source=/var/lib/docker,target=/var/lib/docker \\\n google/cadvisor:latest\n```\n+\n. Terminate the previously running Prometheus service:\n+\n```\ndocker service rm metrics\n```\n+\n. The update `prometheus.yml` configuration file is:\n+\n```\nglobal:\n scrape_interval: 10s\nscrape_configs:\n - job_name: 'prometheus'\n static_configs:\n - targets:\n - 'localhost:9090'\n\n - job_name: 'node resources'\n dns_sd_configs:\n - names: ['tasks.node']\n type: 'A'\n port: 9100\n params:\n collect[]:\n - cpu\n - meminfo\n - diskstats\n - netdev\n - netstat\n\n - job_name: 'node storage'\n scrape_interval: 1m\n dns_sd_configs:\n - names: ['tasks.node']\n type: 'A'\n port: 9100\n params:\n collect[]:\n - filefd\n - filesystem\n - xfs\n\n - job_name: 'cadvisor'\n dns_sd_configs:\n - names: ['tasks.cadvisor']\n type: 'A'\n port: 8080\n```\n+\n. Start the new Prometheus service\n+\n```\ndocker service create \\\n --replicas 1 \\\n --name metrics \\\n --network prom \\\n --mount type=bind,source=`pwd`/prometheus.yml,destination=/etc/prometheus/prometheus.yml \\\n --publish 9090:9090/tcp \\\n prom/prometheus\n```\n+\n. Confirm that all the targets are configured correctly at http://localhost:9090/targets[Prometheus dashboard]:\n+\nimage::prometheus-metrics-target3.png[]\n+\nNote, all four scrape endpoints are shown here.\n+\n. In Graphs, now, a lot more metrics, this time from cAdvisor, are also available:\n+\nimage::prometheus-metrics9.png[]\n+\nConsole output and graphs for all these metrics is now available:\n+\nimage::prometheus-metrics10.png[]\n+\nComplete list of metrics is available at https://github.com/google/cadvisor.\n\nHere is a basic query written using https://prometheus.io/docs/querying/basics/[PromQL] worth trying:\n\n```\nsum by (container_label_com_docker_swarm_node_id) (\n irate(\n container_cpu_usage_seconds_total{\n container_label_com_docker_swarm_service_name=\"metrics\"\n }[1m]\n )\n)\n```\n\nThis shows the average amount of CPU used per minute by the service `metrics` aggregated over multiple CPUs. The graph will look as shown:\n\nimage::prometheus-metrics11.png[]\n\n\n== Monitor Java Applications\n\nThis section will explain how an existing Java application can be updated to publish metrics and monitored by Prometheus.\n\nPrometheus collects metrics from monitored targets by scraping metrics HTTP endpoints on these targets.\n\nAs discussed earlier, Prometheus collects metrics from monitored targets by scraping from an HTTP endpoint on these targets. By default, these metrics are expected to be published at `/metrics`. Any existing Java application can be updated to publish Prometheus-style metrics at this endpoint.\n\nAn link:ch05-compose.adoc#configuration-file[earlier chapter] explained a simple Java EE application that talks to a MySQL database. This application also publishes Prometheus-style metrics for the underlying JVM at `/metrics`. It also publishes application-specific metrics such as total number of times `GET /` and `GET /{id}` is called.\n\nThe complete set of JVM metrics are explained at https://github.com/prometheus/client_java. Refer to https://github.com/arun-gupta/docker-javaee/tree/master/employees/src/main/java/org/javaee/samples/employees/metrics for more details on how these metrics are enabled. \n\n=== Start Java application\n\n. Use the link:ch05-compose.adoc#configuration-file[Compose file] to deploy a simple the Java EE application. This will start WildFly Swarm application and MySQL database.\n+\n docker stack deploy --compose-file=docker-compose.yml webapp\n+\nThis will create `webapp_default` overlay network, and start the `webapp_web` and `webapp_db` services.\n+\n. Verify the network:\n+\n```\n$ docker network ls\nNETWORK ID NAME DRIVER SCOPE\nu6ybdaqx5h5y webapp_default overlay swarm\n```\n+\nOther networks may be shown here as well.\n+\n. Verify the services:\n+\n```\n$ docker service ls\nID NAME MODE REPLICAS IMAGE PORTS\nucztcpf1vw0a webapp_db replicated 1/1 mysql:8 *:3306->3306/tcp\njttfgvr09kre webapp_web replicated 1/1 arungupta/docker-javaee:latest *:8080->8080/tcp,*:9990->9990/tcp\n```\n+\n. Verify that the endpoint is accessible:\n+\n```\n$ curl http://localhost:8080/resources/employees\n1Penny2Sheldon3Amy4Leonard5Bernadette6Raj7Howard8Priya\n```\n+\n. Access the metrics published by the endpoint using `curl http://localhost:8080/metrics` to see the output:\n+\n```\n# HELP jvm_info JVM version info\n# TYPE jvm_info gauge\njvm_info{version=\"1.8.0_141-8u141-b15-1~deb9u1-b15\",vendor=\"Oracle Corporation\",} 1.0\n# HELP jvm_gc_collection_seconds Time spent in a given JVM garbage collector in seconds.\n# TYPE jvm_gc_collection_seconds summary\njvm_gc_collection_seconds_count{gc=\"PS Scavenge\",} 25.0\njvm_gc_collection_seconds_sum{gc=\"PS Scavenge\",} 0.386\njvm_gc_collection_seconds_count{gc=\"PS MarkSweep\",} 6.0\njvm_gc_collection_seconds_sum{gc=\"PS MarkSweep\",} 0.546\n# HELP process_cpu_seconds_total Total user and system CPU time spent in seconds.\n# TYPE process_cpu_seconds_total counter\nprocess_cpu_seconds_total 25.5\n# HELP process_start_time_seconds Start time of the process since unix epoch in seconds.\n# TYPE process_start_time_seconds gauge\nprocess_start_time_seconds 1.508056592419E9\n# HELP process_open_fds Number of open file descriptors.\n# TYPE process_open_fds gauge\nprocess_open_fds 499.0\n# HELP process_max_fds Maximum number of open file descriptors.\n# TYPE process_max_fds gauge\nprocess_max_fds 1048576.0\n# HELP process_virtual_memory_bytes Virtual memory size in bytes.\n# TYPE process_virtual_memory_bytes gauge\nprocess_virtual_memory_bytes 4.244393984E9\n# HELP process_resident_memory_bytes Resident memory size in bytes.\n# TYPE process_resident_memory_bytes gauge\nprocess_resident_memory_bytes 5.06601472E8\n# HELP jvm_classes_loaded The number of classes that are currently loaded in the JVM\n# TYPE jvm_classes_loaded gauge\njvm_classes_loaded 13096.0\n# HELP jvm_classes_loaded_total The total number of classes that have been loaded since the JVM has started execution\n# TYPE jvm_classes_loaded_total counter\njvm_classes_loaded_total 13096.0\n# HELP jvm_classes_unloaded_total The total number of classes that have been unloaded since the JVM has started execution\n# TYPE jvm_classes_unloaded_total counter\njvm_classes_unloaded_total 0.0\n# HELP jvm_threads_current Current thread count of a JVM\n# TYPE jvm_threads_current gauge\njvm_threads_current 60.0\n# HELP jvm_threads_daemon Daemon thread count of a JVM\n# TYPE jvm_threads_daemon gauge\njvm_threads_daemon 12.0\n# HELP jvm_threads_peak Peak thread count of a JVM\n# TYPE jvm_threads_peak gauge\njvm_threads_peak 67.0\n# HELP jvm_threads_started_total Started thread count of a JVM\n# TYPE jvm_threads_started_total counter\njvm_threads_started_total 93.0\n# HELP jvm_threads_deadlocked Cycles of JVM-threads that are in deadlock waiting to acquire object monitors or ownable synchronizers\n# TYPE jvm_threads_deadlocked gauge\njvm_threads_deadlocked 0.0\n# HELP jvm_threads_deadlocked_monitor Cycles of JVM-threads that are in deadlock waiting to acquire object monitors\n# TYPE jvm_threads_deadlocked_monitor gauge\njvm_threads_deadlocked_monitor 0.0\n# HELP jvm_memory_bytes_used Used bytes of a given JVM memory area.\n# TYPE jvm_memory_bytes_used gauge\njvm_memory_bytes_used{area=\"heap\",} 1.2072508E8\njvm_memory_bytes_used{area=\"nonheap\",} 9.3550048E7\n# HELP jvm_memory_bytes_committed Committed (bytes) of a given JVM memory area.\n# TYPE jvm_memory_bytes_committed gauge\njvm_memory_bytes_committed{area=\"heap\",} 2.69484032E8\njvm_memory_bytes_committed{area=\"nonheap\",} 1.0133504E8\n# HELP jvm_memory_bytes_max Max (bytes) of a given JVM memory area.\n# TYPE jvm_memory_bytes_max gauge\njvm_memory_bytes_max{area=\"heap\",} 4.66092032E8\njvm_memory_bytes_max{area=\"nonheap\",} -1.0\n# HELP jvm_memory_pool_bytes_used Used bytes of a given JVM memory pool.\n# TYPE jvm_memory_pool_bytes_used gauge\njvm_memory_pool_bytes_used{pool=\"Code Cache\",} 1.4589888E7\njvm_memory_pool_bytes_used{pool=\"Metaspace\",} 6.9998048E7\njvm_memory_pool_bytes_used{pool=\"Compressed Class Space\",} 8962112.0\njvm_memory_pool_bytes_used{pool=\"PS Eden Space\",} 2.3732032E7\njvm_memory_pool_bytes_used{pool=\"PS Survivor Space\",} 6073592.0\njvm_memory_pool_bytes_used{pool=\"PS Old Gen\",} 9.0919456E7\n# HELP jvm_memory_pool_bytes_committed Committed bytes of a given JVM memory pool.\n# TYPE jvm_memory_pool_bytes_committed gauge\njvm_memory_pool_bytes_committed{pool=\"Code Cache\",} 1.47456E7\njvm_memory_pool_bytes_committed{pool=\"Metaspace\",} 7.5800576E7\njvm_memory_pool_bytes_committed{pool=\"Compressed Class Space\",} 1.0788864E7\njvm_memory_pool_bytes_committed{pool=\"PS Eden Space\",} 9.2274688E7\njvm_memory_pool_bytes_committed{pool=\"PS Survivor Space\",} 3.8797312E7\njvm_memory_pool_bytes_committed{pool=\"PS Old Gen\",} 1.38412032E8\n# HELP jvm_memory_pool_bytes_max Max bytes of a given JVM memory pool.\n# TYPE jvm_memory_pool_bytes_max gauge\njvm_memory_pool_bytes_max{pool=\"Code Cache\",} 2.5165824E8\njvm_memory_pool_bytes_max{pool=\"Metaspace\",} -1.0\njvm_memory_pool_bytes_max{pool=\"Compressed Class Space\",} 1.073741824E9\njvm_memory_pool_bytes_max{pool=\"PS Eden Space\",} 9.699328E7\njvm_memory_pool_bytes_max{pool=\"PS Survivor Space\",} 3.8797312E7\njvm_memory_pool_bytes_max{pool=\"PS Old Gen\",} 3.49700096E8\n```\n+\nIt shows all the JVM metrics that are published by the https://github.com/prometheus/client_java[Prometheus JVM Client]. The metrics generated by the application are not shown yet. It requires for the application to be accessed first.\n\nLet's access the JVM metrics in Prometheus dashboard first, and then we'll access the app to show app-specific metrics.\n\n=== Start Prometheus service\n\n. Make sure to terminate any previously running Prometheus endpoints:\n+\n docker service rm metrics\n+\n. Create a directory `prometheus` and change into that directory.\n. Create a text file `prometheus.yml` and add the following content:\n+\n```\nglobal:\n scrape_interval: 10s\nscrape_configs:\n - job_name: 'webapp'\n dns_sd_configs:\n - names: ['tasks.webapp_web']\n type: 'A'\n port: 8080\n```\n+\nThis defines the configuration for the HTTP endpoint that publishes Prometheus-style metrics from the Java application.\n+\n. Start Prometheus service:\n+\n```\ndocker service create \\\n --replicas 1 \\\n --network webapp_default \\\n --name metrics \\\n --mount type=bind,source=`pwd`/prometheus.yml,destination=/etc/prometheus/prometheus.yml \\\n --publish 9090:9090 \\\n prom/prometheus\n```\n+\nNote, this service is using the `webapp_default` overlay network that is created when the application stack was deployed.\n+\n. Access Prometheus dashboard at http://localhost:9090\n. Check the configured targets at http://localhost:9090/targets:\n+\nimage::prometheus-metrics-target4.png[]\n+\nIt shows that the application metrics HTTP endpoint is configured as a Prometheus target.\n\n=== View application metrics\n\n. On Prometheus dashboard, click on `-insert metric at cursor-` to see the list of metrics available:\n+\nimage::prometheus-metrics12.png[]\n+\nJVM metrics shown earlier are displayed here as well.\n+\n. Select `jvm_memory_pool_bytes_used` metric and click on `Execute` to view the metric.\n+\nimage::prometheus-metrics13.png[]\n+\n. Select `Graph` to view the graphical representation\n+\nimage::prometheus-metrics14.png[]\n+\n. Now access the application using `curl http://localhost:8080/resources/employees` a few times.\n. Refresh Prometheus dashboard and see the updated list of metrics:\n+\nimage::prometheus-metrics15.png[]\n+\nNote, `app*` and `requests*` that are generated by the application.\n+\n. Select `requests_get_all` metric and view the graph:\n+\nimage::prometheus-metrics16.png[]\n+\n. Access the application a few times using `curl http://localhost:8080/resources/employees/5` and then watch the `requests_get_one` metric.\n\n== Grafana\n\nhttps://github.com/grafana/grafana[Grafana] is an open source metric analytics & visualization suite. It supports many different storage backends, called as Data Source. Prometheus can be added as Grafana data source. It even provides support for runnning Prometheus queries from the Grafana dashboard as well. More details can be found in http://docs.grafana.org/features/datasources/prometheus/[Using Prometheus in Grafana].\n\n=== Start Grafana\n\nThis section will explain how to start Grafana, use Prometheus as the data source, and view some container metrics.\n\n. Start Grafana:\n+\n```\ndocker container run \\\n -d \\\n -p 3000:3000 \\\n --name=grafana \\\n -e \"GF_SECURITY_ADMIN_PASSWORD=secret\" \\\n grafana/grafana\n```\n+\nUse the login name `admin` and password `secret`.\n+\nRead more details about different http://docs.grafana.org/installation/configuration/[configuration options].\n+\n. Access Grafana dashboard at http://localhost:3000. Use the login and password as credentials to see Grafana console.\n+\nimage::grafana-metrics1.png[]\n\n=== Add Prometheus as data source\n\n. Click the `Add data source` button in the top header.\n. Specify the parameters as shown:\n+\nimage::grafana-metrics2.png[]\n+\n. Click on `Add` to test and save the data source:\n+\nimage::grafana-metrics3.png[]\n+\nThe green bar indicates that the data source was added successfully.\n\n=== Create chart with Prometheus data source\n\n. Click on `Create your first dashboard`, save it and give it a name, say `Docker and Java dashboard`\n. Click on `Graph`, edit, under the `Metrics` tab, select your Prometheus data source.\n. Enter the following Prometheus query expressions in the query field. The graphs will referesh in a few seconds and will look like as shown:\n+\nimage::grafana-metrics4.png[]\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/ch11-bigdata.adoc",
"content": ":toc:\n\n:imagesdir: images\n\n= Big Data Processing with Docker and Hadoop\n\n*PURPOSE*: This chapter explains how to use Docker to create a Hadoop cluster and a Big Data application in Java. It highlights several concepts like service scale, dynamic port allocation, container links, integration tests, debugging, etc.\n\nBig Data applications usually involve distributed processing using tools like Hadoop or Spark. These services can be scaled up, running with several nodes to support more parallelism. Running tools like Hadoop and Spark on Docker makes it easy to scale them up and down. This is very useful to simulate a cluster on development time and also to run integration tests before taking your application to production.\n\nThe application on this example reads a file, count how many words are on that file using a MapReduce job implemented on Hadoop and then saves the result on a MongoDB database. In order to do that, we will run a Hadoop cluster and a MongoDB server on Docker.\n\n[NOTE]\n====\nhttp://hadoop.apache.org/[Apache Hadoop] is an open-source software framework used for distributed storage and processing of big data sets using the MapReduce programming model. The core of Apache Hadoop consists of a storage part, known as Hadoop Distributed File System (HDFS), and a processing part which is a MapReduce programming model. Hadoop splits files into large blocks and distributes them across nodes in a cluster. It then transfers packaged code into nodes to process the data in parallel. The Hadoop framework itself is mostly written in Java.\n====\n\n== Clone the sample application\n\nClone the project at `https://github.com/fabianenardon/hadoop-docker-demo`\n\nInspect the `sample/docker/docker-compose.yml` file. It defines a MongoDB service and the services needed to run a Hadoop cluster. It also defines a service for our application. See how the services are linked together.\n\n== Build the application\n\n[source, text]\n----\ncd sample\nmvn clean install -Papp-docker-image\n----\n\nIn the command above, `-Papp-docker-image` will fire up the `app-docker-image` profile, defined in the application `pom.xml`. This profile will create a dockerized version of the application, creating two images:\n\n. `docker-hadoop-example`: docker image used to run the application\n. `docker-hadoop-example-tests`: docker image used to run integration tests\n\n== Start all the services\n\nGo to the `sample/docker` folder and start the services:\n\n cd docker\n docker-compose up -d\n\nSee the logs and wait until everything is up:\n\n docker-compose logs -f\n\nHere is a sample output:\n\n```\nAttaching to docker_nodemanager_1, docker-hadoop-example, yarn, secondarynamenode, docker_datanode_1, namenode, mongo\ndocker-hadoop-example | Usage: hdfs [--config confdir] [--loglevel loglevel] COMMAND\ndocker-hadoop-example | where COMMAND is one of:\n\n. . .\n\nnodemanager_1 | 17/10/11 18:26:27 INFO nodemanager.NodeManager: STARTUP_MSG: \ndocker-hadoop-example | zkfc run the ZK Failover Controller daemon\nnodemanager_1 | /************************************************************\ndocker-hadoop-example | datanode run a DFS datanode\nnodemanager_1 | STARTUP_MSG: Starting NodeManager\ndocker-hadoop-example | dfsadmin run a DFS admin client\ndatanode_1 | 17/10/11 18:26:25 INFO datanode.DataNode: STARTUP_MSG: \nnodemanager_1 | STARTUP_MSG: host = db2d63621ba4/172.23.0.8\nnamenode | FORMATTING NAMENODE\n\n. . .\n\nsecondarynamenode | STARTUP_MSG: Starting SecondaryNameNode\ndatanode_1 | STARTUP_MSG: build = https://git-wip-us.apache.org/repos/asf/hadoop.git -r b165c4fe8a74265c792ce23f546c64604acf0e41; compiled by 'jenkins' on 2016-01-26T00:08Z\ndocker-hadoop-example | oev apply the offline edits viewer to an edits file\nnamenode | STARTUP_MSG: build = https://git-wip-us.apache.org/repos/asf/hadoop.git -r b165c4fe8a74265c792ce23f546c64604acf0e41; compiled by 'jenkins' on 2016-01-26T00:08Z\nnodemanager_1 | 17/10/11 18:26:27 INFO nodemanager.NodeManager: registered UNIX signal handlers for [TERM, HUP, INT]\nsecondarynamenode | STARTUP_MSG: host = secondarynamenode/172.23.0.5\ndatanode_1 | STARTUP_MSG: java = 1.8.0_112\n\n. . .\n\nnamenode | 17/10/11 18:27:31 INFO namenode.TransferFsImage: Transfer took 0.00s at 0.00 KB/s\nnamenode | 17/10/11 18:27:31 INFO namenode.TransferFsImage: Downloaded file fsimage.ckpt_0000000000000000015 size 946 bytes.\nnamenode | 17/10/11 18:27:31 INFO namenode.NNStorageRetentionManager: Going to retain 2 images with txid >= 0\nsecondarynamenode | 17/10/11 18:27:32 INFO namenode.TransferFsImage: Uploaded image with txid 15 to namenode at http://namenode:50070 in 0.115 seconds\nsecondarynamenode | 17/10/11 18:27:32 WARN namenode.SecondaryNameNode: Checkpoint done. New Image Size: 946\n```\n\nIn order to see if everything is up, open `http://localhost:8088/cluster`. You should see 1 active node when everything is up and running.\n\nimage::docker-bigdata-03.png[]\n\n== Running the application\n\nThis application reads a text file from HDFS and counts how many words it has. The result is saved on MongoDB.\n\nFirst, create a folder on HDFS. We will save the file to be processed on it:\n\n docker-compose exec yarn hdfs dfs -mkdir /files/\n\nIn the command above, we are executing `hdfs dfs -mkdir /files/` on the service `yarn`. This command creates a new folder called `/files/` on HDFS, the distributed file system used by Hadoop.\n\nPut the file we are going to process on HDFS:\n\n[source, text]\n----\ndocker-compose run docker-hadoop-example \\\n hdfs dfs -put /maven/test-data/text_for_word_count.txt /files/\n----\n\nThe `text_for_word_count.txt` file was added to the application image by maven when we built it, so we can use it to test. The command above will transfer the `text_for_word_count.txt` file from the local disk to the `/files/` folder on HDFS, so the Hadoop process can access it.\n\nRun our application\n\n[source, text]\n----\ndocker-compose run docker-hadoop-example \\\n hadoop jar /maven/jar/docker-hadoop-example-1.0-SNAPSHOT-mr.jar \\\n hdfs://namenode:9000 /files mongo yarn:8050\n----\n\nThe command above will run our jar file on the Hadoop cluster. The `hdfs://namenode:9000` parameter is the HDFS address. The `/files` parameter is where the file to process can be found on HDFS. The `mongo` parameter is the MongoDB host address. The `yarn:8050` parameter is the Hadoop yarn address, where the MapReduce job will be deployed. Note that since we are running the Hadoop components (namenode, yarn), MongoDB and our application as Docker services, they can all find each other and we can use the service names as host addresses.\n\nIf you go to `http://localhost:8088/cluster`, you can see your job running. When the job finishes, you should see this:\n\nimage::docker-bigdata-04.png[]\n\nIf everything ran successful, you should be able to see the results on MongoDB.\n\nConnect to the Mongo container:\n\n docker-compose exec mongo mongo\n\nWhen connected, type:\n\n[source, text]\n----\nuse mongo_hadoop\ndb.word_count.find();\n----\n\nYou should see the results of running the application. Something like this:\n\n[source, text]\n----\n> db.word_count.find();\n{ \"_id\" : \"Counts on Sat Mar 18 18:16:20 UTC 2017\", \"words\" : 256 }\n----\n\n== Scaling the Hadoop cluster\n\n\nIf you want, you can scale your cluster, adding more Hadoop nodes to it:\n\n docker-compose scale nodemanager=2\n\nThis means that you want to have 2 nodes in your Hadoop cluster. Go to `http://localhost:8088/cluster` and refresh until you see 2 active nodes.\n\nThe trick to scale the nodes is to use dynamically allocated ports and let docker assign a different port to each new nodemanager. See this approach in this snippet of the `docker-compose.yml` file:\n\n[source, text]\n----\nnodemanager:\n image: tailtarget/hadoop:2.7.2\n command: yarn nodemanager\n ports:\n - \"8042\" # local port dynamically assigned. allows node to be scaled up and down\n links:\n - namenode\n - datanode\n - yarn\n hostname: nodemanager\n----\n\n== Stopping the services\n\nStop all the services\n\n docker-compose down\n\nNote that since our `docker-compose.yml` file defines volume mappings for HDFS and MongoDB, next time you start the services again, your data will still be there.\n\n\n== Debugging your code\n\nDebugging distributed Hadoop applications can be cumbersome. However, you can configure your environment to use the docker Hadoop cluster and debug your code easily from an IDE.\n\nFirst, make sure your services are up:\n\n docker-compose up -d\n\nThen, add this to your `/etc/hosts`:\n\n[source, text]\n----\n127.0.0.1 datanode\n127.0.0.1 yarn\n127.0.0.1 namenode\n127.0.0.1 secondarynamenode\n127.0.0.1 nodemanager\n----\n\nThis configuration will allow you to access the docker Hadoop cluster from your IDE.\n\nThen, open your project from https://github.com/fabianenardon/hadoop-docker-demo in Netbeans (or any other IDE) and run the application file:\n\nimage::docker-bigdata-01.png[]\n\nNote that you will be connecting to the docker services at localhost.\n\nYou can also set a breakpoint in your application and debug:\n\nimage::docker-bigdata-02.png[]\n\nimage::docker-bigdata-05.png[]\n\nShutdown the services:\n\n docker-compose down\n\n== Integration tests\n\nWhen running integration tests, you want to test your application in an environment as close to production as possible, so you can test interactions between the several components, services, databases, network communication, etc. Fortunately, docker can help you a lot with integration tests.\n\nThere are several strategies to run integration tests, but in this application we are going to use the following:\n\n. Start the services with a `docker-compose.yml` file created for testing purposes. This file won't have any volumes mapped, so when the test is over, no state will be saved. The test `docker-compose.yml` file won't publish any port on the host machine, so we can run simultaneous tests.\n. Run the application, using the services started with the `docker-compose.yml` test file.\n. Run Maven integration tests to check if the application execution produced the expected results. This will be done by checking what was saved on the MongoDB database.\n. Stop the services. No state will be stored, so next time you run the integration tests, you will have a clean environment.\n\nHere is how to execute this strategy, step by step. The complete source code for this is in the `sample` directory of https://github.com/fabianenardon/hadoop-docker-demo.\n\nStart the services with the test configuration:\n\n[source, text]\n----\ndocker-compose --file src/test/resources/docker-compose.yml up -d\n----\n\nMake sure all services are started and create the folder we need on hdfs to test:\n\n[source, text]\n----\ndocker-compose --file src/test/resources/docker-compose.yml exec yarn hdfs dfs -mkdir /files/\n----\n\nPut the test file on hdfs:\n\n[source, text]\n----\ndocker-compose --file src/test/resources/docker-compose.yml \\\n run docker-hadoop-example \\\n hdfs dfs -put /maven/test-data/text_for_word_count.txt /files/\n----\n\nRun the application\n\n[source, text]\n----\ndocker-compose --file src/test/resources/docker-compose.yml \\\n run docker-hadoop-example \\\n hadoop jar /maven/jar/docker-hadoop-example-1.0-SNAPSHOT-mr.jar \\\n hdfs://namenode:9000 /files mongo yarn:8050\n----\n\nRun our integration tests:\n\n[source, text]\n----\ndocker-compose --file src/test/resources/docker-compose.yml \\\n run docker-hadoop-example-tests mvn -f /maven/code/pom.xml \\\n -Dmaven.repo.local=/m2/repository -Pintegration-test verify\n----\n\nStop all the services:\n\n[source, text]\n----\ndocker-compose --file src/test/resources/docker-compose.yml down\n----\n\nIf you want to remote debug tests, run the tests this way instead:\n\n[source, text]\n----\ndocker run -v ~/.m2:/m2 -p 5005:5005 \\\n --link mongo:mongo \\\n --net resources_default \\\n docker-hadoop-example-tests \\\n mvn -f /maven/code/pom.xml \\\n -Dmaven.repo.local=/m2/repository \\\n -Pintegration-test verify \\\n -Dmaven.failsafe.debug\n----\n\nRunning with this configuration, the application will wait until an IDE connects for remote debugging on port 5005.\n\nSee more about integration tests in the link:./ch09-cicd.adoc[CI/CD using Docker] chapter\n\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/readme.adoc",
"content": "= Docker for Java Developers\n\nThis tutorial offers Java developers an intro-level and self-paced hands-on workshop with Docker.\n\n* link:chapters/ch01-setup.adoc[Setup Environments]\n* link:chapters/ch02-basic-concepts.adoc[Docker Basic Concepts]\n* Building\n** link:chapters/ch03-build-image.adoc[Build a Docker Image]\n** link:chapters/ch03-build-image-java-9.adoc[Build a Docker Image for Java 9]\n* link:chapters/ch04-run-container.adoc[Run a Docker Container]\n* link:chapters/ch05-compose.adoc[Multi-container application using Docker Compose]\n* link:chapters/ch06-swarm.adoc[Multi-container application using Compose and Swarm Mode]\n* Java IDEs\n** link:chapters/ch07-netbeans.adoc[Docker Tooling in NetBeans]\n** link:chapters/ch07-intellij.adoc[Docker Tooling in IntelliJ IDEA]\n** link:chapters/ch07-eclipse.adoc[Docker Tooling in Eclipse]\n* Multi-container application on multi-host\n** link:chapters/ch08-aws.adoc[Docker for AWS]\n** link:chapters/ch08-azure.adoc[Docker for Azure] (coming)\n** link:chapters/ch08-cloud.adoc[Docker Cloud]\n* link:chapters/ch09-cicd.adoc[CI/CD using Docker]\n* link:chapters/ch10-monitoring.adoc[Monitoring Docker Containers with Prometheus and Grafana]\n* link:chapters/ch11-bigdata.adoc[Big Data Processing with Docker and Hadoop]\n* link:chapters/appa-common-commands.adoc[Common Docker Commands]\n* link:chapters/appb-troubleshooting.adoc[Troubleshooting]\n* link:chapters/appc-references.adoc[References]\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/scripts/docker-compose-pull-images.yml",
"content": "version: '3'\nservices:\n ubuntu:\n image: ubuntu:latest\n busybox:\n image: busybox:latest\n openjdk:\n image: openjdk:latest\n wildfly:\n image: jboss/wildfly:latest\n javaee7-hol:\n image: arungupta/javaee7-hol:latest\n docker-javaee:\n image: arungupta/docker-javaee:dockerconeu17\n mysql:\n image: mysql:8\n hadoop:\n image: tailtarget/hadoop:2.7.2\n jenkins:\n image: jenkins/jenkins:lts\n prometheus:\n image: prom/prometheus:latest\n node-exporter:\n image: prom/node-exporter\n cadvisor:\n image: google/cadvisor:latest\n grafana:\n image: grafana/grafana\n debian:\n image: debian:stable-slim\n alpine:\n image: alpine:3.6\n openjdk-slim:\n image: openjdk:9-jdk-slim\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/Eclipse-README.md",
"content": "## In-container Java Development: Eclipse\n\n### Pre-requisites\n\n* [Docker for OSX or Docker for Windows](https://www.docker.com/products/docker)\n* [Eclipse](http://www.eclipse.org/downloads/) (install Eclipse IDE for Java EE Developers)\n* [Java Development Kit](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)\n* [Maven for Eclipse](http://www.eclipse.org/m2e/) (see instructions for adding the Maven plug-in to Eclipse)\n\n### Getting Started\n\nOn the command line clone the [registration-docker](https://github.com/docker/labs) repository\n\n```\ngit clone https://github.com/docker/labs\ncd labs/developer-tools/java-debugging\n```\n\nIn Eclipse, import the app directory of that project as an existing maven project\n\n`File`> `Import` Select `Maven`> `Existing Maven Projects`> `Next`\n\n\n \n \nSelect the app subdirectory of the directory where you cloned the project.\n \n\n \n \nSelect the pom.xml from the app directory, click `Finish`. \n \n\n\n\n### Building the application\n\nThe application is a basic Spring MVC application that receives user input from a form, writes the data to a database, and queries the database.\n\nThe application is built using Maven. To build the application click on `Run` > `Run configurations`\n\n\n\nSelect `Maven build` > `New`\n\n\n\nEnter a `Name` for the configuration.\n\nSet the base direct of the application `/registration-docker/app`.\n\nSet the `Goals` to `clean install`.\n\nClick `Apply`\n\nClick `Run`\n\n\n\nThe results of the build will be displayed in the console.\n\n\n\n### Running the application\n\nOpen a terminal and go to the application directory. Start the application with docker-compose\n\n
> docker-compose up
\n\nDocker will build the images for Apache Tomcat and MySQL and start the containers. It will also mount the application directory (`./app/target/UserSignup`) as a data volume on the host system to the Tomcat webapps directory in the web server container.\n\nOpen a browser window and go to:\n'localhost:8080'; you should see the Tomcat home page\n\n\n\nWhen the Tomcat image was built, the user roles were also configured. Click on the `Manager App` button to see the deployed applications. When prompted for username and password, enter `system` and `manager` respectively to log into the Tomcat Web Application Manager page.\n\n\n\nYou can use the Manager page to `Start`, `Stop`, `Reload` or `Undeploy` web applications.\n\nTo go to the application, Click on `/UserSignup` link.\n\n\n\n### Debugging the Application\n\nIn the application, click on `Signup` to create a new user. Fill out the registration form and click `Submit`\n\n\n\nClick `Yes` to confirm.\n\n\n\nTest out the login.\n\n\n\nOh no!\n\n\n\n#### Configure Remote Debugging\n\nTomcat supports remote debugging the Java Platform Debugger Architecture (JPDA). Remote debugging was enabled when the tomcat image (registration-webserver) was built.\n\nTo configure remote debugging in Eclipse, click on `Run` > `Debug Configurations ...`\n\n\n\nSelect `Remote Java Application` and click on `Launch New Configuration` icon\n\n\n\nEnter a `Name` for the configuration. Select the project using the `browse` button. Click on `Apply` to save the configuration and click on `Debug` to start the debugging connection between Tomcat and Eclipse.\n\n\n\n#### Finding the Error\n\nSince the problem is with the password, lets see how the password is set in the User class. In the User class, the setter for password is scrambled using [rot13](https://en.wikipedia.org/wiki/ROT13) before it is saved to the database.\n\n\n\nTry registering a new user using the debugger. In Eclipse, change the view or Perspective to the debugger by clicking on `Window` > `Perspective` > `Open Perspective` > `Debug`\n\n\n\nEclipse will switch to the debug perspective. Since we enable remote debugging earlier, you should see the Daemon Threads for Tomcat in the debug window. Set a breakpoint for in the User class where the password is set.\n\n\n\nRegister a new user with the username of 'Moby' and with 'm0by' as the password, click `Submit`, click `yes`\n\n\n\nEclipse will display the code at the breakpoint and the value of password in the variables window. Note that the value is `m0by`\n\n\n\nClick on `resume` or press `F8` to let the code run.\n\n\n\nNext, set a breakpoint on the getPassword in the User class to see the value returned for password. You can also toggle off the breakpoint for setPassword.\n\n\n\nTry to log into the application. Look at the value for password in the Eclipse variables window, note that it is `z0ol` which is `m0by` using ROT13.\n\n\n\nIn this MVC application the UserController uses the findByLogin method in the UserServiceImpl class which uses the findByUsername method to retrieve the information from the database. It then checks to see if the password from the form matches the user password. Since the password from the login form is not scrambled using ROT13, it does not match the user password and you cannot log into the application.\n\nTo fix this, apply ROT13 to the password by adding an import near the top of the file\n\n```\nimport com.docker.UserSignup.util.Rot13\n```\n\nand replace the contents of `findByLogin` with\n\n```\npublic boolean findByLogin(String userName, String password) { \n User usr = userRepository.findByUserName(userName);\n\n String passwd = Rot13.rot13(password);\n\n if(usr != null && usr.getPassword().equals(passwd)) {\n return true;\n }\n\n return false;\n}\n```\n\n\n\nSet a breakpoint in UserServiceImpl on the findByLogin method. Log in again and look at the values for the breakpoint. The 'passwd' variable is `z0ol` which matches the password for the user moby.\n\n\n\nContinue (`F8`) and you should successfully log in.\n\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/Eclipse-README_es.md",
"content": "## Desarrollo Java: Eclipse\n\n### Pre-requisitos\n\n* [Docker for OSX or Docker for Windows](https://www.docker.com/products/docker)\n* [Eclipse](http://www.eclipse.org/downloads/) (instalar Eclipse IDE para desaroolladores Java EE)\n* [Java Development Kit](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)\n* [Maven for Eclipse](http://www.eclipse.org/m2e/) (ver instrucciones para agregar Maven plug-in en Eclipse)\n\n### Empezando\n\nEn Eclipse, clonar el repositorio [registration-docker](https://github.com/spara/registration-docker.git)\n\n`File`> `Import`\nSeleccionar `Git`> `Projects`> `Next`\n\n\n\nSeleccionar `Clone URI`> `Next`\n\n\n\nIngresar la [`url del repositorio`](https://github.com/spara/registration-docker.git)> `Next`\n\n\n\n`Seleccionar el branch master`> `Next`\n\n\n\n`Ingresar destination directory`> `Next`\n\n\n\nSeleccionar el asistente de importación, `Import existing Eclipse project`> `Next`\n\n\n\nSeleccionar `registration-docker`> `Finish`\n\n\n\n### Construyendo la aplicación\n\nLa aplicación es una aplicación Spring MVC básica que recibe datos del usuario de un formulario, almacena los datos en la base de datos, y realiza consultas.\n\nLa aplicación se construye usando Maven. Para construir la aplicación hacer clic en `Run` > `Run configurations`\n\n\n\nSeleccionar `Maven build` > `New`\n\n\n\nIngresar `Name` para la configuración.\n\nEstablecer el directorio base de la aplicación `/registration-docker/app`.\n\nEstablecer `Goals` a `clean install`.\n\nClic `Apply`\n\nClic `Run`\n\n\n\nLos resultados del build serán mostrados en la consola.\n\n\n\n### Ejecutando la aplicación\n\nAbrir un terminal e ir al directorio de la aplicación. Iniciar la aplicación con docker-compose\n\n
> docker-compose up
\n\nDocker construirá las imágenes para Apache Tomcat y MySQL e iniciará los contenedores. También, montará el directorio de la aplicación (`./app/target/UserSignup`) como volumen de datos en el host del sistema al directorio webapps Tomcat en el contenedor del servidor web.\n\nAbrir una ventana en el explorador e ir a:\n'localhost:8080'; debe ver la página de inicio de Tomcat\n\n\n\nCuando la imagen de Tomcat fue construida, los roles de los usuarios fueron configurados. Clic en el botón `Manager App` para visualizar las aplicaciones desplegadas. Cuando se solicite por usuario y contraseña, ingresar `system` y `manager` respectivamente para entrar a la página de Tomcat Web Application Manager.\n\n\n\nEs posible usar la página Manager para `Start`, `Stop`, `Reload` o `Undeploy` aplicaciones web.\n\nPara ir a la aplicación, clic en el link `/UserSignup`.\n\n\n\n### Depurando la Aplicación\n\nEn la aplicación, clic en `Signup` para crear un nuevo usuario. Completar el formulario de registro y hacer clic en `Submit`\n\n\n\nClic `Yes` para confirmar.\n\n\n\nProbar el inicio de sesión.\n\n\n\nOh no!\n\n\n\n#### Configurar Depuración Remota\n\nTomcat soporta depuración remota usando Java Platform Debugger Architecture (JPDA). Debug Remoto fue habilitado cuando la imagen tomcat (registration-webserver) fue construida.\n\nPara configurar la depuración remota en Eclipse, clic en `Run` > `Debug Configurations ...`\n\n\n\nSeleccionar `Remote Java Application` y clic en el icono `Launch New Configuration`\n\n\n\nIngresar `Name` para la configuración. Seleccionar el proyecto usando el botón `browse`. Clic en `Apply` para guardar la configuración y clic en `Debug` para iniciar la conexión de debug entre Tomcat y Eclipse.\n\n\n\n#### Buscando el Error\n\nDado que el problema es la contraseña, hay que ver como la contraseña se establece en la clase User. En la clase User, el setter para la contraseña es mezclado usando [rot13](https://en.wikipedia.org/wiki/ROT13) antes de ser almacenado en la base de datos.\n\n\n\nTratar registrando un nuevo usuario usando el depurador. En Eclipse, cambiar la vista o perspectiva del depurador haciendo clic en `Window` > `Perspective` > `Open Perspective` > `Debug`\n\n\n\nEclipse cambiará a la perspectiva debug. Dado que habilitamos el depurador remoto previamente, debes ver los Daemon Threads para Tomcat en la ventana de debug. Establece un punto de interrupción para la clase User donde el password es establecido.\n\n\n\nRegistrar un nuevo usuario con el usuario de 'Moby' y con 'm0by' como contraseña, clic `Submit`, clic `yes`\n\n\n\nEclipse mostrará el código en el punto de interrupción y el valor de la contraseña en la ventana variables. Observar que el valor es `m0by`\n\n\n\nClic en `resume` o presionar `F8` para permitir ejecutar el código.\n\n\n\nA continuación, establecer el punto de interrupción en getPassword en la clase User para ver los valores retornados para la contraseña. También puede cambiar el punto de interrupción para setPassword.\n\n\n\nTratar de acceder a la aplicación. Ver el valor de la contraseña en la ventana variables de Eclipse, observar que es `z0ol` el cual es `m0by` usando ROT13.\n\n\n\nEn esta aplicación MVC el UserController usa el método findByLogin en la clase UserServiceImpl la cual usa el método findByUsername para recuperar la información de la base de datos. A continuación, verificar que la contraseña del formulario coincide con la contraseña del usuario. Dado que la contraseña del formulario de inicio de sesión no es mezclada usando ROT13, este no coincide con la contraseña del usuario y no es posible acceder a la aplicación.\n\nPara solucionar esto, aplicar ROT13 a la contraseña agregando\n\n```\nimport com.docker.UserSignup.utit.Rot13\n\nString passwd = Rot13.rot13(password);\n```\n\n\nEstablecer un punto de interrupción en UserServiceImpl en el método findByLogin. Iniciar sesión otra vez y verificar los valores para el punto de interrupción. La variable 'passwd' es 'z0ol' la cual coincide con la contraseña para el usuario moby.\n\n\n\nContinuar (`F8`) y debe acceder exitosamente.\n\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/IntelliJ-README.md",
"content": "## In-container Java Development: IntelliJ Community Edition\n\n### Pre-requisites\n\n* [Docker for OSX or Docker for Windows](https://www.docker.com/products/docker)\n* [IntelliJ Community Edition](https://www.jetbrains.com/idea/download/)\n* [Java Development Kit](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)\n\n\n### Getting Started\n\nIn IntelliJ, clone the repository. Click on `Check out from Version Control` > `Github`\n\n\n\nIf this the first time to use IntelliJ with Github, log into your Github account.\n\n\nOn the command line clone the [docker/labs](https://github.com/docker/labs) repository\n \n\nClick on `Import project from external model`, select `Maven`. Click `Next`\n\n\n\nCheck `Search for projects recursively`. Click `Next`\n\n\n\nSelect the project and click `Next`\n\n\n\nSelect the JDK(set the `JDK home path`) and click `Next`\n\n\n\nClick `Finish`\n\n\n\nClick on `Project View` to open the project.\n\n\n\n### Building the application\n\nThe application is a basic Spring MVC application that receives user input from a form, writes the data to a database, and queries the database.\n\nThe application is built using Maven. To build the application click on icon on the bottom left of the IntelliJ window and select `Maven Projects`.\n\n\n\nThe `Maven Projects` window will open on the right side. Maven goals of `clean` and `install` need to be set to build the application.\n\nTo set the `clean` goal, click on `Lifecycle` to display the tree of goals. Right click on `clean` and select `Create 'UserSignup [clean]'...`\n\n\n\nClick `OK` in the `Create Run/Debug Configuration` window.\n\n\n\nConfigure the `install` goal similarly. Click on `install` in the Lifecycle tree. Select `Create 'UserSignup[install]'...`\n\n\n\nClick `OK` in the `Create Run/Debug Configuration` window.\n\n\n\nTo build the application run `clean`\n\n\n\nThen run `install`\n\n\n\nWhen the application builds, you will see a success message in the log window.\n\n\n\n### Running the application\n\nOpen a terminal and go to the application directory. Start the application with docker-compose\n\n
> docker-compose up
\n\nDocker will build the images for Apache Tomcat and MySQL then start the containers. It will also mount the application directory (`./app/target/UserSignup`) as a data volume on the host system to the Tomcat webapps directory in the web server container.\n\nOpen a browser window and go to:\n'localhost:8080'; you should see the Tomcat home page\n\n\n\nWhen the Tomcat image was built, the user roles were also configured. Click on the `Manager App` button to see the deployed applications. When prompted for username and password, enter `system` and `manager` respectively to log into the Tomcat Web Application Manager page.\n\n\n\nYou can use the Manager page to `Start`, `Stop`, `Reload` or `Undeploy` web applications.\n\nTo go to the application, Click on `/UserSignup` link.\n\n\n\n### Debugging the Application\n\nIn the application, click on `Signup` to create a new user. Fill out the registration form and click `Submit`\n\n\n\nClick `Yes` to confirm.\n\n\n\nTest out the login.\n\n\n\nOh no!\n\n\n\n#### Configure Remote Debugging\n\nTomcat supports remote debugging the Java Platform Debugger Architecture (JPDA). Remote debugging was enabled when the tomcat image (registration-webserver) was built.\n\nTo configure remote debugging in IntelliJ, click on `Run` > `Edit Configuration ...`\n\n\n\nAdd a new remote configuration.\n\n\n\nIn the `Run\\Debug Configurations` window, set the `Name` of the configuration as `docker tomcat` and in `Settings` set the port to '8000' as the default Tomcat JPDA debuging port. Click on `OK` to save the configuration.\n\n\n\n#### Finding the Error\n\nSince the problem is with the password, let's see how the password is set in the User class. In the User class, the setter for password is scrambled using [rot13](https://en.wikipedia.org/wiki/ROT13) before it is saved to the database.\n\n\n\nTry registering a new user using the debugger. In the menu click on `Run` > `Debug...`\n\n\n\nChoose the remote Tomcat debug configuration. The Debugger console will be displayed at the bottom of the IntelliJ window.\n\n\n\nSet a breakpoint in the User class where the password is set.\n\n\n\nRegister a new user with the username of 'Moby' and with 'm0by' as the password, click `Submit`, click `yes`\n\n\n\nIntelliJ will display the code at the breakpoint and the value of password in the variables window. Note that the value is `m0by`\n\n\n\nClick on `Resume Program` to let the code run or press `F8` to step over the breakpoint.\n\n\n\nNext, set a breakpoint on the getPassword in the User class to see the value returned for password. You can also toggle off the breakpoint for setPassword.\n\n\n\nTry to log into the application. Look at the value for password in the debugging console, note that it is `z0ol` which is `m0by` using ROT13.\n\n\n\nIn this MVC application the UserController uses the findByLogin method in the UserServiceImpl class which uses the findByUsername method to retrieve the information from the database. It then checks to see if the password from the form matches the user password. Since the password from the login form is not scrambled using ROT13, it does not match the user password and you cannot log into the application.\n\nTo fix this, apply ROT13 to the password by adding\n\n```\nimport com.docker.UserSignup.utit.Rot13\n\nString passwd = Rot13.rot13(password);\n```\n\n\nSet a breakpoint in UserServiceImpl on the findByLogin method. Log in again and look at the values for the breakpoint. The 'passwd' variable is `z0ol` which matches the password for the user moby.\n\n\n\nContinue (`F8`) and you should successfully log in.\n\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/IntelliJ-README_es.md",
"content": "## Desarrollo Java en Contenedor: IntelliJ Community Edition\n\n### Pre-requisitos\n\n* [Docker for OSX or Docker for Windows](https://www.docker.com/products/docker)\n* [IntelliJ Community Edition](https://www.jetbrains.com/idea/download/)\n* [Java Development Kit](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)\n\n\n### Empezando\n\nEn IntelliJ, clonar el repositorio. Clic en `Check out from Version Control` > `Github`\n\n\n\nSi esta es la primera vez usando Intellij con Github, ingresar a la cuenta de Github.\n\n\nClonar el repositorio [registration-docker](https://github.com/spara/registration-docker.git).\n\n\nClic en `Import project from external model`, seleccionar `Maven`. Clic `Next`\n\n\n\nSeleccionar `Search for projects recursively`. Clic `Next`\n\n\n\nSeleccionar el proyecto y clic en `Next`\n\n\n\nSeleccionar el JDK y clic en `Next`\n\n\n\nClic en `Finish`\n\n\n\nClic en `Project View` para abrir el proyecto.\n\n\n\n### Construyendo la aplicación\n\nLa aplicación es una aplicación Spring MVC básica que recibe datos del usuario de un formulario, almacena los datos en la base de datos, y realiza consultas.\n\nLa aplicación se construye usando Maven. Para construir la aplicación clic en el icono de la parte inferior izquierda de IntelliJ y seleccionar `Maven Projects`.\n\n\n\nLa ventana `Maven Projects` se abrirá al lado derecho. Las tareas de maven `clean` y `install` necesitan ser establecidas para construir la aplicación.\n\nPara establecer la tarea `clean`, clic en `Lifecycle` para visualizar el árbol de tareas. Clic derecho en `clean` y seleccionar `Create 'UserSignup [clean]'...`\n\n\n\nClic `OK` en la ventana `Create Run/Debug Configuration`.\n\n\n\nDe manera similar configurar la tarea `install`. Clic en `install` en el árbol de Lifecycle. Seleccionar `Create 'UserSignup[install]'...`\n\n\n\nClic `OK` en la ventana `Create Run/Debug Configuration`.\n\n\n\nPara construir la aplicación ejecutar `clean`\n\n\n\nLuego ejecutar `install`\n\n\n\nCuando la aplicación se construya se visualizará un mensaje de éxito en la ventana de Log.\n\n\n\n### Ejecutando la aplicación\n\nAbrir un terminal e ir al directorio de la aplicación. Iniciar la aplicación con docker-compose\n\n
> docker-compose up
\n\nDocker construirá las imágenes para Apache Tomcat y MySQL e iniciará los contenedores. También, montará el directorio de la aplicación (`./app/target/UserSignup`) como volumen de datos en el host del sistema al directorio webapps Tomcat en el contenedor del servidor web.\n\nAbrir una ventana en el explorador e ir a:\n'localhost:8080'; debes ver la página de inicio de Tomcat\n\n\n\nCuando la imagen de Tomcat fue construida, los roles de los usuarios fueron configurados. Clic en el botón `Manager App` para visualizar las aplicaciones desplegadas. Cuando se solicite el usuario y la contraseña, ingresar `system` y `manager` respectivamente para entrar a la página de Tomcat Web Application Manager.\n\n\n\nEl posible usar la página Manager para `Start`, `Stop`, `Reload` o `Undeploy` aplicaciones web.\n\nPara ir a la aplicación, clic en el link `/UserSignup`.\n\n\n\n### Depurando la aplicación\n\nEn la aplicación, clic en `Signup` para crear un nuevo usuario. Completar el formulario de registro y clic en `Submit`\n\n\n\nClic `Yes` para confirmar.\n\n\n\nProbar el inicio de sesión.\n\n\n\nOh no!\n\n\n\n#### Configurar Depuración Remota\n\nTomcat soporta depuración remota usando Java Platform Debugger Architecture (JPDA). Debug Remoto fue habilitado cuando la imagen tomcat (registration-webserver) fue construida.\n\nPara configurar la depuración remota en IntelliJ, clic en `Run` > `Edit Configuration ...`\n\n\n\nAgregar una nueva configuración remota.\n\n\n\nEn la ventana `Run\\Debug Configurations`, establecer el `Name` de la configuración y en `Settings` establecer el puerto '8000' el puerto de depuración de Tomcat JPDA por defecto. Clic en `OK` para guardar la configuración.\n\n\n\n#### Buscando el Error\n\nDado que el problema es la contraseña, veamos como la contraseña se establece en la clase User. En la clase User, el setter para la contraseña es mezclado usando [rot13](https://en.wikipedia.org/wiki/ROT13) antes de ser almacenado en la base de datos.\n\n\n\nTratar registrando un nuevo usuario usando el depurador. En el menu clic en `Run` > `Debug...`\n\n\n\nElegir la configuración de depuración remota de Tomcat. La consola de depuración se motrará en la parte inferior de IntelliJ.\n\n\n\nEstablecer un punto de interrupción para la clase User donde el password es establecido.\n\n\n\nRegistrar un nuevo usuario con el usuario de 'Moby' y con 'm0by' como contraseña, clic `Submit`, clic `yes`\n\n\n\nIntelliJ mostrará el código en el punto de interrupción y el valor de la contraseña en la ventana variables. Observar que el valor es `m0by`\n\n\n\nClic en `Resume Program` para permitir ejecutar el código o presionar `F8` para saltar el punto de interrupción.\n\n\n\nA continuación, establecer el punto de interrupción en getPassword en la clase User para ver los valores retornados para la contraseña. También es posible cambiar el punto de interrupción a setPassword.\n\n\n\nTratar de acceder a la aplicación. Ver el valor de la contraseña en la ventana variables de Eclipse, observar que es `z0ol` el cual es `m0by` usando ROT13.\n\n\n\nEn esta aplicación MVC el UserController usa el método findByLogin en la clase UserServiceImpl la cual usa el método findByUsername para recuperar la información de la base de datos. A continuación, verificar que la contraseña del formulario conincide con la contraseña del usuario. Dado que la contraseña del formulario de inicio de sesión no es mezclada usando ROT13, este no coincide con la contraseña del usuario y no es posible acceder a la aplicación.\n\nPara solucionar esto, aplicar ROT13 a la contraseña agregando\n\n```\nimport com.docker.UserSignup.utit.Rot13\n\nString passwd = Rot13.rot13(password);\n```\n\n\nEstablecer un punto de interrupción en UserServiceImpl en el método findByLogin. Iniciar sesión otra vez y verificar los valores para el punto de interrupción. La variable 'passwd' es 'z0ol' la cual coincide con la contraseña para el usuario moby.\n\n\n\nContinuar (`F8`) y debe acceder exitosamente.\n\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/NetBeans-README.md",
"content": "## In-container Java Development: NetBeans IDE\n\n### Pre-requisites\n\n* [Docker for OSX or Docker for Windows](https://www.docker.com/products/docker)\n* [NetBeans IDE](https://netbeans.org/downloads/)\n* [Java Development Kit](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)\n\n### Getting Started\n\nUsing your git client clone the repository.\n\n```\ngit clone https://github.com/docker/labs\ncd labs/developer-tools/java-debugging\n```\n\nOpen NetBeans IDE, Click on `Open Project...`\n\n\n\nSelect `app` and click on `Open Project`.\n\n\n\n### Building the application\n\nThe application is a basic Spring MVC application that receives user input from a form, writes the data to a database, and queries the database.\n\nThe application is built using Maven. To build the application click on `Run` > `Build Project`.\n\n\n\nThe results of the build will be displayed in the console.\n\n\n\n### Running the application\n\nOpen a terminal and go to the application directory. Start the application with docker-compose\n\n
> docker-compose up
\n\nDocker will build the images for Apache Tomcat and MySQL and start the containers. It will also mount the application directory (`./app/target/UserSignup`) as a data volume on the host system to the Tomcat webapps directory in the web server container.\n\nOpen a browser window and go to:\n'localhost:8080'; you should see the Tomcat home page\n\n\n\nWhen the Tomcat image was built, the user roles were also configured. Click on the `Manager App` button to see the deployed applications. When prompted for username and password, enter `system` and `manager` respectively to log into the Tomcat Web Application Manager page.\n\n\n\nYou can use the Manager page to `Start`, `Stop`, `Reload` or `Undeploy` web applications.\n\nTo go to the application, Click on `/UserSignup` link.\n\n\n\n### Debugging the Application\n\nIn the application, click on `Signup` to create a new user. Fill out the registration form and click `Submit`\n\n\n\nClick `Yes` to confirm.\n\n\n\nTest out the login.\n\n\n\nOh no!\n\n\n\n#### Configure Remote Debugging\n\nIn the menu click on `Debug` > `Attach Debugger...`\n\n\n\nMake sure that the port is set to 8000, click on `OK`.\n\n\n\n#### Finding the Error\n\nSince the problem is with the password, lets see how the password is set in the User class. In the User class, the setter for password is scrambled using [rot13](https://en.wikipedia.org/wiki/ROT13) before it is saved to the database.\n\nSince we enabled remote debugging earlier, you should see the Daemon Threads for Tomcat in the `Debugging` window. Set a breakpoint for in the User class where the password is set.\n\n\n\nRegister a new user with the username of 'Moby' and with 'm0by' as the password, click `Submit`, click `yes`\n\n\n\nNetBeans will display the code at the breakpoint and the value of password in the variables window. Note that the value is `m0by`\n\n\n\nClick on `Continue` icon or press `F5` to let the code run.\n\n\n\nNext, set a breakpoint on the getPassword in the User class to see the value returned for password. You can also toggle off the breakpoint for setPassword. Try to log into the application. Look at the value for password in the NetBeans variables window, note that it is `z0ol` which is `m0by` using ROT13.\n\n\n\nIn this MVC application the UserController uses the findByLogin method in the UserServiceImpl class which uses the findByUsername method to retrieve the information from the database. It then checks to see if the password from the form matches the user password. Since the password from the login form is not scrambled using ROT13, it does not match the user password and you cannot log into the application.\n\nTo fix this, apply ROT13 to the password by adding\n\n```\nimport com.docker.UserSignup.utit.Rot13\n\nString passwd = Rot13.rot13(password);\n```\n\n\nSet a breakpoint in UserServiceImpl on the findByLogin method. Press `F11` or click on `Run` > `Build Project` to update the deployed code. Log in again and look at the values for the breakpoint. The 'passwd' variable is `z0ol` which matches the password for the user moby.\n\n\n\nContinue (`F5`) and you should successfully log in.\n\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/NetBeans-README_es.md",
"content": "## Desarrollo Java en Contenedor: NetBeans IDE\n\n### Pre-requisitos\n\n* [Docker for OSX or Docker for Windows](https://www.docker.com/products/docker)\n* [NetBeans IDE](https://netbeans.org/downloads/)\n* [Java Development Kit](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)\n\n### Empezando\n\nUsar el cliente git para clonar el repositorio.\n\n```\ngit clone https://github.com/spara/registration-docker.git\n```\n\nAbrir NetBeans IDE, hacer clic en `Open Project...`\n\n\n\nSeleccionar `app` y hacer clic en `Open Project`.\n\n\n\n### Construyendo la aplicación\n\nLa aplicación es una aplicación Spring MVC básica que recibe datos del usuario de un formulario, almacena y consulta la informacion en la base de datos.\n\nLa aplicación se construye usando Maven. Para construir la aplicación hacer clic en `Run` > `Build Project`.\n\n\n\nLos resultados del build serán mostrados en la consola.\n\n\n\n### Ejecutando la aplicación\n\nAbrir un terminal e ir al directorio de la aplicación. Iniciar la aplicación con docker-compose\n\n
> docker-compose up
\n\nDocker construirá las imágenes para Apache Tomcat y MySQL e iniciará los contenedores. También, montará el directorio de la aplicación (`./app/target/UserSignup`) como volumen de datos en el host del sistema al directorio webapps Tomcat en el contenedor del servidor web.\n\nAbrir una ventana en el explorador e ir a:\n'localhost:8080'; debes ver la página de inicio de Tomcat\n\n\n\nCuando la imagen de Tomcat fue construida, los roles de los usuarios fueron configurados. hacer clic en el botón `Manager App` para visualizar las aplicaciones desplegadas. Cuando se solicite por usuario y contraseña, ingresar `system` y `manager` respectivamente para entrar a la página de Tomcat Web Application Manager.\n\n\n\nPuedes usar la página Manager para `Start`, `Stop`, `Reload` o `Undeploy` aplicaciones web.\n\nPara ir a la aplicación, hacer clic en el link `/UserSignup`.\n\n\n\n### Depurando la Aplicación\n\nEn la aplicación, hacer clic en `Signup` para crear un nuevo usuario. Completar el formulario de registro y hacer clic en `Submit`\n\n\n\nHacer clic en `Yes` para confirmar.\n\n\n\nProbar el inicio de sesión.\n\n\n\nOh no!\n\n\n\n#### Configurar Depuración Remota\n\nEn el menu hacer clic en `Debug` > `Attach Debugger...`\n\n\n\nAsegurar que el puerto establecido es 8000, hacer clic en `OK`.\n\n\n\n#### Buscando el Error\n\nDado que el problema es la contraseña, veamos como la contraseña se establece en la clase User. En la clase User, el setter para la contraseña es mezclado usando [rot13](https://en.wikipedia.org/wiki/ROT13) antes almacenarse en la base de datos.\n\nDado que habilitamos el depurador remoto previamente, debe ver los Daemon Threads para Tomcat en la ventana `Debugging`. Establecer un punto de interrupción para la clase User donde el password es establecido.\n\n\n\nRegistrar un nuevo usuario con el usuario de 'Moby' y con 'm0by' como contraseña, hacer clic en `Submit`, hacer clic en `yes`\n\n\n\nNetBeans mostrará el código en el punto de interrupción y el valor de la contraseña en la ventana variables. Observar que el valor es `m0by`\n\n\n\nHacer clic en el icono `Continue` o presionar `F5` para permitir ejecutar el código.\n\n\n\nA continuación, establecer el punto de interrupción en getPassword en la clase User para ver los valores retornados para la contraseña. También puede cambiar el punto de interrupción para setPassword. Tratar de acceder a la aplicación. Ver el valor de la contraseña en la ventana variables, observar que es `z0ol` el cual es `m0by` usando ROT13.\n\n\n\nEn esta aplicación MVC el UserController usa el método findByLogin en la clase UserServiceImpl la cual usa el método findByUsername para recuperar la información de la base de datos. A continuación, verifica que la contraseña del formulario conincide con la contraseña del usuario. Dado que la contraseña del formulario de inicio de sesión no es mezclada usando ROT13, este no coincide con la contraseña del usuario y no puedes acceder a la aplicación.\n\nPara solucionar esto, aplicar ROT13 a la contraseña agregando\n\n```\nimport com.docker.UserSignup.utit.Rot13\n\nString passwd = Rot13.rot13(password);\n```\n\n\nEstablecer un punto de interrupción en UserServiceImpl en el método findByLogin. Presionar `F11` o hacer clic en `Run` > `Build Project` para actualizar el código desplegado. Iniciar sesión otra vez y mirar los valores para el punto de interrupción. La variable 'passwd' es 'z0ol' la cual coincide con la contraseña para el usuario moby.\n\n\n\nContinuar (`F5`) y debe acceder exitosamente.\n\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/README.md",
"content": "# Tutorial: Debugging Java Applications in Docker\n\nJava developers can use Docker to build a development environment where they can run, test, and live debug code running within a container. Debugging a node.js application was demonstrated at DockerCon 2016 showing that development using containers can be performed on many platforms using other programming languages.\n\n[](https://youtu.be/vE1iDPx6-Ok?list=PLkA60AVN3hh9gnrYwNO6zTb9U3i1Y9FMY&t=2088)\n\n\n\n\nThis tutorial includes Docker images and an application for Java development using containers. An examples for Eclipse, IntelliJ CE, and Netbeans are provided.\n\n* [Eclipse](Eclipse-README.md)\n* [IntelliJ](IntelliJ-README.md)\n* [NetBeans](NetBeans-README.md)\n\nBefore starting the tutorial, please have [Docker](https://www.docker.com/products/overview) installed.\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/README_es.md",
"content": "# Tutorial: Depurando Aplicaciones Java en Docker\n\nLos programadores de Java pueden utilizar Docker para construir un ambiente de desarrollo donde puedan ejecutar, testear y depurar el código que está ejecutándose en un contenedor.\n\nDurante la DockerCon 2016 se presentó cómo depurar una aplicación node.js, demostrando así que el desarrollo usando contenedores puede ser utilizado en muchas plataformas y con diferentes lenguajes de programación.\n\n[](https://youtu.be/vE1iDPx6-Ok?list=PLkA60AVN3hh9gnrYwNO6zTb9U3i1Y9FMY&t=2088)\n\nEste tutorial incluye imágenes Docker y una aplicación Java usando contenedores. Incluye además, ejemplos para Eclipse, IntelliJ CE y Netbeans.\n\n* [Eclipse](Eclipse-README_es.md)\n* [IntelliJ](IntelliJ-README_es.md)\n* [NetBeans](NetBeans-README_es.md)\n\nAntes de iniciar el tutorial, debe tener instalado [Docker](https://www.docker.com/products/overview) instalado.\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/.gitignore",
"content": "/target/\nUserSignup.war\nUserSignup.iml\n.DS_Store \n.classpath\n.project\n/out/\n/src/main/main.iml\n.idea\n.settings\n.classpath\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/pom.xml",
"content": "\n 4.0.0\n com.docker\n UserSignup\n war\n 0.0.1-SNAPSHOT\n UserSignup Maven Webapp\n http://maven.apache.org\n \n \n org.springframework\n spring-webmvc\n 5.2.21.RELEASE\n \n \n javax.servlet\n servlet-api\n 2.5\n provided\n \n \n javax.servlet\n jstl\n 1.2\n \n \n mysql\n mysql-connector-java\n 8.0.16\n \n \n org.hibernate\n hibernate-validator\n 5.3.6.Final\n \n \n org.hibernate\n hibernate-entitymanager\n 4.1.9.Final\n \n \n javax.transaction\n jta\n 1.1\n \n \n org.springframework\n spring-jdbc\n 3.2.0.RELEASE\n \n \n org.springframework\n spring-orm\n 3.2.0.RELEASE\n \n \n org.springframework.data\n spring-data-jpa\n ~> 1.11.20\n \n \n org.springframework\n spring-aop\n \n \n \n \n \n UserSignup\n \n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/src/main/java/com/docker/UserSignup/controller/UserController.java",
"content": "package com.docker.UserSignup.controller;\n\nimport javax.validation.Valid;\n\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.stereotype.Controller;\nimport org.springframework.ui.Model;\nimport org.springframework.validation.BindingResult;\nimport org.springframework.web.bind.annotation.ModelAttribute;\nimport org.springframework.web.bind.annotation.RequestMapping;\nimport org.springframework.web.bind.annotation.RequestMethod;\nimport org.springframework.web.bind.annotation.SessionAttributes;\n\nimport com.docker.UserSignup.model.User;\nimport com.docker.UserSignup.model.UserLogin;\nimport com.docker.UserSignup.service.UserService;\n\n@Controller\n@SessionAttributes(\"user\")\npublic class UserController {\n\t\n\t@Autowired\n\tprivate UserService userService;\n\t\t\n\t@RequestMapping(value=\"/signup\", method=RequestMethod.GET)\n\tpublic String signup(Model model) {\n\t\tUser user = new User();\t\t\n\t\tmodel.addAttribute(\"user\", user);\t\t\n\t\treturn \"signup\";\n\t}\n\t\n\t@RequestMapping(value=\"/signup\", method=RequestMethod.POST)\n\tpublic String signup(@Valid @ModelAttribute(\"user\") User user, BindingResult result, Model model) {\t\t\n\t\tif(result.hasErrors()) {\n\t\t\treturn \"signup\";\n\t\t} else if(userService.findByUserName(user.getUserName())) {\n\t\t\tmodel.addAttribute(\"message\", \"User Name exists. Try another user name\");\n\t\t\treturn \"signup\";\n\t\t} else {\n\t\t\tuserService.save(user);\n\t\t\tmodel.addAttribute(\"message\", \"Saved user details\");\n\t\t\treturn \"redirect:login.html\";\n\t\t}\n\t}\n\n\t@RequestMapping(value=\"/login\", method=RequestMethod.GET)\n\tpublic String login(Model model) {\t\t\t\n\t\tUserLogin userLogin = new UserLogin();\t\t\n\t\tmodel.addAttribute(\"userLogin\", userLogin);\n\t\treturn \"login\";\n\t}\n\t\n\t@RequestMapping(value=\"/login\", method=RequestMethod.POST)\n\tpublic String login(@Valid @ModelAttribute(\"userLogin\") UserLogin userLogin, BindingResult result) {\n\t\tif (result.hasErrors()) {\n\t\t\treturn \"login\";\n\t\t} else {\n\t\t\tboolean found = userService.findByLogin(userLogin.getUserName(), userLogin.getPassword());\n\t\t\tif (found) {\t\t\t\t\n\t\t\t\treturn \"success\";\n\t\t\t} else {\t\t\t\t\n\t\t\t\treturn \"failure\";\n\t\t\t}\n\t\t}\n\t\t\n\t}\n}\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/src/main/java/com/docker/UserSignup/model/User.java",
"content": "package com.docker.UserSignup.model;\n\nimport java.util.Date;\n\nimport javax.persistence.Entity;\nimport javax.persistence.GeneratedValue;\nimport javax.persistence.Id;\nimport javax.persistence.Table;\nimport javax.validation.constraints.NotNull;\nimport javax.validation.constraints.Past;\nimport javax.validation.constraints.Size;\n\nimport org.hibernate.validator.constraints.Email;\nimport org.hibernate.validator.constraints.NotEmpty;\nimport org.springframework.format.annotation.DateTimeFormat;\n\nimport com.docker.UserSignup.util.Rot13;\n\n@Entity\n@Table(name=\"user\")\npublic class User {\n\n\t@Id\n\t@GeneratedValue\n\tprivate Long id;\n\t\n\t@NotEmpty\n\t@Size(min=4, max=20)\n\tprivate String userName;\n\t\n\t@NotEmpty\n\tprivate String firstName;\n\t\n\t@NotEmpty\n\tprivate String lastName;\n\t\n\t@NotEmpty\n\t@Size(min=4, max=8)\n\tprivate String password;\n\t\n\t@NotEmpty\n\t@Email\n\tprivate String emailAddress;\n\t\n\t@NotNull\n\t@Past\n\t@DateTimeFormat(pattern=\"MM/dd/yyyy\")\n\tprivate Date dateOfBirth;\n\t\n\tpublic Long getId() {\n\t\treturn id;\n\t}\n\n\tpublic void setId(Long id) {\n\t\tthis.id = id;\n\t}\n\n\tpublic String getUserName() {\n\t\treturn userName;\n\t}\n\n\tpublic void setUserName(String userName) {\n\t\tthis.userName = userName;\n\t}\n\n\tpublic String getFirstName() {\n\t\treturn firstName;\n\t}\n\n\tpublic void setFirstName(String firstName) {\n\t\tthis.firstName = firstName;\n\t}\n\n\tpublic String getLastName() {\n\t\treturn lastName;\n\t}\n\n\tpublic void setLastName(String lastName) {\n\t\tthis.lastName = lastName;\n\t}\n\n\tpublic String getPassword() {\n\t\treturn password;\n\t}\n\n\tpublic void setPassword(String password) {\n\t\tthis.password = Rot13.rot13(password);\n\t}\n\n\tpublic String getEmailAddress() {\n\t\treturn emailAddress;\n\t}\n\n\tpublic void setEmailAddress(String emailAddress) {\n\t\tthis.emailAddress = emailAddress;\n\t}\n\n\tpublic Date getDateOfBirth() {\n\t\treturn dateOfBirth;\n\t}\n\n\tpublic void setDateOfBirth(Date dateOfBirth) {\n\t\tthis.dateOfBirth = dateOfBirth;\n\t}\t\n}\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/src/main/java/com/docker/UserSignup/model/UserLogin.java",
"content": "package com.docker.UserSignup.model;\n\nimport javax.validation.constraints.Size;\n\nimport org.hibernate.validator.constraints.NotEmpty;\n\npublic class UserLogin {\n\n\t@NotEmpty\n\t@Size(min=4, max=20)\n\tprivate String userName;\n\t\t\n\t@NotEmpty\n\t@Size(min=4, max=8)\n\tprivate String password;\n\n\tpublic String getPassword() {\n\t\treturn password;\n\t}\n\n\tpublic String getUserName() {\n\t\treturn userName;\n\t}\n\n\tpublic void setPassword(String password) {\n\t\tthis.password = password;\n\t}\n\n\tpublic void setUserName(String userName) {\n\t\tthis.userName = userName;\n\t}\t\n}\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/src/main/java/com/docker/UserSignup/repository/UserRepository.java",
"content": "package com.docker.UserSignup.repository;\n\nimport org.springframework.data.jpa.repository.JpaRepository;\nimport org.springframework.data.jpa.repository.Query;\nimport org.springframework.data.repository.query.Param;\nimport org.springframework.stereotype.Repository;\n\nimport com.docker.UserSignup.model.User;\n\n@Repository(\"userRepository\")\npublic interface UserRepository extends JpaRepository {\n\t\n\t@Query(\"select s from User s where s.userName = :userName\")\n\tUser findByUserName(@Param(\"userName\") String userName);\n\t\n}\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/src/main/java/com/docker/UserSignup/service/UserService.java",
"content": "package com.docker.UserSignup.service;\n\nimport com.docker.UserSignup.model.User;\n\npublic interface UserService {\n\tUser save(User user);\n\tboolean findByLogin(String userName, String password);\n\tboolean findByUserName(String userName);\n}\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/src/main/java/com/docker/UserSignup/service/UserServiceImpl.java",
"content": "package com.docker.UserSignup.service;\n\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.stereotype.Service;\nimport org.springframework.transaction.annotation.Transactional;\n\nimport com.docker.UserSignup.model.User;\nimport com.docker.UserSignup.repository.UserRepository;\n\n@Service(\"userService\")\npublic class UserServiceImpl implements UserService {\n\n\t@Autowired\n\tprivate UserRepository userRepository;\n\t\n\t@Transactional\n\tpublic User save(User user) {\n\t\treturn userRepository.save(user);\n\t}\n\n\tpublic boolean findByLogin(String userName, String password) {\t\n\t\tUser usr = userRepository.findByUserName(userName);\n\n\t\tif(usr != null && usr.getPassword().equals(password)) {\n\t\t\treturn true;\n\t\t} \n\t\t\n\t\treturn false;\t\t\n\t}\n\n\tpublic boolean findByUserName(String userName) {\n\t\tUser usr = userRepository.findByUserName(userName);\n\t\t\n\t\tif(usr != null) {\n\t\t\treturn true;\n\t\t}\n\t\t\n\t\treturn false;\n\t}\n\n}\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/src/main/java/com/docker/UserSignup/util/Rot13.java",
"content": "package com.docker.UserSignup.util;\n\npublic class Rot13 {\n\n\tpublic static String rot13(String password) {\n\t\t StringBuilder sb = new StringBuilder();\n\t\t String passwd = password;\n\t\t for (int i = 0; i < passwd.length(); i++) {\n\t\t char c = passwd.charAt(i);\n\t\t if (c >= 'a' && c <= 'm') c += 13;\n\t\t else if (c >= 'A' && c <= 'M') c += 13;\n\t\t else if (c >= 'n' && c <= 'z') c -= 13;\n\t\t else if (c >= 'N' && c <= 'Z') c -= 13;\n\t\t sb.append(c);\n\t\t }\n\t\t return sb.toString();\n\t}\n}"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/src/main/resources/META-INF/persistence.xml",
"content": "\n\t\n\t\n\t\n\t\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/src/main/resources/jpaContext.xml",
"content": "\n\n\n\t\n\t\n\t\n\t\n\t\n\n\t\n\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\n\t\t\n\t\t\n\t\t\t\n\t\t\n\t\n\t\n\t\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/src/main/resources/messages.properties",
"content": "NotEmpty=Field cannot be blank\nNotNull=Field cannot be blank\n\nEmail=Email Address not valid/well-formed\nPast=Date of Birth must be in the past \n\nSize={0} must be between {2} and {1} characters long\ntypeMismatch=Invalid format"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/src/main/webapp/WEB-INF/config/servletConfig.xml",
"content": "\n\n\n\n\n\n\n\n\t\n\t\n\n\n\n\t\n\n\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/src/main/webapp/WEB-INF/jsp/failure.jsp",
"content": "<%@ page language=\"java\" contentType=\"text/html; charset=ISO-8859-1\"\n\tpageEncoding=\"ISO-8859-1\"%>\n<%@ taglib prefix=\"spring\" uri=\"http://www.springframework.org/tags\"%>\n\n\n\n\n\nLogin Failure\n\n\n\n\n\t\n\n\t\n\n\t
\n\t\n\n\t\n\n\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java-debugging/app/src/main/webapp/jquery-1.8.3.js",
"content": "/*!\n * jQuery JavaScript Library v1.8.3\n * http://jquery.com/\n *\n * Includes Sizzle.js\n * http://sizzlejs.com/\n *\n * Copyright 2012 jQuery Foundation and other contributors\n * Released under the MIT license\n * http://jquery.org/license\n *\n * Date: Tue Nov 13 2012 08:20:33 GMT-0500 (Eastern Standard Time)\n */\n(function( window, undefined ) {\nvar\n\t// A central reference to the root jQuery(document)\n\trootjQuery,\n\n\t// The deferred used on DOM ready\n\treadyList,\n\n\t// Use the correct document accordingly with window argument (sandbox)\n\tdocument = window.document,\n\tlocation = window.location,\n\tnavigator = window.navigator,\n\n\t// Map over jQuery in case of overwrite\n\t_jQuery = window.jQuery,\n\n\t// Map over the $ in case of overwrite\n\t_$ = window.$,\n\n\t// Save a reference to some core methods\n\tcore_push = Array.prototype.push,\n\tcore_slice = Array.prototype.slice,\n\tcore_indexOf = Array.prototype.indexOf,\n\tcore_toString = Object.prototype.toString,\n\tcore_hasOwn = Object.prototype.hasOwnProperty,\n\tcore_trim = String.prototype.trim,\n\n\t// Define a local copy of jQuery\n\tjQuery = function( selector, context ) {\n\t\t// The jQuery object is actually just the init constructor 'enhanced'\n\t\treturn new jQuery.fn.init( selector, context, rootjQuery );\n\t},\n\n\t// Used for matching numbers\n\tcore_pnum = /[\\-+]?(?:\\d*\\.|)\\d+(?:[eE][\\-+]?\\d+|)/.source,\n\n\t// Used for detecting and trimming whitespace\n\tcore_rnotwhite = /\\S/,\n\tcore_rspace = /\\s+/,\n\n\t// Make sure we trim BOM and NBSP (here's looking at you, Safari 5.0 and IE)\n\trtrim = /^[\\s\\uFEFF\\xA0]+|[\\s\\uFEFF\\xA0]+$/g,\n\n\t// A simple way to check for HTML strings\n\t// Prioritize #id over to avoid XSS via location.hash (#9521)\n\trquickExpr = /^(?:[^#<]*(<[\\w\\W]+>)[^>]*$|#([\\w\\-]*)$)/,\n\n\t// Match a standalone tag\n\trsingleTag = /^<(\\w+)\\s*\\/?>(?:<\\/\\1>|)$/,\n\n\t// JSON RegExp\n\trvalidchars = /^[\\],:{}\\s]*$/,\n\trvalidbraces = /(?:^|:|,)(?:\\s*\\[)+/g,\n\trvalidescape = /\\\\(?:[\"\\\\\\/bfnrt]|u[\\da-fA-F]{4})/g,\n\trvalidtokens = /\"[^\"\\\\\\r\\n]*\"|true|false|null|-?(?:\\d\\d*\\.|)\\d+(?:[eE][\\-+]?\\d+|)/g,\n\n\t// Matches dashed string for camelizing\n\trmsPrefix = /^-ms-/,\n\trdashAlpha = /-([\\da-z])/gi,\n\n\t// Used by jQuery.camelCase as callback to replace()\n\tfcamelCase = function( all, letter ) {\n\t\treturn ( letter + \"\" ).toUpperCase();\n\t},\n\n\t// The ready event handler and self cleanup method\n\tDOMContentLoaded = function() {\n\t\tif ( document.addEventListener ) {\n\t\t\tdocument.removeEventListener( \"DOMContentLoaded\", DOMContentLoaded, false );\n\t\t\tjQuery.ready();\n\t\t} else if ( document.readyState === \"complete\" ) {\n\t\t\t// we're here because readyState === \"complete\" in oldIE\n\t\t\t// which is good enough for us to call the dom ready!\n\t\t\tdocument.detachEvent( \"onreadystatechange\", DOMContentLoaded );\n\t\t\tjQuery.ready();\n\t\t}\n\t},\n\n\t// [[Class]] -> type pairs\n\tclass2type = {};\n\njQuery.fn = jQuery.prototype = {\n\tconstructor: jQuery,\n\tinit: function( selector, context, rootjQuery ) {\n\t\tvar match, elem, ret, doc;\n\n\t\t// Handle $(\"\"), $(null), $(undefined), $(false)\n\t\tif ( !selector ) {\n\t\t\treturn this;\n\t\t}\n\n\t\t// Handle $(DOMElement)\n\t\tif ( selector.nodeType ) {\n\t\t\tthis.context = this[0] = selector;\n\t\t\tthis.length = 1;\n\t\t\treturn this;\n\t\t}\n\n\t\t// Handle HTML strings\n\t\tif ( typeof selector === \"string\" ) {\n\t\t\tif ( selector.charAt(0) === \"<\" && selector.charAt( selector.length - 1 ) === \">\" && selector.length >= 3 ) {\n\t\t\t\t// Assume that strings that start and end with <> are HTML and skip the regex check\n\t\t\t\tmatch = [ null, selector, null ];\n\n\t\t\t} else {\n\t\t\t\tmatch = rquickExpr.exec( selector );\n\t\t\t}\n\n\t\t\t// Match html or make sure no context is specified for #id\n\t\t\tif ( match && (match[1] || !context) ) {\n\n\t\t\t\t// HANDLE: $(html) -> $(array)\n\t\t\t\tif ( match[1] ) {\n\t\t\t\t\tcontext = context instanceof jQuery ? context[0] : context;\n\t\t\t\t\tdoc = ( context && context.nodeType ? context.ownerDocument || context : document );\n\n\t\t\t\t\t// scripts is true for back-compat\n\t\t\t\t\tselector = jQuery.parseHTML( match[1], doc, true );\n\t\t\t\t\tif ( rsingleTag.test( match[1] ) && jQuery.isPlainObject( context ) ) {\n\t\t\t\t\t\tthis.attr.call( selector, context, true );\n\t\t\t\t\t}\n\n\t\t\t\t\treturn jQuery.merge( this, selector );\n\n\t\t\t\t// HANDLE: $(#id)\n\t\t\t\t} else {\n\t\t\t\t\telem = document.getElementById( match[2] );\n\n\t\t\t\t\t// Check parentNode to catch when Blackberry 4.6 returns\n\t\t\t\t\t// nodes that are no longer in the document #6963\n\t\t\t\t\tif ( elem && elem.parentNode ) {\n\t\t\t\t\t\t// Handle the case where IE and Opera return items\n\t\t\t\t\t\t// by name instead of ID\n\t\t\t\t\t\tif ( elem.id !== match[2] ) {\n\t\t\t\t\t\t\treturn rootjQuery.find( selector );\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Otherwise, we inject the element directly into the jQuery object\n\t\t\t\t\t\tthis.length = 1;\n\t\t\t\t\t\tthis[0] = elem;\n\t\t\t\t\t}\n\n\t\t\t\t\tthis.context = document;\n\t\t\t\t\tthis.selector = selector;\n\t\t\t\t\treturn this;\n\t\t\t\t}\n\n\t\t\t// HANDLE: $(expr, $(...))\n\t\t\t} else if ( !context || context.jquery ) {\n\t\t\t\treturn ( context || rootjQuery ).find( selector );\n\n\t\t\t// HANDLE: $(expr, context)\n\t\t\t// (which is just equivalent to: $(context).find(expr)\n\t\t\t} else {\n\t\t\t\treturn this.constructor( context ).find( selector );\n\t\t\t}\n\n\t\t// HANDLE: $(function)\n\t\t// Shortcut for document ready\n\t\t} else if ( jQuery.isFunction( selector ) ) {\n\t\t\treturn rootjQuery.ready( selector );\n\t\t}\n\n\t\tif ( selector.selector !== undefined ) {\n\t\t\tthis.selector = selector.selector;\n\t\t\tthis.context = selector.context;\n\t\t}\n\n\t\treturn jQuery.makeArray( selector, this );\n\t},\n\n\t// Start with an empty selector\n\tselector: \"\",\n\n\t// The current version of jQuery being used\n\tjquery: \"1.8.3\",\n\n\t// The default length of a jQuery object is 0\n\tlength: 0,\n\n\t// The number of elements contained in the matched element set\n\tsize: function() {\n\t\treturn this.length;\n\t},\n\n\ttoArray: function() {\n\t\treturn core_slice.call( this );\n\t},\n\n\t// Get the Nth element in the matched element set OR\n\t// Get the whole matched element set as a clean array\n\tget: function( num ) {\n\t\treturn num == null ?\n\n\t\t\t// Return a 'clean' array\n\t\t\tthis.toArray() :\n\n\t\t\t// Return just the object\n\t\t\t( num < 0 ? this[ this.length + num ] : this[ num ] );\n\t},\n\n\t// Take an array of elements and push it onto the stack\n\t// (returning the new matched element set)\n\tpushStack: function( elems, name, selector ) {\n\n\t\t// Build a new jQuery matched element set\n\t\tvar ret = jQuery.merge( this.constructor(), elems );\n\n\t\t// Add the old object onto the stack (as a reference)\n\t\tret.prevObject = this;\n\n\t\tret.context = this.context;\n\n\t\tif ( name === \"find\" ) {\n\t\t\tret.selector = this.selector + ( this.selector ? \" \" : \"\" ) + selector;\n\t\t} else if ( name ) {\n\t\t\tret.selector = this.selector + \".\" + name + \"(\" + selector + \")\";\n\t\t}\n\n\t\t// Return the newly-formed element set\n\t\treturn ret;\n\t},\n\n\t// Execute a callback for every element in the matched set.\n\t// (You can seed the arguments with an array of args, but this is\n\t// only used internally.)\n\teach: function( callback, args ) {\n\t\treturn jQuery.each( this, callback, args );\n\t},\n\n\tready: function( fn ) {\n\t\t// Add the callback\n\t\tjQuery.ready.promise().done( fn );\n\n\t\treturn this;\n\t},\n\n\teq: function( i ) {\n\t\ti = +i;\n\t\treturn i === -1 ?\n\t\t\tthis.slice( i ) :\n\t\t\tthis.slice( i, i + 1 );\n\t},\n\n\tfirst: function() {\n\t\treturn this.eq( 0 );\n\t},\n\n\tlast: function() {\n\t\treturn this.eq( -1 );\n\t},\n\n\tslice: function() {\n\t\treturn this.pushStack( core_slice.apply( this, arguments ),\n\t\t\t\"slice\", core_slice.call(arguments).join(\",\") );\n\t},\n\n\tmap: function( callback ) {\n\t\treturn this.pushStack( jQuery.map(this, function( elem, i ) {\n\t\t\treturn callback.call( elem, i, elem );\n\t\t}));\n\t},\n\n\tend: function() {\n\t\treturn this.prevObject || this.constructor(null);\n\t},\n\n\t// For internal use only.\n\t// Behaves like an Array's method, not like a jQuery method.\n\tpush: core_push,\n\tsort: [].sort,\n\tsplice: [].splice\n};\n\n// Give the init function the jQuery prototype for later instantiation\njQuery.fn.init.prototype = jQuery.fn;\n\njQuery.extend = jQuery.fn.extend = function() {\n\tvar options, name, src, copy, copyIsArray, clone,\n\t\ttarget = arguments[0] || {},\n\t\ti = 1,\n\t\tlength = arguments.length,\n\t\tdeep = false;\n\n\t// Handle a deep copy situation\n\tif ( typeof target === \"boolean\" ) {\n\t\tdeep = target;\n\t\ttarget = arguments[1] || {};\n\t\t// skip the boolean and the target\n\t\ti = 2;\n\t}\n\n\t// Handle case when target is a string or something (possible in deep copy)\n\tif ( typeof target !== \"object\" && !jQuery.isFunction(target) ) {\n\t\ttarget = {};\n\t}\n\n\t// extend jQuery itself if only one argument is passed\n\tif ( length === i ) {\n\t\ttarget = this;\n\t\t--i;\n\t}\n\n\tfor ( ; i < length; i++ ) {\n\t\t// Only deal with non-null/undefined values\n\t\tif ( (options = arguments[ i ]) != null ) {\n\t\t\t// Extend the base object\n\t\t\tfor ( name in options ) {\n\t\t\t\tsrc = target[ name ];\n\t\t\t\tcopy = options[ name ];\n\n\t\t\t\t// Prevent never-ending loop\n\t\t\t\tif ( target === copy ) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\t// Recurse if we're merging plain objects or arrays\n\t\t\t\tif ( deep && copy && ( jQuery.isPlainObject(copy) || (copyIsArray = jQuery.isArray(copy)) ) ) {\n\t\t\t\t\tif ( copyIsArray ) {\n\t\t\t\t\t\tcopyIsArray = false;\n\t\t\t\t\t\tclone = src && jQuery.isArray(src) ? src : [];\n\n\t\t\t\t\t} else {\n\t\t\t\t\t\tclone = src && jQuery.isPlainObject(src) ? src : {};\n\t\t\t\t\t}\n\n\t\t\t\t\t// Never move original objects, clone them\n\t\t\t\t\ttarget[ name ] = jQuery.extend( deep, clone, copy );\n\n\t\t\t\t// Don't bring in undefined values\n\t\t\t\t} else if ( copy !== undefined ) {\n\t\t\t\t\ttarget[ name ] = copy;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Return the modified object\n\treturn target;\n};\n\njQuery.extend({\n\tnoConflict: function( deep ) {\n\t\tif ( window.$ === jQuery ) {\n\t\t\twindow.$ = _$;\n\t\t}\n\n\t\tif ( deep && window.jQuery === jQuery ) {\n\t\t\twindow.jQuery = _jQuery;\n\t\t}\n\n\t\treturn jQuery;\n\t},\n\n\t// Is the DOM ready to be used? Set to true once it occurs.\n\tisReady: false,\n\n\t// A counter to track how many items to wait for before\n\t// the ready event fires. See #6781\n\treadyWait: 1,\n\n\t// Hold (or release) the ready event\n\tholdReady: function( hold ) {\n\t\tif ( hold ) {\n\t\t\tjQuery.readyWait++;\n\t\t} else {\n\t\t\tjQuery.ready( true );\n\t\t}\n\t},\n\n\t// Handle when the DOM is ready\n\tready: function( wait ) {\n\n\t\t// Abort if there are pending holds or we're already ready\n\t\tif ( wait === true ? --jQuery.readyWait : jQuery.isReady ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443).\n\t\tif ( !document.body ) {\n\t\t\treturn setTimeout( jQuery.ready, 1 );\n\t\t}\n\n\t\t// Remember that the DOM is ready\n\t\tjQuery.isReady = true;\n\n\t\t// If a normal DOM Ready event fired, decrement, and wait if need be\n\t\tif ( wait !== true && --jQuery.readyWait > 0 ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// If there are functions bound, to execute\n\t\treadyList.resolveWith( document, [ jQuery ] );\n\n\t\t// Trigger any bound ready events\n\t\tif ( jQuery.fn.trigger ) {\n\t\t\tjQuery( document ).trigger(\"ready\").off(\"ready\");\n\t\t}\n\t},\n\n\t// See test/unit/core.js for details concerning isFunction.\n\t// Since version 1.3, DOM methods and functions like alert\n\t// aren't supported. They return false on IE (#2968).\n\tisFunction: function( obj ) {\n\t\treturn jQuery.type(obj) === \"function\";\n\t},\n\n\tisArray: Array.isArray || function( obj ) {\n\t\treturn jQuery.type(obj) === \"array\";\n\t},\n\n\tisWindow: function( obj ) {\n\t\treturn obj != null && obj == obj.window;\n\t},\n\n\tisNumeric: function( obj ) {\n\t\treturn !isNaN( parseFloat(obj) ) && isFinite( obj );\n\t},\n\n\ttype: function( obj ) {\n\t\treturn obj == null ?\n\t\t\tString( obj ) :\n\t\t\tclass2type[ core_toString.call(obj) ] || \"object\";\n\t},\n\n\tisPlainObject: function( obj ) {\n\t\t// Must be an Object.\n\t\t// Because of IE, we also have to check the presence of the constructor property.\n\t\t// Make sure that DOM nodes and window objects don't pass through, as well\n\t\tif ( !obj || jQuery.type(obj) !== \"object\" || obj.nodeType || jQuery.isWindow( obj ) ) {\n\t\t\treturn false;\n\t\t}\n\n\t\ttry {\n\t\t\t// Not own constructor property must be Object\n\t\t\tif ( obj.constructor &&\n\t\t\t\t!core_hasOwn.call(obj, \"constructor\") &&\n\t\t\t\t!core_hasOwn.call(obj.constructor.prototype, \"isPrototypeOf\") ) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t} catch ( e ) {\n\t\t\t// IE8,9 Will throw exceptions on certain host objects #9897\n\t\t\treturn false;\n\t\t}\n\n\t\t// Own properties are enumerated firstly, so to speed up,\n\t\t// if last one is own, then all properties are own.\n\n\t\tvar key;\n\t\tfor ( key in obj ) {}\n\n\t\treturn key === undefined || core_hasOwn.call( obj, key );\n\t},\n\n\tisEmptyObject: function( obj ) {\n\t\tvar name;\n\t\tfor ( name in obj ) {\n\t\t\treturn false;\n\t\t}\n\t\treturn true;\n\t},\n\n\terror: function( msg ) {\n\t\tthrow new Error( msg );\n\t},\n\n\t// data: string of html\n\t// context (optional): If specified, the fragment will be created in this context, defaults to document\n\t// scripts (optional): If true, will include scripts passed in the html string\n\tparseHTML: function( data, context, scripts ) {\n\t\tvar parsed;\n\t\tif ( !data || typeof data !== \"string\" ) {\n\t\t\treturn null;\n\t\t}\n\t\tif ( typeof context === \"boolean\" ) {\n\t\t\tscripts = context;\n\t\t\tcontext = 0;\n\t\t}\n\t\tcontext = context || document;\n\n\t\t// Single tag\n\t\tif ( (parsed = rsingleTag.exec( data )) ) {\n\t\t\treturn [ context.createElement( parsed[1] ) ];\n\t\t}\n\n\t\tparsed = jQuery.buildFragment( [ data ], context, scripts ? null : [] );\n\t\treturn jQuery.merge( [],\n\t\t\t(parsed.cacheable ? jQuery.clone( parsed.fragment ) : parsed.fragment).childNodes );\n\t},\n\n\tparseJSON: function( data ) {\n\t\tif ( !data || typeof data !== \"string\") {\n\t\t\treturn null;\n\t\t}\n\n\t\t// Make sure leading/trailing whitespace is removed (IE can't handle it)\n\t\tdata = jQuery.trim( data );\n\n\t\t// Attempt to parse using the native JSON parser first\n\t\tif ( window.JSON && window.JSON.parse ) {\n\t\t\treturn window.JSON.parse( data );\n\t\t}\n\n\t\t// Make sure the incoming data is actual JSON\n\t\t// Logic borrowed from http://json.org/json2.js\n\t\tif ( rvalidchars.test( data.replace( rvalidescape, \"@\" )\n\t\t\t.replace( rvalidtokens, \"]\" )\n\t\t\t.replace( rvalidbraces, \"\")) ) {\n\n\t\t\treturn ( new Function( \"return \" + data ) )();\n\n\t\t}\n\t\tjQuery.error( \"Invalid JSON: \" + data );\n\t},\n\n\t// Cross-browser xml parsing\n\tparseXML: function( data ) {\n\t\tvar xml, tmp;\n\t\tif ( !data || typeof data !== \"string\" ) {\n\t\t\treturn null;\n\t\t}\n\t\ttry {\n\t\t\tif ( window.DOMParser ) { // Standard\n\t\t\t\ttmp = new DOMParser();\n\t\t\t\txml = tmp.parseFromString( data , \"text/xml\" );\n\t\t\t} else { // IE\n\t\t\t\txml = new ActiveXObject( \"Microsoft.XMLDOM\" );\n\t\t\t\txml.async = \"false\";\n\t\t\t\txml.loadXML( data );\n\t\t\t}\n\t\t} catch( e ) {\n\t\t\txml = undefined;\n\t\t}\n\t\tif ( !xml || !xml.documentElement || xml.getElementsByTagName( \"parsererror\" ).length ) {\n\t\t\tjQuery.error( \"Invalid XML: \" + data );\n\t\t}\n\t\treturn xml;\n\t},\n\n\tnoop: function() {},\n\n\t// Evaluates a script in a global context\n\t// Workarounds based on findings by Jim Driscoll\n\t// http://weblogs.java.net/blog/driscoll/archive/2009/09/08/eval-javascript-global-context\n\tglobalEval: function( data ) {\n\t\tif ( data && core_rnotwhite.test( data ) ) {\n\t\t\t// We use execScript on Internet Explorer\n\t\t\t// We use an anonymous function so that context is window\n\t\t\t// rather than jQuery in Firefox\n\t\t\t( window.execScript || function( data ) {\n\t\t\t\twindow[ \"eval\" ].call( window, data );\n\t\t\t} )( data );\n\t\t}\n\t},\n\n\t// Convert dashed to camelCase; used by the css and data modules\n\t// Microsoft forgot to hump their vendor prefix (#9572)\n\tcamelCase: function( string ) {\n\t\treturn string.replace( rmsPrefix, \"ms-\" ).replace( rdashAlpha, fcamelCase );\n\t},\n\n\tnodeName: function( elem, name ) {\n\t\treturn elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase();\n\t},\n\n\t// args is for internal usage only\n\teach: function( obj, callback, args ) {\n\t\tvar name,\n\t\t\ti = 0,\n\t\t\tlength = obj.length,\n\t\t\tisObj = length === undefined || jQuery.isFunction( obj );\n\n\t\tif ( args ) {\n\t\t\tif ( isObj ) {\n\t\t\t\tfor ( name in obj ) {\n\t\t\t\t\tif ( callback.apply( obj[ name ], args ) === false ) {\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tfor ( ; i < length; ) {\n\t\t\t\t\tif ( callback.apply( obj[ i++ ], args ) === false ) {\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t// A special, fast, case for the most common use of each\n\t\t} else {\n\t\t\tif ( isObj ) {\n\t\t\t\tfor ( name in obj ) {\n\t\t\t\t\tif ( callback.call( obj[ name ], name, obj[ name ] ) === false ) {\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tfor ( ; i < length; ) {\n\t\t\t\t\tif ( callback.call( obj[ i ], i, obj[ i++ ] ) === false ) {\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn obj;\n\t},\n\n\t// Use native String.trim function wherever possible\n\ttrim: core_trim && !core_trim.call(\"\\uFEFF\\xA0\") ?\n\t\tfunction( text ) {\n\t\t\treturn text == null ?\n\t\t\t\t\"\" :\n\t\t\t\tcore_trim.call( text );\n\t\t} :\n\n\t\t// Otherwise use our own trimming functionality\n\t\tfunction( text ) {\n\t\t\treturn text == null ?\n\t\t\t\t\"\" :\n\t\t\t\t( text + \"\" ).replace( rtrim, \"\" );\n\t\t},\n\n\t// results is for internal usage only\n\tmakeArray: function( arr, results ) {\n\t\tvar type,\n\t\t\tret = results || [];\n\n\t\tif ( arr != null ) {\n\t\t\t// The window, strings (and functions) also have 'length'\n\t\t\t// Tweaked logic slightly to handle Blackberry 4.7 RegExp issues #6930\n\t\t\ttype = jQuery.type( arr );\n\n\t\t\tif ( arr.length == null || type === \"string\" || type === \"function\" || type === \"regexp\" || jQuery.isWindow( arr ) ) {\n\t\t\t\tcore_push.call( ret, arr );\n\t\t\t} else {\n\t\t\t\tjQuery.merge( ret, arr );\n\t\t\t}\n\t\t}\n\n\t\treturn ret;\n\t},\n\n\tinArray: function( elem, arr, i ) {\n\t\tvar len;\n\n\t\tif ( arr ) {\n\t\t\tif ( core_indexOf ) {\n\t\t\t\treturn core_indexOf.call( arr, elem, i );\n\t\t\t}\n\n\t\t\tlen = arr.length;\n\t\t\ti = i ? i < 0 ? Math.max( 0, len + i ) : i : 0;\n\n\t\t\tfor ( ; i < len; i++ ) {\n\t\t\t\t// Skip accessing in sparse arrays\n\t\t\t\tif ( i in arr && arr[ i ] === elem ) {\n\t\t\t\t\treturn i;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn -1;\n\t},\n\n\tmerge: function( first, second ) {\n\t\tvar l = second.length,\n\t\t\ti = first.length,\n\t\t\tj = 0;\n\n\t\tif ( typeof l === \"number\" ) {\n\t\t\tfor ( ; j < l; j++ ) {\n\t\t\t\tfirst[ i++ ] = second[ j ];\n\t\t\t}\n\n\t\t} else {\n\t\t\twhile ( second[j] !== undefined ) {\n\t\t\t\tfirst[ i++ ] = second[ j++ ];\n\t\t\t}\n\t\t}\n\n\t\tfirst.length = i;\n\n\t\treturn first;\n\t},\n\n\tgrep: function( elems, callback, inv ) {\n\t\tvar retVal,\n\t\t\tret = [],\n\t\t\ti = 0,\n\t\t\tlength = elems.length;\n\t\tinv = !!inv;\n\n\t\t// Go through the array, only saving the items\n\t\t// that pass the validator function\n\t\tfor ( ; i < length; i++ ) {\n\t\t\tretVal = !!callback( elems[ i ], i );\n\t\t\tif ( inv !== retVal ) {\n\t\t\t\tret.push( elems[ i ] );\n\t\t\t}\n\t\t}\n\n\t\treturn ret;\n\t},\n\n\t// arg is for internal usage only\n\tmap: function( elems, callback, arg ) {\n\t\tvar value, key,\n\t\t\tret = [],\n\t\t\ti = 0,\n\t\t\tlength = elems.length,\n\t\t\t// jquery objects are treated as arrays\n\t\t\tisArray = elems instanceof jQuery || length !== undefined && typeof length === \"number\" && ( ( length > 0 && elems[ 0 ] && elems[ length -1 ] ) || length === 0 || jQuery.isArray( elems ) ) ;\n\n\t\t// Go through the array, translating each of the items to their\n\t\tif ( isArray ) {\n\t\t\tfor ( ; i < length; i++ ) {\n\t\t\t\tvalue = callback( elems[ i ], i, arg );\n\n\t\t\t\tif ( value != null ) {\n\t\t\t\t\tret[ ret.length ] = value;\n\t\t\t\t}\n\t\t\t}\n\n\t\t// Go through every key on the object,\n\t\t} else {\n\t\t\tfor ( key in elems ) {\n\t\t\t\tvalue = callback( elems[ key ], key, arg );\n\n\t\t\t\tif ( value != null ) {\n\t\t\t\t\tret[ ret.length ] = value;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Flatten any nested arrays\n\t\treturn ret.concat.apply( [], ret );\n\t},\n\n\t// A global GUID counter for objects\n\tguid: 1,\n\n\t// Bind a function to a context, optionally partially applying any\n\t// arguments.\n\tproxy: function( fn, context ) {\n\t\tvar tmp, args, proxy;\n\n\t\tif ( typeof context === \"string\" ) {\n\t\t\ttmp = fn[ context ];\n\t\t\tcontext = fn;\n\t\t\tfn = tmp;\n\t\t}\n\n\t\t// Quick check to determine if target is callable, in the spec\n\t\t// this throws a TypeError, but we will just return undefined.\n\t\tif ( !jQuery.isFunction( fn ) ) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\t// Simulated bind\n\t\targs = core_slice.call( arguments, 2 );\n\t\tproxy = function() {\n\t\t\treturn fn.apply( context, args.concat( core_slice.call( arguments ) ) );\n\t\t};\n\n\t\t// Set the guid of unique handler to the same of original handler, so it can be removed\n\t\tproxy.guid = fn.guid = fn.guid || jQuery.guid++;\n\n\t\treturn proxy;\n\t},\n\n\t// Multifunctional method to get and set values of a collection\n\t// The value/s can optionally be executed if it's a function\n\taccess: function( elems, fn, key, value, chainable, emptyGet, pass ) {\n\t\tvar exec,\n\t\t\tbulk = key == null,\n\t\t\ti = 0,\n\t\t\tlength = elems.length;\n\n\t\t// Sets many values\n\t\tif ( key && typeof key === \"object\" ) {\n\t\t\tfor ( i in key ) {\n\t\t\t\tjQuery.access( elems, fn, i, key[i], 1, emptyGet, value );\n\t\t\t}\n\t\t\tchainable = 1;\n\n\t\t// Sets one value\n\t\t} else if ( value !== undefined ) {\n\t\t\t// Optionally, function values get executed if exec is true\n\t\t\texec = pass === undefined && jQuery.isFunction( value );\n\n\t\t\tif ( bulk ) {\n\t\t\t\t// Bulk operations only iterate when executing function values\n\t\t\t\tif ( exec ) {\n\t\t\t\t\texec = fn;\n\t\t\t\t\tfn = function( elem, key, value ) {\n\t\t\t\t\t\treturn exec.call( jQuery( elem ), value );\n\t\t\t\t\t};\n\n\t\t\t\t// Otherwise they run against the entire set\n\t\t\t\t} else {\n\t\t\t\t\tfn.call( elems, value );\n\t\t\t\t\tfn = null;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif ( fn ) {\n\t\t\t\tfor (; i < length; i++ ) {\n\t\t\t\t\tfn( elems[i], key, exec ? value.call( elems[i], i, fn( elems[i], key ) ) : value, pass );\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tchainable = 1;\n\t\t}\n\n\t\treturn chainable ?\n\t\t\telems :\n\n\t\t\t// Gets\n\t\t\tbulk ?\n\t\t\t\tfn.call( elems ) :\n\t\t\t\tlength ? fn( elems[0], key ) : emptyGet;\n\t},\n\n\tnow: function() {\n\t\treturn ( new Date() ).getTime();\n\t}\n});\n\njQuery.ready.promise = function( obj ) {\n\tif ( !readyList ) {\n\n\t\treadyList = jQuery.Deferred();\n\n\t\t// Catch cases where $(document).ready() is called after the browser event has already occurred.\n\t\t// we once tried to use readyState \"interactive\" here, but it caused issues like the one\n\t\t// discovered by ChrisS here: http://bugs.jquery.com/ticket/12282#comment:15\n\t\tif ( document.readyState === \"complete\" ) {\n\t\t\t// Handle it asynchronously to allow scripts the opportunity to delay ready\n\t\t\tsetTimeout( jQuery.ready, 1 );\n\n\t\t// Standards-based browsers support DOMContentLoaded\n\t\t} else if ( document.addEventListener ) {\n\t\t\t// Use the handy event callback\n\t\t\tdocument.addEventListener( \"DOMContentLoaded\", DOMContentLoaded, false );\n\n\t\t\t// A fallback to window.onload, that will always work\n\t\t\twindow.addEventListener( \"load\", jQuery.ready, false );\n\n\t\t// If IE event model is used\n\t\t} else {\n\t\t\t// Ensure firing before onload, maybe late but safe also for iframes\n\t\t\tdocument.attachEvent( \"onreadystatechange\", DOMContentLoaded );\n\n\t\t\t// A fallback to window.onload, that will always work\n\t\t\twindow.attachEvent( \"onload\", jQuery.ready );\n\n\t\t\t// If IE and not a frame\n\t\t\t// continually check to see if the document is ready\n\t\t\tvar top = false;\n\n\t\t\ttry {\n\t\t\t\ttop = window.frameElement == null && document.documentElement;\n\t\t\t} catch(e) {}\n\n\t\t\tif ( top && top.doScroll ) {\n\t\t\t\t(function doScrollCheck() {\n\t\t\t\t\tif ( !jQuery.isReady ) {\n\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t// Use the trick by Diego Perini\n\t\t\t\t\t\t\t// http://javascript.nwbox.com/IEContentLoaded/\n\t\t\t\t\t\t\ttop.doScroll(\"left\");\n\t\t\t\t\t\t} catch(e) {\n\t\t\t\t\t\t\treturn setTimeout( doScrollCheck, 50 );\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// and execute any waiting functions\n\t\t\t\t\t\tjQuery.ready();\n\t\t\t\t\t}\n\t\t\t\t})();\n\t\t\t}\n\t\t}\n\t}\n\treturn readyList.promise( obj );\n};\n\n// Populate the class2type map\njQuery.each(\"Boolean Number String Function Array Date RegExp Object\".split(\" \"), function(i, name) {\n\tclass2type[ \"[object \" + name + \"]\" ] = name.toLowerCase();\n});\n\n// All jQuery objects should point back to these\nrootjQuery = jQuery(document);\n// String to Object options format cache\nvar optionsCache = {};\n\n// Convert String-formatted options into Object-formatted ones and store in cache\nfunction createOptions( options ) {\n\tvar object = optionsCache[ options ] = {};\n\tjQuery.each( options.split( core_rspace ), function( _, flag ) {\n\t\tobject[ flag ] = true;\n\t});\n\treturn object;\n}\n\n/*\n * Create a callback list using the following parameters:\n *\n *\toptions: an optional list of space-separated options that will change how\n *\t\t\tthe callback list behaves or a more traditional option object\n *\n * By default a callback list will act like an event callback list and can be\n * \"fired\" multiple times.\n *\n * Possible options:\n *\n *\tonce:\t\t\twill ensure the callback list can only be fired once (like a Deferred)\n *\n *\tmemory:\t\t\twill keep track of previous values and will call any callback added\n *\t\t\t\t\tafter the list has been fired right away with the latest \"memorized\"\n *\t\t\t\t\tvalues (like a Deferred)\n *\n *\tunique:\t\t\twill ensure a callback can only be added once (no duplicate in the list)\n *\n *\tstopOnFalse:\tinterrupt callings when a callback returns false\n *\n */\njQuery.Callbacks = function( options ) {\n\n\t// Convert options from String-formatted to Object-formatted if needed\n\t// (we check in cache first)\n\toptions = typeof options === \"string\" ?\n\t\t( optionsCache[ options ] || createOptions( options ) ) :\n\t\tjQuery.extend( {}, options );\n\n\tvar // Last fire value (for non-forgettable lists)\n\t\tmemory,\n\t\t// Flag to know if list was already fired\n\t\tfired,\n\t\t// Flag to know if list is currently firing\n\t\tfiring,\n\t\t// First callback to fire (used internally by add and fireWith)\n\t\tfiringStart,\n\t\t// End of the loop when firing\n\t\tfiringLength,\n\t\t// Index of currently firing callback (modified by remove if needed)\n\t\tfiringIndex,\n\t\t// Actual callback list\n\t\tlist = [],\n\t\t// Stack of fire calls for repeatable lists\n\t\tstack = !options.once && [],\n\t\t// Fire callbacks\n\t\tfire = function( data ) {\n\t\t\tmemory = options.memory && data;\n\t\t\tfired = true;\n\t\t\tfiringIndex = firingStart || 0;\n\t\t\tfiringStart = 0;\n\t\t\tfiringLength = list.length;\n\t\t\tfiring = true;\n\t\t\tfor ( ; list && firingIndex < firingLength; firingIndex++ ) {\n\t\t\t\tif ( list[ firingIndex ].apply( data[ 0 ], data[ 1 ] ) === false && options.stopOnFalse ) {\n\t\t\t\t\tmemory = false; // To prevent further calls using add\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t\tfiring = false;\n\t\t\tif ( list ) {\n\t\t\t\tif ( stack ) {\n\t\t\t\t\tif ( stack.length ) {\n\t\t\t\t\t\tfire( stack.shift() );\n\t\t\t\t\t}\n\t\t\t\t} else if ( memory ) {\n\t\t\t\t\tlist = [];\n\t\t\t\t} else {\n\t\t\t\t\tself.disable();\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t// Actual Callbacks object\n\t\tself = {\n\t\t\t// Add a callback or a collection of callbacks to the list\n\t\t\tadd: function() {\n\t\t\t\tif ( list ) {\n\t\t\t\t\t// First, we save the current length\n\t\t\t\t\tvar start = list.length;\n\t\t\t\t\t(function add( args ) {\n\t\t\t\t\t\tjQuery.each( args, function( _, arg ) {\n\t\t\t\t\t\t\tvar type = jQuery.type( arg );\n\t\t\t\t\t\t\tif ( type === \"function\" ) {\n\t\t\t\t\t\t\t\tif ( !options.unique || !self.has( arg ) ) {\n\t\t\t\t\t\t\t\t\tlist.push( arg );\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t} else if ( arg && arg.length && type !== \"string\" ) {\n\t\t\t\t\t\t\t\t// Inspect recursively\n\t\t\t\t\t\t\t\tadd( arg );\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t});\n\t\t\t\t\t})( arguments );\n\t\t\t\t\t// Do we need to add the callbacks to the\n\t\t\t\t\t// current firing batch?\n\t\t\t\t\tif ( firing ) {\n\t\t\t\t\t\tfiringLength = list.length;\n\t\t\t\t\t// With memory, if we're not firing then\n\t\t\t\t\t// we should call right away\n\t\t\t\t\t} else if ( memory ) {\n\t\t\t\t\t\tfiringStart = start;\n\t\t\t\t\t\tfire( memory );\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn this;\n\t\t\t},\n\t\t\t// Remove a callback from the list\n\t\t\tremove: function() {\n\t\t\t\tif ( list ) {\n\t\t\t\t\tjQuery.each( arguments, function( _, arg ) {\n\t\t\t\t\t\tvar index;\n\t\t\t\t\t\twhile( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) {\n\t\t\t\t\t\t\tlist.splice( index, 1 );\n\t\t\t\t\t\t\t// Handle firing indexes\n\t\t\t\t\t\t\tif ( firing ) {\n\t\t\t\t\t\t\t\tif ( index <= firingLength ) {\n\t\t\t\t\t\t\t\t\tfiringLength--;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tif ( index <= firingIndex ) {\n\t\t\t\t\t\t\t\t\tfiringIndex--;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\treturn this;\n\t\t\t},\n\t\t\t// Control if a given callback is in the list\n\t\t\thas: function( fn ) {\n\t\t\t\treturn jQuery.inArray( fn, list ) > -1;\n\t\t\t},\n\t\t\t// Remove all callbacks from the list\n\t\t\tempty: function() {\n\t\t\t\tlist = [];\n\t\t\t\treturn this;\n\t\t\t},\n\t\t\t// Have the list do nothing anymore\n\t\t\tdisable: function() {\n\t\t\t\tlist = stack = memory = undefined;\n\t\t\t\treturn this;\n\t\t\t},\n\t\t\t// Is it disabled?\n\t\t\tdisabled: function() {\n\t\t\t\treturn !list;\n\t\t\t},\n\t\t\t// Lock the list in its current state\n\t\t\tlock: function() {\n\t\t\t\tstack = undefined;\n\t\t\t\tif ( !memory ) {\n\t\t\t\t\tself.disable();\n\t\t\t\t}\n\t\t\t\treturn this;\n\t\t\t},\n\t\t\t// Is it locked?\n\t\t\tlocked: function() {\n\t\t\t\treturn !stack;\n\t\t\t},\n\t\t\t// Call all callbacks with the given context and arguments\n\t\t\tfireWith: function( context, args ) {\n\t\t\t\targs = args || [];\n\t\t\t\targs = [ context, args.slice ? args.slice() : args ];\n\t\t\t\tif ( list && ( !fired || stack ) ) {\n\t\t\t\t\tif ( firing ) {\n\t\t\t\t\t\tstack.push( args );\n\t\t\t\t\t} else {\n\t\t\t\t\t\tfire( args );\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn this;\n\t\t\t},\n\t\t\t// Call all the callbacks with the given arguments\n\t\t\tfire: function() {\n\t\t\t\tself.fireWith( this, arguments );\n\t\t\t\treturn this;\n\t\t\t},\n\t\t\t// To know if the callbacks have already been called at least once\n\t\t\tfired: function() {\n\t\t\t\treturn !!fired;\n\t\t\t}\n\t\t};\n\n\treturn self;\n};\njQuery.extend({\n\n\tDeferred: function( func ) {\n\t\tvar tuples = [\n\t\t\t\t// action, add listener, listener list, final state\n\t\t\t\t[ \"resolve\", \"done\", jQuery.Callbacks(\"once memory\"), \"resolved\" ],\n\t\t\t\t[ \"reject\", \"fail\", jQuery.Callbacks(\"once memory\"), \"rejected\" ],\n\t\t\t\t[ \"notify\", \"progress\", jQuery.Callbacks(\"memory\") ]\n\t\t\t],\n\t\t\tstate = \"pending\",\n\t\t\tpromise = {\n\t\t\t\tstate: function() {\n\t\t\t\t\treturn state;\n\t\t\t\t},\n\t\t\t\talways: function() {\n\t\t\t\t\tdeferred.done( arguments ).fail( arguments );\n\t\t\t\t\treturn this;\n\t\t\t\t},\n\t\t\t\tthen: function( /* fnDone, fnFail, fnProgress */ ) {\n\t\t\t\t\tvar fns = arguments;\n\t\t\t\t\treturn jQuery.Deferred(function( newDefer ) {\n\t\t\t\t\t\tjQuery.each( tuples, function( i, tuple ) {\n\t\t\t\t\t\t\tvar action = tuple[ 0 ],\n\t\t\t\t\t\t\t\tfn = fns[ i ];\n\t\t\t\t\t\t\t// deferred[ done | fail | progress ] for forwarding actions to newDefer\n\t\t\t\t\t\t\tdeferred[ tuple[1] ]( jQuery.isFunction( fn ) ?\n\t\t\t\t\t\t\t\tfunction() {\n\t\t\t\t\t\t\t\t\tvar returned = fn.apply( this, arguments );\n\t\t\t\t\t\t\t\t\tif ( returned && jQuery.isFunction( returned.promise ) ) {\n\t\t\t\t\t\t\t\t\t\treturned.promise()\n\t\t\t\t\t\t\t\t\t\t\t.done( newDefer.resolve )\n\t\t\t\t\t\t\t\t\t\t\t.fail( newDefer.reject )\n\t\t\t\t\t\t\t\t\t\t\t.progress( newDefer.notify );\n\t\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\t\tnewDefer[ action + \"With\" ]( this === deferred ? newDefer : this, [ returned ] );\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t} :\n\t\t\t\t\t\t\t\tnewDefer[ action ]\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t});\n\t\t\t\t\t\tfns = null;\n\t\t\t\t\t}).promise();\n\t\t\t\t},\n\t\t\t\t// Get a promise for this deferred\n\t\t\t\t// If obj is provided, the promise aspect is added to the object\n\t\t\t\tpromise: function( obj ) {\n\t\t\t\t\treturn obj != null ? jQuery.extend( obj, promise ) : promise;\n\t\t\t\t}\n\t\t\t},\n\t\t\tdeferred = {};\n\n\t\t// Keep pipe for back-compat\n\t\tpromise.pipe = promise.then;\n\n\t\t// Add list-specific methods\n\t\tjQuery.each( tuples, function( i, tuple ) {\n\t\t\tvar list = tuple[ 2 ],\n\t\t\t\tstateString = tuple[ 3 ];\n\n\t\t\t// promise[ done | fail | progress ] = list.add\n\t\t\tpromise[ tuple[1] ] = list.add;\n\n\t\t\t// Handle state\n\t\t\tif ( stateString ) {\n\t\t\t\tlist.add(function() {\n\t\t\t\t\t// state = [ resolved | rejected ]\n\t\t\t\t\tstate = stateString;\n\n\t\t\t\t// [ reject_list | resolve_list ].disable; progress_list.lock\n\t\t\t\t}, tuples[ i ^ 1 ][ 2 ].disable, tuples[ 2 ][ 2 ].lock );\n\t\t\t}\n\n\t\t\t// deferred[ resolve | reject | notify ] = list.fire\n\t\t\tdeferred[ tuple[0] ] = list.fire;\n\t\t\tdeferred[ tuple[0] + \"With\" ] = list.fireWith;\n\t\t});\n\n\t\t// Make the deferred a promise\n\t\tpromise.promise( deferred );\n\n\t\t// Call given func if any\n\t\tif ( func ) {\n\t\t\tfunc.call( deferred, deferred );\n\t\t}\n\n\t\t// All done!\n\t\treturn deferred;\n\t},\n\n\t// Deferred helper\n\twhen: function( subordinate /* , ..., subordinateN */ ) {\n\t\tvar i = 0,\n\t\t\tresolveValues = core_slice.call( arguments ),\n\t\t\tlength = resolveValues.length,\n\n\t\t\t// the count of uncompleted subordinates\n\t\t\tremaining = length !== 1 || ( subordinate && jQuery.isFunction( subordinate.promise ) ) ? length : 0,\n\n\t\t\t// the master Deferred. If resolveValues consist of only a single Deferred, just use that.\n\t\t\tdeferred = remaining === 1 ? subordinate : jQuery.Deferred(),\n\n\t\t\t// Update function for both resolve and progress values\n\t\t\tupdateFunc = function( i, contexts, values ) {\n\t\t\t\treturn function( value ) {\n\t\t\t\t\tcontexts[ i ] = this;\n\t\t\t\t\tvalues[ i ] = arguments.length > 1 ? core_slice.call( arguments ) : value;\n\t\t\t\t\tif( values === progressValues ) {\n\t\t\t\t\t\tdeferred.notifyWith( contexts, values );\n\t\t\t\t\t} else if ( !( --remaining ) ) {\n\t\t\t\t\t\tdeferred.resolveWith( contexts, values );\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t},\n\n\t\t\tprogressValues, progressContexts, resolveContexts;\n\n\t\t// add listeners to Deferred subordinates; treat others as resolved\n\t\tif ( length > 1 ) {\n\t\t\tprogressValues = new Array( length );\n\t\t\tprogressContexts = new Array( length );\n\t\t\tresolveContexts = new Array( length );\n\t\t\tfor ( ; i < length; i++ ) {\n\t\t\t\tif ( resolveValues[ i ] && jQuery.isFunction( resolveValues[ i ].promise ) ) {\n\t\t\t\t\tresolveValues[ i ].promise()\n\t\t\t\t\t\t.done( updateFunc( i, resolveContexts, resolveValues ) )\n\t\t\t\t\t\t.fail( deferred.reject )\n\t\t\t\t\t\t.progress( updateFunc( i, progressContexts, progressValues ) );\n\t\t\t\t} else {\n\t\t\t\t\t--remaining;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// if we're not waiting on anything, resolve the master\n\t\tif ( !remaining ) {\n\t\t\tdeferred.resolveWith( resolveContexts, resolveValues );\n\t\t}\n\n\t\treturn deferred.promise();\n\t}\n});\njQuery.support = (function() {\n\n\tvar support,\n\t\tall,\n\t\ta,\n\t\tselect,\n\t\topt,\n\t\tinput,\n\t\tfragment,\n\t\teventName,\n\t\ti,\n\t\tisSupported,\n\t\tclickFn,\n\t\tdiv = document.createElement(\"div\");\n\n\t// Setup\n\tdiv.setAttribute( \"className\", \"t\" );\n\tdiv.innerHTML = \"
a\";\n\n\t// Support tests won't run in some limited or non-browser environments\n\tall = div.getElementsByTagName(\"*\");\n\ta = div.getElementsByTagName(\"a\")[ 0 ];\n\tif ( !all || !a || !all.length ) {\n\t\treturn {};\n\t}\n\n\t// First batch of tests\n\tselect = document.createElement(\"select\");\n\topt = select.appendChild( document.createElement(\"option\") );\n\tinput = div.getElementsByTagName(\"input\")[ 0 ];\n\n\ta.style.cssText = \"top:1px;float:left;opacity:.5\";\n\tsupport = {\n\t\t// IE strips leading whitespace when .innerHTML is used\n\t\tleadingWhitespace: ( div.firstChild.nodeType === 3 ),\n\n\t\t// Make sure that tbody elements aren't automatically inserted\n\t\t// IE will insert them into empty tables\n\t\ttbody: !div.getElementsByTagName(\"tbody\").length,\n\n\t\t// Make sure that link elements get serialized correctly by innerHTML\n\t\t// This requires a wrapper element in IE\n\t\thtmlSerialize: !!div.getElementsByTagName(\"link\").length,\n\n\t\t// Get the style information from getAttribute\n\t\t// (IE uses .cssText instead)\n\t\tstyle: /top/.test( a.getAttribute(\"style\") ),\n\n\t\t// Make sure that URLs aren't manipulated\n\t\t// (IE normalizes it by default)\n\t\threfNormalized: ( a.getAttribute(\"href\") === \"/a\" ),\n\n\t\t// Make sure that element opacity exists\n\t\t// (IE uses filter instead)\n\t\t// Use a regex to work around a WebKit issue. See #5145\n\t\topacity: /^0.5/.test( a.style.opacity ),\n\n\t\t// Verify style float existence\n\t\t// (IE uses styleFloat instead of cssFloat)\n\t\tcssFloat: !!a.style.cssFloat,\n\n\t\t// Make sure that if no value is specified for a checkbox\n\t\t// that it defaults to \"on\".\n\t\t// (WebKit defaults to \"\" instead)\n\t\tcheckOn: ( input.value === \"on\" ),\n\n\t\t// Make sure that a selected-by-default option has a working selected property.\n\t\t// (WebKit defaults to false instead of true, IE too, if it's in an optgroup)\n\t\toptSelected: opt.selected,\n\n\t\t// Test setAttribute on camelCase class. If it works, we need attrFixes when doing get/setAttribute (ie6/7)\n\t\tgetSetAttribute: div.className !== \"t\",\n\n\t\t// Tests for enctype support on a form (#6743)\n\t\tenctype: !!document.createElement(\"form\").enctype,\n\n\t\t// Makes sure cloning an html5 element does not cause problems\n\t\t// Where outerHTML is undefined, this still works\n\t\thtml5Clone: document.createElement(\"nav\").cloneNode( true ).outerHTML !== \"<:nav>\",\n\n\t\t// jQuery.support.boxModel DEPRECATED in 1.8 since we don't support Quirks Mode\n\t\tboxModel: ( document.compatMode === \"CSS1Compat\" ),\n\n\t\t// Will be defined later\n\t\tsubmitBubbles: true,\n\t\tchangeBubbles: true,\n\t\tfocusinBubbles: false,\n\t\tdeleteExpando: true,\n\t\tnoCloneEvent: true,\n\t\tinlineBlockNeedsLayout: false,\n\t\tshrinkWrapBlocks: false,\n\t\treliableMarginRight: true,\n\t\tboxSizingReliable: true,\n\t\tpixelPosition: false\n\t};\n\n\t// Make sure checked status is properly cloned\n\tinput.checked = true;\n\tsupport.noCloneChecked = input.cloneNode( true ).checked;\n\n\t// Make sure that the options inside disabled selects aren't marked as disabled\n\t// (WebKit marks them as disabled)\n\tselect.disabled = true;\n\tsupport.optDisabled = !opt.disabled;\n\n\t// Test to see if it's possible to delete an expando from an element\n\t// Fails in Internet Explorer\n\ttry {\n\t\tdelete div.test;\n\t} catch( e ) {\n\t\tsupport.deleteExpando = false;\n\t}\n\n\tif ( !div.addEventListener && div.attachEvent && div.fireEvent ) {\n\t\tdiv.attachEvent( \"onclick\", clickFn = function() {\n\t\t\t// Cloning a node shouldn't copy over any\n\t\t\t// bound event handlers (IE does this)\n\t\t\tsupport.noCloneEvent = false;\n\t\t});\n\t\tdiv.cloneNode( true ).fireEvent(\"onclick\");\n\t\tdiv.detachEvent( \"onclick\", clickFn );\n\t}\n\n\t// Check if a radio maintains its value\n\t// after being appended to the DOM\n\tinput = document.createElement(\"input\");\n\tinput.value = \"t\";\n\tinput.setAttribute( \"type\", \"radio\" );\n\tsupport.radioValue = input.value === \"t\";\n\n\tinput.setAttribute( \"checked\", \"checked\" );\n\n\t// #11217 - WebKit loses check when the name is after the checked attribute\n\tinput.setAttribute( \"name\", \"t\" );\n\n\tdiv.appendChild( input );\n\tfragment = document.createDocumentFragment();\n\tfragment.appendChild( div.lastChild );\n\n\t// WebKit doesn't clone checked state correctly in fragments\n\tsupport.checkClone = fragment.cloneNode( true ).cloneNode( true ).lastChild.checked;\n\n\t// Check if a disconnected checkbox will retain its checked\n\t// value of true after appended to the DOM (IE6/7)\n\tsupport.appendChecked = input.checked;\n\n\tfragment.removeChild( input );\n\tfragment.appendChild( div );\n\n\t// Technique from Juriy Zaytsev\n\t// http://perfectionkills.com/detecting-event-support-without-browser-sniffing/\n\t// We only care about the case where non-standard event systems\n\t// are used, namely in IE. Short-circuiting here helps us to\n\t// avoid an eval call (in setAttribute) which can cause CSP\n\t// to go haywire. See: https://developer.mozilla.org/en/Security/CSP\n\tif ( div.attachEvent ) {\n\t\tfor ( i in {\n\t\t\tsubmit: true,\n\t\t\tchange: true,\n\t\t\tfocusin: true\n\t\t}) {\n\t\t\teventName = \"on\" + i;\n\t\t\tisSupported = ( eventName in div );\n\t\t\tif ( !isSupported ) {\n\t\t\t\tdiv.setAttribute( eventName, \"return;\" );\n\t\t\t\tisSupported = ( typeof div[ eventName ] === \"function\" );\n\t\t\t}\n\t\t\tsupport[ i + \"Bubbles\" ] = isSupported;\n\t\t}\n\t}\n\n\t// Run tests that need a body at doc ready\n\tjQuery(function() {\n\t\tvar container, div, tds, marginDiv,\n\t\t\tdivReset = \"padding:0;margin:0;border:0;display:block;overflow:hidden;\",\n\t\t\tbody = document.getElementsByTagName(\"body\")[0];\n\n\t\tif ( !body ) {\n\t\t\t// Return for frameset docs that don't have a body\n\t\t\treturn;\n\t\t}\n\n\t\tcontainer = document.createElement(\"div\");\n\t\tcontainer.style.cssText = \"visibility:hidden;border:0;width:0;height:0;position:static;top:0;margin-top:1px\";\n\t\tbody.insertBefore( container, body.firstChild );\n\n\t\t// Construct the test element\n\t\tdiv = document.createElement(\"div\");\n\t\tcontainer.appendChild( div );\n\n\t\t// Check if table cells still have offsetWidth/Height when they are set\n\t\t// to display:none and there are still other visible table cells in a\n\t\t// table row; if so, offsetWidth/Height are not reliable for use when\n\t\t// determining if an element has been hidden directly using\n\t\t// display:none (it is still safe to use offsets if a parent element is\n\t\t// hidden; don safety goggles and see bug #4512 for more information).\n\t\t// (only IE 8 fails this test)\n\t\tdiv.innerHTML = \"
t
\";\n\t\ttds = div.getElementsByTagName(\"td\");\n\t\ttds[ 0 ].style.cssText = \"padding:0;margin:0;border:0;display:none\";\n\t\tisSupported = ( tds[ 0 ].offsetHeight === 0 );\n\n\t\ttds[ 0 ].style.display = \"\";\n\t\ttds[ 1 ].style.display = \"none\";\n\n\t\t// Check if empty table cells still have offsetWidth/Height\n\t\t// (IE <= 8 fail this test)\n\t\tsupport.reliableHiddenOffsets = isSupported && ( tds[ 0 ].offsetHeight === 0 );\n\n\t\t// Check box-sizing and margin behavior\n\t\tdiv.innerHTML = \"\";\n\t\tdiv.style.cssText = \"box-sizing:border-box;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;padding:1px;border:1px;display:block;width:4px;margin-top:1%;position:absolute;top:1%;\";\n\t\tsupport.boxSizing = ( div.offsetWidth === 4 );\n\t\tsupport.doesNotIncludeMarginInBodyOffset = ( body.offsetTop !== 1 );\n\n\t\t// NOTE: To any future maintainer, we've window.getComputedStyle\n\t\t// because jsdom on node.js will break without it.\n\t\tif ( window.getComputedStyle ) {\n\t\t\tsupport.pixelPosition = ( window.getComputedStyle( div, null ) || {} ).top !== \"1%\";\n\t\t\tsupport.boxSizingReliable = ( window.getComputedStyle( div, null ) || { width: \"4px\" } ).width === \"4px\";\n\n\t\t\t// Check if div with explicit width and no margin-right incorrectly\n\t\t\t// gets computed margin-right based on width of container. For more\n\t\t\t// info see bug #3333\n\t\t\t// Fails in WebKit before Feb 2011 nightlies\n\t\t\t// WebKit Bug 13343 - getComputedStyle returns wrong value for margin-right\n\t\t\tmarginDiv = document.createElement(\"div\");\n\t\t\tmarginDiv.style.cssText = div.style.cssText = divReset;\n\t\t\tmarginDiv.style.marginRight = marginDiv.style.width = \"0\";\n\t\t\tdiv.style.width = \"1px\";\n\t\t\tdiv.appendChild( marginDiv );\n\t\t\tsupport.reliableMarginRight =\n\t\t\t\t!parseFloat( ( window.getComputedStyle( marginDiv, null ) || {} ).marginRight );\n\t\t}\n\n\t\tif ( typeof div.style.zoom !== \"undefined\" ) {\n\t\t\t// Check if natively block-level elements act like inline-block\n\t\t\t// elements when setting their display to 'inline' and giving\n\t\t\t// them layout\n\t\t\t// (IE < 8 does this)\n\t\t\tdiv.innerHTML = \"\";\n\t\t\tdiv.style.cssText = divReset + \"width:1px;padding:1px;display:inline;zoom:1\";\n\t\t\tsupport.inlineBlockNeedsLayout = ( div.offsetWidth === 3 );\n\n\t\t\t// Check if elements with layout shrink-wrap their children\n\t\t\t// (IE 6 does this)\n\t\t\tdiv.style.display = \"block\";\n\t\t\tdiv.style.overflow = \"visible\";\n\t\t\tdiv.innerHTML = \"\";\n\t\t\tdiv.firstChild.style.width = \"5px\";\n\t\t\tsupport.shrinkWrapBlocks = ( div.offsetWidth !== 3 );\n\n\t\t\tcontainer.style.zoom = 1;\n\t\t}\n\n\t\t// Null elements to avoid leaks in IE\n\t\tbody.removeChild( container );\n\t\tcontainer = div = tds = marginDiv = null;\n\t});\n\n\t// Null elements to avoid leaks in IE\n\tfragment.removeChild( div );\n\tall = a = select = opt = input = fragment = div = null;\n\n\treturn support;\n})();\nvar rbrace = /(?:\\{[\\s\\S]*\\}|\\[[\\s\\S]*\\])$/,\n\trmultiDash = /([A-Z])/g;\n\njQuery.extend({\n\tcache: {},\n\n\tdeletedIds: [],\n\n\t// Remove at next major release (1.9/2.0)\n\tuuid: 0,\n\n\t// Unique for each copy of jQuery on the page\n\t// Non-digits removed to match rinlinejQuery\n\texpando: \"jQuery\" + ( jQuery.fn.jquery + Math.random() ).replace( /\\D/g, \"\" ),\n\n\t// The following elements throw uncatchable exceptions if you\n\t// attempt to add expando properties to them.\n\tnoData: {\n\t\t\"embed\": true,\n\t\t// Ban all objects except for Flash (which handle expandos)\n\t\t\"object\": \"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000\",\n\t\t\"applet\": true\n\t},\n\n\thasData: function( elem ) {\n\t\telem = elem.nodeType ? jQuery.cache[ elem[jQuery.expando] ] : elem[ jQuery.expando ];\n\t\treturn !!elem && !isEmptyDataObject( elem );\n\t},\n\n\tdata: function( elem, name, data, pvt /* Internal Use Only */ ) {\n\t\tif ( !jQuery.acceptData( elem ) ) {\n\t\t\treturn;\n\t\t}\n\n\t\tvar thisCache, ret,\n\t\t\tinternalKey = jQuery.expando,\n\t\t\tgetByName = typeof name === \"string\",\n\n\t\t\t// We have to handle DOM nodes and JS objects differently because IE6-7\n\t\t\t// can't GC object references properly across the DOM-JS boundary\n\t\t\tisNode = elem.nodeType,\n\n\t\t\t// Only DOM nodes need the global jQuery cache; JS object data is\n\t\t\t// attached directly to the object so GC can occur automatically\n\t\t\tcache = isNode ? jQuery.cache : elem,\n\n\t\t\t// Only defining an ID for JS objects if its cache already exists allows\n\t\t\t// the code to shortcut on the same path as a DOM node with no cache\n\t\t\tid = isNode ? elem[ internalKey ] : elem[ internalKey ] && internalKey;\n\n\t\t// Avoid doing any more work than we need to when trying to get data on an\n\t\t// object that has no data at all\n\t\tif ( (!id || !cache[id] || (!pvt && !cache[id].data)) && getByName && data === undefined ) {\n\t\t\treturn;\n\t\t}\n\n\t\tif ( !id ) {\n\t\t\t// Only DOM nodes need a new unique ID for each element since their data\n\t\t\t// ends up in the global cache\n\t\t\tif ( isNode ) {\n\t\t\t\telem[ internalKey ] = id = jQuery.deletedIds.pop() || jQuery.guid++;\n\t\t\t} else {\n\t\t\t\tid = internalKey;\n\t\t\t}\n\t\t}\n\n\t\tif ( !cache[ id ] ) {\n\t\t\tcache[ id ] = {};\n\n\t\t\t// Avoids exposing jQuery metadata on plain JS objects when the object\n\t\t\t// is serialized using JSON.stringify\n\t\t\tif ( !isNode ) {\n\t\t\t\tcache[ id ].toJSON = jQuery.noop;\n\t\t\t}\n\t\t}\n\n\t\t// An object can be passed to jQuery.data instead of a key/value pair; this gets\n\t\t// shallow copied over onto the existing cache\n\t\tif ( typeof name === \"object\" || typeof name === \"function\" ) {\n\t\t\tif ( pvt ) {\n\t\t\t\tcache[ id ] = jQuery.extend( cache[ id ], name );\n\t\t\t} else {\n\t\t\t\tcache[ id ].data = jQuery.extend( cache[ id ].data, name );\n\t\t\t}\n\t\t}\n\n\t\tthisCache = cache[ id ];\n\n\t\t// jQuery data() is stored in a separate object inside the object's internal data\n\t\t// cache in order to avoid key collisions between internal data and user-defined\n\t\t// data.\n\t\tif ( !pvt ) {\n\t\t\tif ( !thisCache.data ) {\n\t\t\t\tthisCache.data = {};\n\t\t\t}\n\n\t\t\tthisCache = thisCache.data;\n\t\t}\n\n\t\tif ( data !== undefined ) {\n\t\t\tthisCache[ jQuery.camelCase( name ) ] = data;\n\t\t}\n\n\t\t// Check for both converted-to-camel and non-converted data property names\n\t\t// If a data property was specified\n\t\tif ( getByName ) {\n\n\t\t\t// First Try to find as-is property data\n\t\t\tret = thisCache[ name ];\n\n\t\t\t// Test for null|undefined property data\n\t\t\tif ( ret == null ) {\n\n\t\t\t\t// Try to find the camelCased property\n\t\t\t\tret = thisCache[ jQuery.camelCase( name ) ];\n\t\t\t}\n\t\t} else {\n\t\t\tret = thisCache;\n\t\t}\n\n\t\treturn ret;\n\t},\n\n\tremoveData: function( elem, name, pvt /* Internal Use Only */ ) {\n\t\tif ( !jQuery.acceptData( elem ) ) {\n\t\t\treturn;\n\t\t}\n\n\t\tvar thisCache, i, l,\n\n\t\t\tisNode = elem.nodeType,\n\n\t\t\t// See jQuery.data for more information\n\t\t\tcache = isNode ? jQuery.cache : elem,\n\t\t\tid = isNode ? elem[ jQuery.expando ] : jQuery.expando;\n\n\t\t// If there is already no cache entry for this object, there is no\n\t\t// purpose in continuing\n\t\tif ( !cache[ id ] ) {\n\t\t\treturn;\n\t\t}\n\n\t\tif ( name ) {\n\n\t\t\tthisCache = pvt ? cache[ id ] : cache[ id ].data;\n\n\t\t\tif ( thisCache ) {\n\n\t\t\t\t// Support array or space separated string names for data keys\n\t\t\t\tif ( !jQuery.isArray( name ) ) {\n\n\t\t\t\t\t// try the string as a key before any manipulation\n\t\t\t\t\tif ( name in thisCache ) {\n\t\t\t\t\t\tname = [ name ];\n\t\t\t\t\t} else {\n\n\t\t\t\t\t\t// split the camel cased version by spaces unless a key with the spaces exists\n\t\t\t\t\t\tname = jQuery.camelCase( name );\n\t\t\t\t\t\tif ( name in thisCache ) {\n\t\t\t\t\t\t\tname = [ name ];\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tname = name.split(\" \");\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tfor ( i = 0, l = name.length; i < l; i++ ) {\n\t\t\t\t\tdelete thisCache[ name[i] ];\n\t\t\t\t}\n\n\t\t\t\t// If there is no data left in the cache, we want to continue\n\t\t\t\t// and let the cache object itself get destroyed\n\t\t\t\tif ( !( pvt ? isEmptyDataObject : jQuery.isEmptyObject )( thisCache ) ) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// See jQuery.data for more information\n\t\tif ( !pvt ) {\n\t\t\tdelete cache[ id ].data;\n\n\t\t\t// Don't destroy the parent cache unless the internal data object\n\t\t\t// had been the only thing left in it\n\t\t\tif ( !isEmptyDataObject( cache[ id ] ) ) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\t// Destroy the cache\n\t\tif ( isNode ) {\n\t\t\tjQuery.cleanData( [ elem ], true );\n\n\t\t// Use delete when supported for expandos or `cache` is not a window per isWindow (#10080)\n\t\t} else if ( jQuery.support.deleteExpando || cache != cache.window ) {\n\t\t\tdelete cache[ id ];\n\n\t\t// When all else fails, null\n\t\t} else {\n\t\t\tcache[ id ] = null;\n\t\t}\n\t},\n\n\t// For internal use only.\n\t_data: function( elem, name, data ) {\n\t\treturn jQuery.data( elem, name, data, true );\n\t},\n\n\t// A method for determining if a DOM node can handle the data expando\n\tacceptData: function( elem ) {\n\t\tvar noData = elem.nodeName && jQuery.noData[ elem.nodeName.toLowerCase() ];\n\n\t\t// nodes accept data unless otherwise specified; rejection can be conditional\n\t\treturn !noData || noData !== true && elem.getAttribute(\"classid\") === noData;\n\t}\n});\n\njQuery.fn.extend({\n\tdata: function( key, value ) {\n\t\tvar parts, part, attr, name, l,\n\t\t\telem = this[0],\n\t\t\ti = 0,\n\t\t\tdata = null;\n\n\t\t// Gets all values\n\t\tif ( key === undefined ) {\n\t\t\tif ( this.length ) {\n\t\t\t\tdata = jQuery.data( elem );\n\n\t\t\t\tif ( elem.nodeType === 1 && !jQuery._data( elem, \"parsedAttrs\" ) ) {\n\t\t\t\t\tattr = elem.attributes;\n\t\t\t\t\tfor ( l = attr.length; i < l; i++ ) {\n\t\t\t\t\t\tname = attr[i].name;\n\n\t\t\t\t\t\tif ( !name.indexOf( \"data-\" ) ) {\n\t\t\t\t\t\t\tname = jQuery.camelCase( name.substring(5) );\n\n\t\t\t\t\t\t\tdataAttr( elem, name, data[ name ] );\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tjQuery._data( elem, \"parsedAttrs\", true );\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn data;\n\t\t}\n\n\t\t// Sets multiple values\n\t\tif ( typeof key === \"object\" ) {\n\t\t\treturn this.each(function() {\n\t\t\t\tjQuery.data( this, key );\n\t\t\t});\n\t\t}\n\n\t\tparts = key.split( \".\", 2 );\n\t\tparts[1] = parts[1] ? \".\" + parts[1] : \"\";\n\t\tpart = parts[1] + \"!\";\n\n\t\treturn jQuery.access( this, function( value ) {\n\n\t\t\tif ( value === undefined ) {\n\t\t\t\tdata = this.triggerHandler( \"getData\" + part, [ parts[0] ] );\n\n\t\t\t\t// Try to fetch any internally stored data first\n\t\t\t\tif ( data === undefined && elem ) {\n\t\t\t\t\tdata = jQuery.data( elem, key );\n\t\t\t\t\tdata = dataAttr( elem, key, data );\n\t\t\t\t}\n\n\t\t\t\treturn data === undefined && parts[1] ?\n\t\t\t\t\tthis.data( parts[0] ) :\n\t\t\t\t\tdata;\n\t\t\t}\n\n\t\t\tparts[1] = value;\n\t\t\tthis.each(function() {\n\t\t\t\tvar self = jQuery( this );\n\n\t\t\t\tself.triggerHandler( \"setData\" + part, parts );\n\t\t\t\tjQuery.data( this, key, value );\n\t\t\t\tself.triggerHandler( \"changeData\" + part, parts );\n\t\t\t});\n\t\t}, null, value, arguments.length > 1, null, false );\n\t},\n\n\tremoveData: function( key ) {\n\t\treturn this.each(function() {\n\t\t\tjQuery.removeData( this, key );\n\t\t});\n\t}\n});\n\nfunction dataAttr( elem, key, data ) {\n\t// If nothing was found internally, try to fetch any\n\t// data from the HTML5 data-* attribute\n\tif ( data === undefined && elem.nodeType === 1 ) {\n\n\t\tvar name = \"data-\" + key.replace( rmultiDash, \"-$1\" ).toLowerCase();\n\n\t\tdata = elem.getAttribute( name );\n\n\t\tif ( typeof data === \"string\" ) {\n\t\t\ttry {\n\t\t\t\tdata = data === \"true\" ? true :\n\t\t\t\tdata === \"false\" ? false :\n\t\t\t\tdata === \"null\" ? null :\n\t\t\t\t// Only convert to a number if it doesn't change the string\n\t\t\t\t+data + \"\" === data ? +data :\n\t\t\t\trbrace.test( data ) ? jQuery.parseJSON( data ) :\n\t\t\t\t\tdata;\n\t\t\t} catch( e ) {}\n\n\t\t\t// Make sure we set the data so it isn't changed later\n\t\t\tjQuery.data( elem, key, data );\n\n\t\t} else {\n\t\t\tdata = undefined;\n\t\t}\n\t}\n\n\treturn data;\n}\n\n// checks a cache object for emptiness\nfunction isEmptyDataObject( obj ) {\n\tvar name;\n\tfor ( name in obj ) {\n\n\t\t// if the public data object is empty, the private is still empty\n\t\tif ( name === \"data\" && jQuery.isEmptyObject( obj[name] ) ) {\n\t\t\tcontinue;\n\t\t}\n\t\tif ( name !== \"toJSON\" ) {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\treturn true;\n}\njQuery.extend({\n\tqueue: function( elem, type, data ) {\n\t\tvar queue;\n\n\t\tif ( elem ) {\n\t\t\ttype = ( type || \"fx\" ) + \"queue\";\n\t\t\tqueue = jQuery._data( elem, type );\n\n\t\t\t// Speed up dequeue by getting out quickly if this is just a lookup\n\t\t\tif ( data ) {\n\t\t\t\tif ( !queue || jQuery.isArray(data) ) {\n\t\t\t\t\tqueue = jQuery._data( elem, type, jQuery.makeArray(data) );\n\t\t\t\t} else {\n\t\t\t\t\tqueue.push( data );\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn queue || [];\n\t\t}\n\t},\n\n\tdequeue: function( elem, type ) {\n\t\ttype = type || \"fx\";\n\n\t\tvar queue = jQuery.queue( elem, type ),\n\t\t\tstartLength = queue.length,\n\t\t\tfn = queue.shift(),\n\t\t\thooks = jQuery._queueHooks( elem, type ),\n\t\t\tnext = function() {\n\t\t\t\tjQuery.dequeue( elem, type );\n\t\t\t};\n\n\t\t// If the fx queue is dequeued, always remove the progress sentinel\n\t\tif ( fn === \"inprogress\" ) {\n\t\t\tfn = queue.shift();\n\t\t\tstartLength--;\n\t\t}\n\n\t\tif ( fn ) {\n\n\t\t\t// Add a progress sentinel to prevent the fx queue from being\n\t\t\t// automatically dequeued\n\t\t\tif ( type === \"fx\" ) {\n\t\t\t\tqueue.unshift( \"inprogress\" );\n\t\t\t}\n\n\t\t\t// clear up the last queue stop function\n\t\t\tdelete hooks.stop;\n\t\t\tfn.call( elem, next, hooks );\n\t\t}\n\n\t\tif ( !startLength && hooks ) {\n\t\t\thooks.empty.fire();\n\t\t}\n\t},\n\n\t// not intended for public consumption - generates a queueHooks object, or returns the current one\n\t_queueHooks: function( elem, type ) {\n\t\tvar key = type + \"queueHooks\";\n\t\treturn jQuery._data( elem, key ) || jQuery._data( elem, key, {\n\t\t\tempty: jQuery.Callbacks(\"once memory\").add(function() {\n\t\t\t\tjQuery.removeData( elem, type + \"queue\", true );\n\t\t\t\tjQuery.removeData( elem, key, true );\n\t\t\t})\n\t\t});\n\t}\n});\n\njQuery.fn.extend({\n\tqueue: function( type, data ) {\n\t\tvar setter = 2;\n\n\t\tif ( typeof type !== \"string\" ) {\n\t\t\tdata = type;\n\t\t\ttype = \"fx\";\n\t\t\tsetter--;\n\t\t}\n\n\t\tif ( arguments.length < setter ) {\n\t\t\treturn jQuery.queue( this[0], type );\n\t\t}\n\n\t\treturn data === undefined ?\n\t\t\tthis :\n\t\t\tthis.each(function() {\n\t\t\t\tvar queue = jQuery.queue( this, type, data );\n\n\t\t\t\t// ensure a hooks for this queue\n\t\t\t\tjQuery._queueHooks( this, type );\n\n\t\t\t\tif ( type === \"fx\" && queue[0] !== \"inprogress\" ) {\n\t\t\t\t\tjQuery.dequeue( this, type );\n\t\t\t\t}\n\t\t\t});\n\t},\n\tdequeue: function( type ) {\n\t\treturn this.each(function() {\n\t\t\tjQuery.dequeue( this, type );\n\t\t});\n\t},\n\t// Based off of the plugin by Clint Helfers, with permission.\n\t// http://blindsignals.com/index.php/2009/07/jquery-delay/\n\tdelay: function( time, type ) {\n\t\ttime = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time;\n\t\ttype = type || \"fx\";\n\n\t\treturn this.queue( type, function( next, hooks ) {\n\t\t\tvar timeout = setTimeout( next, time );\n\t\t\thooks.stop = function() {\n\t\t\t\tclearTimeout( timeout );\n\t\t\t};\n\t\t});\n\t},\n\tclearQueue: function( type ) {\n\t\treturn this.queue( type || \"fx\", [] );\n\t},\n\t// Get a promise resolved when queues of a certain type\n\t// are emptied (fx is the type by default)\n\tpromise: function( type, obj ) {\n\t\tvar tmp,\n\t\t\tcount = 1,\n\t\t\tdefer = jQuery.Deferred(),\n\t\t\telements = this,\n\t\t\ti = this.length,\n\t\t\tresolve = function() {\n\t\t\t\tif ( !( --count ) ) {\n\t\t\t\t\tdefer.resolveWith( elements, [ elements ] );\n\t\t\t\t}\n\t\t\t};\n\n\t\tif ( typeof type !== \"string\" ) {\n\t\t\tobj = type;\n\t\t\ttype = undefined;\n\t\t}\n\t\ttype = type || \"fx\";\n\n\t\twhile( i-- ) {\n\t\t\ttmp = jQuery._data( elements[ i ], type + \"queueHooks\" );\n\t\t\tif ( tmp && tmp.empty ) {\n\t\t\t\tcount++;\n\t\t\t\ttmp.empty.add( resolve );\n\t\t\t}\n\t\t}\n\t\tresolve();\n\t\treturn defer.promise( obj );\n\t}\n});\nvar nodeHook, boolHook, fixSpecified,\n\trclass = /[\\t\\r\\n]/g,\n\trreturn = /\\r/g,\n\trtype = /^(?:button|input)$/i,\n\trfocusable = /^(?:button|input|object|select|textarea)$/i,\n\trclickable = /^a(?:rea|)$/i,\n\trboolean = /^(?:autofocus|autoplay|async|checked|controls|defer|disabled|hidden|loop|multiple|open|readonly|required|scoped|selected)$/i,\n\tgetSetAttribute = jQuery.support.getSetAttribute;\n\njQuery.fn.extend({\n\tattr: function( name, value ) {\n\t\treturn jQuery.access( this, jQuery.attr, name, value, arguments.length > 1 );\n\t},\n\n\tremoveAttr: function( name ) {\n\t\treturn this.each(function() {\n\t\t\tjQuery.removeAttr( this, name );\n\t\t});\n\t},\n\n\tprop: function( name, value ) {\n\t\treturn jQuery.access( this, jQuery.prop, name, value, arguments.length > 1 );\n\t},\n\n\tremoveProp: function( name ) {\n\t\tname = jQuery.propFix[ name ] || name;\n\t\treturn this.each(function() {\n\t\t\t// try/catch handles cases where IE balks (such as removing a property on window)\n\t\t\ttry {\n\t\t\t\tthis[ name ] = undefined;\n\t\t\t\tdelete this[ name ];\n\t\t\t} catch( e ) {}\n\t\t});\n\t},\n\n\taddClass: function( value ) {\n\t\tvar classNames, i, l, elem,\n\t\t\tsetClass, c, cl;\n\n\t\tif ( jQuery.isFunction( value ) ) {\n\t\t\treturn this.each(function( j ) {\n\t\t\t\tjQuery( this ).addClass( value.call(this, j, this.className) );\n\t\t\t});\n\t\t}\n\n\t\tif ( value && typeof value === \"string\" ) {\n\t\t\tclassNames = value.split( core_rspace );\n\n\t\t\tfor ( i = 0, l = this.length; i < l; i++ ) {\n\t\t\t\telem = this[ i ];\n\n\t\t\t\tif ( elem.nodeType === 1 ) {\n\t\t\t\t\tif ( !elem.className && classNames.length === 1 ) {\n\t\t\t\t\t\telem.className = value;\n\n\t\t\t\t\t} else {\n\t\t\t\t\t\tsetClass = \" \" + elem.className + \" \";\n\n\t\t\t\t\t\tfor ( c = 0, cl = classNames.length; c < cl; c++ ) {\n\t\t\t\t\t\t\tif ( setClass.indexOf( \" \" + classNames[ c ] + \" \" ) < 0 ) {\n\t\t\t\t\t\t\t\tsetClass += classNames[ c ] + \" \";\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\telem.className = jQuery.trim( setClass );\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn this;\n\t},\n\n\tremoveClass: function( value ) {\n\t\tvar removes, className, elem, c, cl, i, l;\n\n\t\tif ( jQuery.isFunction( value ) ) {\n\t\t\treturn this.each(function( j ) {\n\t\t\t\tjQuery( this ).removeClass( value.call(this, j, this.className) );\n\t\t\t});\n\t\t}\n\t\tif ( (value && typeof value === \"string\") || value === undefined ) {\n\t\t\tremoves = ( value || \"\" ).split( core_rspace );\n\n\t\t\tfor ( i = 0, l = this.length; i < l; i++ ) {\n\t\t\t\telem = this[ i ];\n\t\t\t\tif ( elem.nodeType === 1 && elem.className ) {\n\n\t\t\t\t\tclassName = (\" \" + elem.className + \" \").replace( rclass, \" \" );\n\n\t\t\t\t\t// loop over each item in the removal list\n\t\t\t\t\tfor ( c = 0, cl = removes.length; c < cl; c++ ) {\n\t\t\t\t\t\t// Remove until there is nothing to remove,\n\t\t\t\t\t\twhile ( className.indexOf(\" \" + removes[ c ] + \" \") >= 0 ) {\n\t\t\t\t\t\t\tclassName = className.replace( \" \" + removes[ c ] + \" \" , \" \" );\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\telem.className = value ? jQuery.trim( className ) : \"\";\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn this;\n\t},\n\n\ttoggleClass: function( value, stateVal ) {\n\t\tvar type = typeof value,\n\t\t\tisBool = typeof stateVal === \"boolean\";\n\n\t\tif ( jQuery.isFunction( value ) ) {\n\t\t\treturn this.each(function( i ) {\n\t\t\t\tjQuery( this ).toggleClass( value.call(this, i, this.className, stateVal), stateVal );\n\t\t\t});\n\t\t}\n\n\t\treturn this.each(function() {\n\t\t\tif ( type === \"string\" ) {\n\t\t\t\t// toggle individual class names\n\t\t\t\tvar className,\n\t\t\t\t\ti = 0,\n\t\t\t\t\tself = jQuery( this ),\n\t\t\t\t\tstate = stateVal,\n\t\t\t\t\tclassNames = value.split( core_rspace );\n\n\t\t\t\twhile ( (className = classNames[ i++ ]) ) {\n\t\t\t\t\t// check each className given, space separated list\n\t\t\t\t\tstate = isBool ? state : !self.hasClass( className );\n\t\t\t\t\tself[ state ? \"addClass\" : \"removeClass\" ]( className );\n\t\t\t\t}\n\n\t\t\t} else if ( type === \"undefined\" || type === \"boolean\" ) {\n\t\t\t\tif ( this.className ) {\n\t\t\t\t\t// store className if set\n\t\t\t\t\tjQuery._data( this, \"__className__\", this.className );\n\t\t\t\t}\n\n\t\t\t\t// toggle whole className\n\t\t\t\tthis.className = this.className || value === false ? \"\" : jQuery._data( this, \"__className__\" ) || \"\";\n\t\t\t}\n\t\t});\n\t},\n\n\thasClass: function( selector ) {\n\t\tvar className = \" \" + selector + \" \",\n\t\t\ti = 0,\n\t\t\tl = this.length;\n\t\tfor ( ; i < l; i++ ) {\n\t\t\tif ( this[i].nodeType === 1 && (\" \" + this[i].className + \" \").replace(rclass, \" \").indexOf( className ) >= 0 ) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\n\t\treturn false;\n\t},\n\n\tval: function( value ) {\n\t\tvar hooks, ret, isFunction,\n\t\t\telem = this[0];\n\n\t\tif ( !arguments.length ) {\n\t\t\tif ( elem ) {\n\t\t\t\thooks = jQuery.valHooks[ elem.type ] || jQuery.valHooks[ elem.nodeName.toLowerCase() ];\n\n\t\t\t\tif ( hooks && \"get\" in hooks && (ret = hooks.get( elem, \"value\" )) !== undefined ) {\n\t\t\t\t\treturn ret;\n\t\t\t\t}\n\n\t\t\t\tret = elem.value;\n\n\t\t\t\treturn typeof ret === \"string\" ?\n\t\t\t\t\t// handle most common string cases\n\t\t\t\t\tret.replace(rreturn, \"\") :\n\t\t\t\t\t// handle cases where value is null/undef or number\n\t\t\t\t\tret == null ? \"\" : ret;\n\t\t\t}\n\n\t\t\treturn;\n\t\t}\n\n\t\tisFunction = jQuery.isFunction( value );\n\n\t\treturn this.each(function( i ) {\n\t\t\tvar val,\n\t\t\t\tself = jQuery(this);\n\n\t\t\tif ( this.nodeType !== 1 ) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tif ( isFunction ) {\n\t\t\t\tval = value.call( this, i, self.val() );\n\t\t\t} else {\n\t\t\t\tval = value;\n\t\t\t}\n\n\t\t\t// Treat null/undefined as \"\"; convert numbers to string\n\t\t\tif ( val == null ) {\n\t\t\t\tval = \"\";\n\t\t\t} else if ( typeof val === \"number\" ) {\n\t\t\t\tval += \"\";\n\t\t\t} else if ( jQuery.isArray( val ) ) {\n\t\t\t\tval = jQuery.map(val, function ( value ) {\n\t\t\t\t\treturn value == null ? \"\" : value + \"\";\n\t\t\t\t});\n\t\t\t}\n\n\t\t\thooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ];\n\n\t\t\t// If set returns undefined, fall back to normal setting\n\t\t\tif ( !hooks || !(\"set\" in hooks) || hooks.set( this, val, \"value\" ) === undefined ) {\n\t\t\t\tthis.value = val;\n\t\t\t}\n\t\t});\n\t}\n});\n\njQuery.extend({\n\tvalHooks: {\n\t\toption: {\n\t\t\tget: function( elem ) {\n\t\t\t\t// attributes.value is undefined in Blackberry 4.7 but\n\t\t\t\t// uses .value. See #6932\n\t\t\t\tvar val = elem.attributes.value;\n\t\t\t\treturn !val || val.specified ? elem.value : elem.text;\n\t\t\t}\n\t\t},\n\t\tselect: {\n\t\t\tget: function( elem ) {\n\t\t\t\tvar value, option,\n\t\t\t\t\toptions = elem.options,\n\t\t\t\t\tindex = elem.selectedIndex,\n\t\t\t\t\tone = elem.type === \"select-one\" || index < 0,\n\t\t\t\t\tvalues = one ? null : [],\n\t\t\t\t\tmax = one ? index + 1 : options.length,\n\t\t\t\t\ti = index < 0 ?\n\t\t\t\t\t\tmax :\n\t\t\t\t\t\tone ? index : 0;\n\n\t\t\t\t// Loop through all the selected options\n\t\t\t\tfor ( ; i < max; i++ ) {\n\t\t\t\t\toption = options[ i ];\n\n\t\t\t\t\t// oldIE doesn't update selected after form reset (#2551)\n\t\t\t\t\tif ( ( option.selected || i === index ) &&\n\t\t\t\t\t\t\t// Don't return options that are disabled or in a disabled optgroup\n\t\t\t\t\t\t\t( jQuery.support.optDisabled ? !option.disabled : option.getAttribute(\"disabled\") === null ) &&\n\t\t\t\t\t\t\t( !option.parentNode.disabled || !jQuery.nodeName( option.parentNode, \"optgroup\" ) ) ) {\n\n\t\t\t\t\t\t// Get the specific value for the option\n\t\t\t\t\t\tvalue = jQuery( option ).val();\n\n\t\t\t\t\t\t// We don't need an array for one selects\n\t\t\t\t\t\tif ( one ) {\n\t\t\t\t\t\t\treturn value;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Multi-Selects return an array\n\t\t\t\t\t\tvalues.push( value );\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\treturn values;\n\t\t\t},\n\n\t\t\tset: function( elem, value ) {\n\t\t\t\tvar values = jQuery.makeArray( value );\n\n\t\t\t\tjQuery(elem).find(\"option\").each(function() {\n\t\t\t\t\tthis.selected = jQuery.inArray( jQuery(this).val(), values ) >= 0;\n\t\t\t\t});\n\n\t\t\t\tif ( !values.length ) {\n\t\t\t\t\telem.selectedIndex = -1;\n\t\t\t\t}\n\t\t\t\treturn values;\n\t\t\t}\n\t\t}\n\t},\n\n\t// Unused in 1.8, left in so attrFn-stabbers won't die; remove in 1.9\n\tattrFn: {},\n\n\tattr: function( elem, name, value, pass ) {\n\t\tvar ret, hooks, notxml,\n\t\t\tnType = elem.nodeType;\n\n\t\t// don't get/set attributes on text, comment and attribute nodes\n\t\tif ( !elem || nType === 3 || nType === 8 || nType === 2 ) {\n\t\t\treturn;\n\t\t}\n\n\t\tif ( pass && jQuery.isFunction( jQuery.fn[ name ] ) ) {\n\t\t\treturn jQuery( elem )[ name ]( value );\n\t\t}\n\n\t\t// Fallback to prop when attributes are not supported\n\t\tif ( typeof elem.getAttribute === \"undefined\" ) {\n\t\t\treturn jQuery.prop( elem, name, value );\n\t\t}\n\n\t\tnotxml = nType !== 1 || !jQuery.isXMLDoc( elem );\n\n\t\t// All attributes are lowercase\n\t\t// Grab necessary hook if one is defined\n\t\tif ( notxml ) {\n\t\t\tname = name.toLowerCase();\n\t\t\thooks = jQuery.attrHooks[ name ] || ( rboolean.test( name ) ? boolHook : nodeHook );\n\t\t}\n\n\t\tif ( value !== undefined ) {\n\n\t\t\tif ( value === null ) {\n\t\t\t\tjQuery.removeAttr( elem, name );\n\t\t\t\treturn;\n\n\t\t\t} else if ( hooks && \"set\" in hooks && notxml && (ret = hooks.set( elem, value, name )) !== undefined ) {\n\t\t\t\treturn ret;\n\n\t\t\t} else {\n\t\t\t\telem.setAttribute( name, value + \"\" );\n\t\t\t\treturn value;\n\t\t\t}\n\n\t\t} else if ( hooks && \"get\" in hooks && notxml && (ret = hooks.get( elem, name )) !== null ) {\n\t\t\treturn ret;\n\n\t\t} else {\n\n\t\t\tret = elem.getAttribute( name );\n\n\t\t\t// Non-existent attributes return null, we normalize to undefined\n\t\t\treturn ret === null ?\n\t\t\t\tundefined :\n\t\t\t\tret;\n\t\t}\n\t},\n\n\tremoveAttr: function( elem, value ) {\n\t\tvar propName, attrNames, name, isBool,\n\t\t\ti = 0;\n\n\t\tif ( value && elem.nodeType === 1 ) {\n\n\t\t\tattrNames = value.split( core_rspace );\n\n\t\t\tfor ( ; i < attrNames.length; i++ ) {\n\t\t\t\tname = attrNames[ i ];\n\n\t\t\t\tif ( name ) {\n\t\t\t\t\tpropName = jQuery.propFix[ name ] || name;\n\t\t\t\t\tisBool = rboolean.test( name );\n\n\t\t\t\t\t// See #9699 for explanation of this approach (setting first, then removal)\n\t\t\t\t\t// Do not do this for boolean attributes (see #10870)\n\t\t\t\t\tif ( !isBool ) {\n\t\t\t\t\t\tjQuery.attr( elem, name, \"\" );\n\t\t\t\t\t}\n\t\t\t\t\telem.removeAttribute( getSetAttribute ? name : propName );\n\n\t\t\t\t\t// Set corresponding property to false for boolean attributes\n\t\t\t\t\tif ( isBool && propName in elem ) {\n\t\t\t\t\t\telem[ propName ] = false;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t},\n\n\tattrHooks: {\n\t\ttype: {\n\t\t\tset: function( elem, value ) {\n\t\t\t\t// We can't allow the type property to be changed (since it causes problems in IE)\n\t\t\t\tif ( rtype.test( elem.nodeName ) && elem.parentNode ) {\n\t\t\t\t\tjQuery.error( \"type property can't be changed\" );\n\t\t\t\t} else if ( !jQuery.support.radioValue && value === \"radio\" && jQuery.nodeName(elem, \"input\") ) {\n\t\t\t\t\t// Setting the type on a radio button after the value resets the value in IE6-9\n\t\t\t\t\t// Reset value to it's default in case type is set after value\n\t\t\t\t\t// This is for element creation\n\t\t\t\t\tvar val = elem.value;\n\t\t\t\t\telem.setAttribute( \"type\", value );\n\t\t\t\t\tif ( val ) {\n\t\t\t\t\t\telem.value = val;\n\t\t\t\t\t}\n\t\t\t\t\treturn value;\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t// Use the value property for back compat\n\t\t// Use the nodeHook for button elements in IE6/7 (#1954)\n\t\tvalue: {\n\t\t\tget: function( elem, name ) {\n\t\t\t\tif ( nodeHook && jQuery.nodeName( elem, \"button\" ) ) {\n\t\t\t\t\treturn nodeHook.get( elem, name );\n\t\t\t\t}\n\t\t\t\treturn name in elem ?\n\t\t\t\t\telem.value :\n\t\t\t\t\tnull;\n\t\t\t},\n\t\t\tset: function( elem, value, name ) {\n\t\t\t\tif ( nodeHook && jQuery.nodeName( elem, \"button\" ) ) {\n\t\t\t\t\treturn nodeHook.set( elem, value, name );\n\t\t\t\t}\n\t\t\t\t// Does not return so that setAttribute is also used\n\t\t\t\telem.value = value;\n\t\t\t}\n\t\t}\n\t},\n\n\tpropFix: {\n\t\ttabindex: \"tabIndex\",\n\t\treadonly: \"readOnly\",\n\t\t\"for\": \"htmlFor\",\n\t\t\"class\": \"className\",\n\t\tmaxlength: \"maxLength\",\n\t\tcellspacing: \"cellSpacing\",\n\t\tcellpadding: \"cellPadding\",\n\t\trowspan: \"rowSpan\",\n\t\tcolspan: \"colSpan\",\n\t\tusemap: \"useMap\",\n\t\tframeborder: \"frameBorder\",\n\t\tcontenteditable: \"contentEditable\"\n\t},\n\n\tprop: function( elem, name, value ) {\n\t\tvar ret, hooks, notxml,\n\t\t\tnType = elem.nodeType;\n\n\t\t// don't get/set properties on text, comment and attribute nodes\n\t\tif ( !elem || nType === 3 || nType === 8 || nType === 2 ) {\n\t\t\treturn;\n\t\t}\n\n\t\tnotxml = nType !== 1 || !jQuery.isXMLDoc( elem );\n\n\t\tif ( notxml ) {\n\t\t\t// Fix name and attach hooks\n\t\t\tname = jQuery.propFix[ name ] || name;\n\t\t\thooks = jQuery.propHooks[ name ];\n\t\t}\n\n\t\tif ( value !== undefined ) {\n\t\t\tif ( hooks && \"set\" in hooks && (ret = hooks.set( elem, value, name )) !== undefined ) {\n\t\t\t\treturn ret;\n\n\t\t\t} else {\n\t\t\t\treturn ( elem[ name ] = value );\n\t\t\t}\n\n\t\t} else {\n\t\t\tif ( hooks && \"get\" in hooks && (ret = hooks.get( elem, name )) !== null ) {\n\t\t\t\treturn ret;\n\n\t\t\t} else {\n\t\t\t\treturn elem[ name ];\n\t\t\t}\n\t\t}\n\t},\n\n\tpropHooks: {\n\t\ttabIndex: {\n\t\t\tget: function( elem ) {\n\t\t\t\t// elem.tabIndex doesn't always return the correct value when it hasn't been explicitly set\n\t\t\t\t// http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/\n\t\t\t\tvar attributeNode = elem.getAttributeNode(\"tabindex\");\n\n\t\t\t\treturn attributeNode && attributeNode.specified ?\n\t\t\t\t\tparseInt( attributeNode.value, 10 ) :\n\t\t\t\t\trfocusable.test( elem.nodeName ) || rclickable.test( elem.nodeName ) && elem.href ?\n\t\t\t\t\t\t0 :\n\t\t\t\t\t\tundefined;\n\t\t\t}\n\t\t}\n\t}\n});\n\n// Hook for boolean attributes\nboolHook = {\n\tget: function( elem, name ) {\n\t\t// Align boolean attributes with corresponding properties\n\t\t// Fall back to attribute presence where some booleans are not supported\n\t\tvar attrNode,\n\t\t\tproperty = jQuery.prop( elem, name );\n\t\treturn property === true || typeof property !== \"boolean\" && ( attrNode = elem.getAttributeNode(name) ) && attrNode.nodeValue !== false ?\n\t\t\tname.toLowerCase() :\n\t\t\tundefined;\n\t},\n\tset: function( elem, value, name ) {\n\t\tvar propName;\n\t\tif ( value === false ) {\n\t\t\t// Remove boolean attributes when set to false\n\t\t\tjQuery.removeAttr( elem, name );\n\t\t} else {\n\t\t\t// value is true since we know at this point it's type boolean and not false\n\t\t\t// Set boolean attributes to the same name and set the DOM property\n\t\t\tpropName = jQuery.propFix[ name ] || name;\n\t\t\tif ( propName in elem ) {\n\t\t\t\t// Only set the IDL specifically if it already exists on the element\n\t\t\t\telem[ propName ] = true;\n\t\t\t}\n\n\t\t\telem.setAttribute( name, name.toLowerCase() );\n\t\t}\n\t\treturn name;\n\t}\n};\n\n// IE6/7 do not support getting/setting some attributes with get/setAttribute\nif ( !getSetAttribute ) {\n\n\tfixSpecified = {\n\t\tname: true,\n\t\tid: true,\n\t\tcoords: true\n\t};\n\n\t// Use this for any attribute in IE6/7\n\t// This fixes almost every IE6/7 issue\n\tnodeHook = jQuery.valHooks.button = {\n\t\tget: function( elem, name ) {\n\t\t\tvar ret;\n\t\t\tret = elem.getAttributeNode( name );\n\t\t\treturn ret && ( fixSpecified[ name ] ? ret.value !== \"\" : ret.specified ) ?\n\t\t\t\tret.value :\n\t\t\t\tundefined;\n\t\t},\n\t\tset: function( elem, value, name ) {\n\t\t\t// Set the existing or create a new attribute node\n\t\t\tvar ret = elem.getAttributeNode( name );\n\t\t\tif ( !ret ) {\n\t\t\t\tret = document.createAttribute( name );\n\t\t\t\telem.setAttributeNode( ret );\n\t\t\t}\n\t\t\treturn ( ret.value = value + \"\" );\n\t\t}\n\t};\n\n\t// Set width and height to auto instead of 0 on empty string( Bug #8150 )\n\t// This is for removals\n\tjQuery.each([ \"width\", \"height\" ], function( i, name ) {\n\t\tjQuery.attrHooks[ name ] = jQuery.extend( jQuery.attrHooks[ name ], {\n\t\t\tset: function( elem, value ) {\n\t\t\t\tif ( value === \"\" ) {\n\t\t\t\t\telem.setAttribute( name, \"auto\" );\n\t\t\t\t\treturn value;\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t});\n\n\t// Set contenteditable to false on removals(#10429)\n\t// Setting to empty string throws an error as an invalid value\n\tjQuery.attrHooks.contenteditable = {\n\t\tget: nodeHook.get,\n\t\tset: function( elem, value, name ) {\n\t\t\tif ( value === \"\" ) {\n\t\t\t\tvalue = \"false\";\n\t\t\t}\n\t\t\tnodeHook.set( elem, value, name );\n\t\t}\n\t};\n}\n\n\n// Some attributes require a special call on IE\nif ( !jQuery.support.hrefNormalized ) {\n\tjQuery.each([ \"href\", \"src\", \"width\", \"height\" ], function( i, name ) {\n\t\tjQuery.attrHooks[ name ] = jQuery.extend( jQuery.attrHooks[ name ], {\n\t\t\tget: function( elem ) {\n\t\t\t\tvar ret = elem.getAttribute( name, 2 );\n\t\t\t\treturn ret === null ? undefined : ret;\n\t\t\t}\n\t\t});\n\t});\n}\n\nif ( !jQuery.support.style ) {\n\tjQuery.attrHooks.style = {\n\t\tget: function( elem ) {\n\t\t\t// Return undefined in the case of empty string\n\t\t\t// Normalize to lowercase since IE uppercases css property names\n\t\t\treturn elem.style.cssText.toLowerCase() || undefined;\n\t\t},\n\t\tset: function( elem, value ) {\n\t\t\treturn ( elem.style.cssText = value + \"\" );\n\t\t}\n\t};\n}\n\n// Safari mis-reports the default selected property of an option\n// Accessing the parent's selectedIndex property fixes it\nif ( !jQuery.support.optSelected ) {\n\tjQuery.propHooks.selected = jQuery.extend( jQuery.propHooks.selected, {\n\t\tget: function( elem ) {\n\t\t\tvar parent = elem.parentNode;\n\n\t\t\tif ( parent ) {\n\t\t\t\tparent.selectedIndex;\n\n\t\t\t\t// Make sure that it also works with optgroups, see #5701\n\t\t\t\tif ( parent.parentNode ) {\n\t\t\t\t\tparent.parentNode.selectedIndex;\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn null;\n\t\t}\n\t});\n}\n\n// IE6/7 call enctype encoding\nif ( !jQuery.support.enctype ) {\n\tjQuery.propFix.enctype = \"encoding\";\n}\n\n// Radios and checkboxes getter/setter\nif ( !jQuery.support.checkOn ) {\n\tjQuery.each([ \"radio\", \"checkbox\" ], function() {\n\t\tjQuery.valHooks[ this ] = {\n\t\t\tget: function( elem ) {\n\t\t\t\t// Handle the case where in Webkit \"\" is returned instead of \"on\" if a value isn't specified\n\t\t\t\treturn elem.getAttribute(\"value\") === null ? \"on\" : elem.value;\n\t\t\t}\n\t\t};\n\t});\n}\njQuery.each([ \"radio\", \"checkbox\" ], function() {\n\tjQuery.valHooks[ this ] = jQuery.extend( jQuery.valHooks[ this ], {\n\t\tset: function( elem, value ) {\n\t\t\tif ( jQuery.isArray( value ) ) {\n\t\t\t\treturn ( elem.checked = jQuery.inArray( jQuery(elem).val(), value ) >= 0 );\n\t\t\t}\n\t\t}\n\t});\n});\nvar rformElems = /^(?:textarea|input|select)$/i,\n\trtypenamespace = /^([^\\.]*|)(?:\\.(.+)|)$/,\n\trhoverHack = /(?:^|\\s)hover(\\.\\S+|)\\b/,\n\trkeyEvent = /^key/,\n\trmouseEvent = /^(?:mouse|contextmenu)|click/,\n\trfocusMorph = /^(?:focusinfocus|focusoutblur)$/,\n\thoverHack = function( events ) {\n\t\treturn jQuery.event.special.hover ? events : events.replace( rhoverHack, \"mouseenter$1 mouseleave$1\" );\n\t};\n\n/*\n * Helper functions for managing events -- not part of the public interface.\n * Props to Dean Edwards' addEvent library for many of the ideas.\n */\njQuery.event = {\n\n\tadd: function( elem, types, handler, data, selector ) {\n\n\t\tvar elemData, eventHandle, events,\n\t\t\tt, tns, type, namespaces, handleObj,\n\t\t\thandleObjIn, handlers, special;\n\n\t\t// Don't attach events to noData or text/comment nodes (allow plain objects tho)\n\t\tif ( elem.nodeType === 3 || elem.nodeType === 8 || !types || !handler || !(elemData = jQuery._data( elem )) ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Caller can pass in an object of custom data in lieu of the handler\n\t\tif ( handler.handler ) {\n\t\t\thandleObjIn = handler;\n\t\t\thandler = handleObjIn.handler;\n\t\t\tselector = handleObjIn.selector;\n\t\t}\n\n\t\t// Make sure that the handler has a unique ID, used to find/remove it later\n\t\tif ( !handler.guid ) {\n\t\t\thandler.guid = jQuery.guid++;\n\t\t}\n\n\t\t// Init the element's event structure and main handler, if this is the first\n\t\tevents = elemData.events;\n\t\tif ( !events ) {\n\t\t\telemData.events = events = {};\n\t\t}\n\t\teventHandle = elemData.handle;\n\t\tif ( !eventHandle ) {\n\t\t\telemData.handle = eventHandle = function( e ) {\n\t\t\t\t// Discard the second event of a jQuery.event.trigger() and\n\t\t\t\t// when an event is called after a page has unloaded\n\t\t\t\treturn typeof jQuery !== \"undefined\" && (!e || jQuery.event.triggered !== e.type) ?\n\t\t\t\t\tjQuery.event.dispatch.apply( eventHandle.elem, arguments ) :\n\t\t\t\t\tundefined;\n\t\t\t};\n\t\t\t// Add elem as a property of the handle fn to prevent a memory leak with IE non-native events\n\t\t\teventHandle.elem = elem;\n\t\t}\n\n\t\t// Handle multiple events separated by a space\n\t\t// jQuery(...).bind(\"mouseover mouseout\", fn);\n\t\ttypes = jQuery.trim( hoverHack(types) ).split( \" \" );\n\t\tfor ( t = 0; t < types.length; t++ ) {\n\n\t\t\ttns = rtypenamespace.exec( types[t] ) || [];\n\t\t\ttype = tns[1];\n\t\t\tnamespaces = ( tns[2] || \"\" ).split( \".\" ).sort();\n\n\t\t\t// If event changes its type, use the special event handlers for the changed type\n\t\t\tspecial = jQuery.event.special[ type ] || {};\n\n\t\t\t// If selector defined, determine special event api type, otherwise given type\n\t\t\ttype = ( selector ? special.delegateType : special.bindType ) || type;\n\n\t\t\t// Update special based on newly reset type\n\t\t\tspecial = jQuery.event.special[ type ] || {};\n\n\t\t\t// handleObj is passed to all event handlers\n\t\t\thandleObj = jQuery.extend({\n\t\t\t\ttype: type,\n\t\t\t\torigType: tns[1],\n\t\t\t\tdata: data,\n\t\t\t\thandler: handler,\n\t\t\t\tguid: handler.guid,\n\t\t\t\tselector: selector,\n\t\t\t\tneedsContext: selector && jQuery.expr.match.needsContext.test( selector ),\n\t\t\t\tnamespace: namespaces.join(\".\")\n\t\t\t}, handleObjIn );\n\n\t\t\t// Init the event handler queue if we're the first\n\t\t\thandlers = events[ type ];\n\t\t\tif ( !handlers ) {\n\t\t\t\thandlers = events[ type ] = [];\n\t\t\t\thandlers.delegateCount = 0;\n\n\t\t\t\t// Only use addEventListener/attachEvent if the special events handler returns false\n\t\t\t\tif ( !special.setup || special.setup.call( elem, data, namespaces, eventHandle ) === false ) {\n\t\t\t\t\t// Bind the global event handler to the element\n\t\t\t\t\tif ( elem.addEventListener ) {\n\t\t\t\t\t\telem.addEventListener( type, eventHandle, false );\n\n\t\t\t\t\t} else if ( elem.attachEvent ) {\n\t\t\t\t\t\telem.attachEvent( \"on\" + type, eventHandle );\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif ( special.add ) {\n\t\t\t\tspecial.add.call( elem, handleObj );\n\n\t\t\t\tif ( !handleObj.handler.guid ) {\n\t\t\t\t\thandleObj.handler.guid = handler.guid;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Add to the element's handler list, delegates in front\n\t\t\tif ( selector ) {\n\t\t\t\thandlers.splice( handlers.delegateCount++, 0, handleObj );\n\t\t\t} else {\n\t\t\t\thandlers.push( handleObj );\n\t\t\t}\n\n\t\t\t// Keep track of which events have ever been used, for event optimization\n\t\t\tjQuery.event.global[ type ] = true;\n\t\t}\n\n\t\t// Nullify elem to prevent memory leaks in IE\n\t\telem = null;\n\t},\n\n\tglobal: {},\n\n\t// Detach an event or set of events from an element\n\tremove: function( elem, types, handler, selector, mappedTypes ) {\n\n\t\tvar t, tns, type, origType, namespaces, origCount,\n\t\t\tj, events, special, eventType, handleObj,\n\t\t\telemData = jQuery.hasData( elem ) && jQuery._data( elem );\n\n\t\tif ( !elemData || !(events = elemData.events) ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Once for each type.namespace in types; type may be omitted\n\t\ttypes = jQuery.trim( hoverHack( types || \"\" ) ).split(\" \");\n\t\tfor ( t = 0; t < types.length; t++ ) {\n\t\t\ttns = rtypenamespace.exec( types[t] ) || [];\n\t\t\ttype = origType = tns[1];\n\t\t\tnamespaces = tns[2];\n\n\t\t\t// Unbind all events (on this namespace, if provided) for the element\n\t\t\tif ( !type ) {\n\t\t\t\tfor ( type in events ) {\n\t\t\t\t\tjQuery.event.remove( elem, type + types[ t ], handler, selector, true );\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tspecial = jQuery.event.special[ type ] || {};\n\t\t\ttype = ( selector? special.delegateType : special.bindType ) || type;\n\t\t\teventType = events[ type ] || [];\n\t\t\torigCount = eventType.length;\n\t\t\tnamespaces = namespaces ? new RegExp(\"(^|\\\\.)\" + namespaces.split(\".\").sort().join(\"\\\\.(?:.*\\\\.|)\") + \"(\\\\.|$)\") : null;\n\n\t\t\t// Remove matching events\n\t\t\tfor ( j = 0; j < eventType.length; j++ ) {\n\t\t\t\thandleObj = eventType[ j ];\n\n\t\t\t\tif ( ( mappedTypes || origType === handleObj.origType ) &&\n\t\t\t\t\t ( !handler || handler.guid === handleObj.guid ) &&\n\t\t\t\t\t ( !namespaces || namespaces.test( handleObj.namespace ) ) &&\n\t\t\t\t\t ( !selector || selector === handleObj.selector || selector === \"**\" && handleObj.selector ) ) {\n\t\t\t\t\teventType.splice( j--, 1 );\n\n\t\t\t\t\tif ( handleObj.selector ) {\n\t\t\t\t\t\teventType.delegateCount--;\n\t\t\t\t\t}\n\t\t\t\t\tif ( special.remove ) {\n\t\t\t\t\t\tspecial.remove.call( elem, handleObj );\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Remove generic event handler if we removed something and no more handlers exist\n\t\t\t// (avoids potential for endless recursion during removal of special event handlers)\n\t\t\tif ( eventType.length === 0 && origCount !== eventType.length ) {\n\t\t\t\tif ( !special.teardown || special.teardown.call( elem, namespaces, elemData.handle ) === false ) {\n\t\t\t\t\tjQuery.removeEvent( elem, type, elemData.handle );\n\t\t\t\t}\n\n\t\t\t\tdelete events[ type ];\n\t\t\t}\n\t\t}\n\n\t\t// Remove the expando if it's no longer used\n\t\tif ( jQuery.isEmptyObject( events ) ) {\n\t\t\tdelete elemData.handle;\n\n\t\t\t// removeData also checks for emptiness and clears the expando if empty\n\t\t\t// so use it instead of delete\n\t\t\tjQuery.removeData( elem, \"events\", true );\n\t\t}\n\t},\n\n\t// Events that are safe to short-circuit if no handlers are attached.\n\t// Native DOM events should not be added, they may have inline handlers.\n\tcustomEvent: {\n\t\t\"getData\": true,\n\t\t\"setData\": true,\n\t\t\"changeData\": true\n\t},\n\n\ttrigger: function( event, data, elem, onlyHandlers ) {\n\t\t// Don't do events on text and comment nodes\n\t\tif ( elem && (elem.nodeType === 3 || elem.nodeType === 8) ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Event object or event type\n\t\tvar cache, exclusive, i, cur, old, ontype, special, handle, eventPath, bubbleType,\n\t\t\ttype = event.type || event,\n\t\t\tnamespaces = [];\n\n\t\t// focus/blur morphs to focusin/out; ensure we're not firing them right now\n\t\tif ( rfocusMorph.test( type + jQuery.event.triggered ) ) {\n\t\t\treturn;\n\t\t}\n\n\t\tif ( type.indexOf( \"!\" ) >= 0 ) {\n\t\t\t// Exclusive events trigger only for the exact event (no namespaces)\n\t\t\ttype = type.slice(0, -1);\n\t\t\texclusive = true;\n\t\t}\n\n\t\tif ( type.indexOf( \".\" ) >= 0 ) {\n\t\t\t// Namespaced trigger; create a regexp to match event type in handle()\n\t\t\tnamespaces = type.split(\".\");\n\t\t\ttype = namespaces.shift();\n\t\t\tnamespaces.sort();\n\t\t}\n\n\t\tif ( (!elem || jQuery.event.customEvent[ type ]) && !jQuery.event.global[ type ] ) {\n\t\t\t// No jQuery handlers for this event type, and it can't have inline handlers\n\t\t\treturn;\n\t\t}\n\n\t\t// Caller can pass in an Event, Object, or just an event type string\n\t\tevent = typeof event === \"object\" ?\n\t\t\t// jQuery.Event object\n\t\t\tevent[ jQuery.expando ] ? event :\n\t\t\t// Object literal\n\t\t\tnew jQuery.Event( type, event ) :\n\t\t\t// Just the event type (string)\n\t\t\tnew jQuery.Event( type );\n\n\t\tevent.type = type;\n\t\tevent.isTrigger = true;\n\t\tevent.exclusive = exclusive;\n\t\tevent.namespace = namespaces.join( \".\" );\n\t\tevent.namespace_re = event.namespace? new RegExp(\"(^|\\\\.)\" + namespaces.join(\"\\\\.(?:.*\\\\.|)\") + \"(\\\\.|$)\") : null;\n\t\tontype = type.indexOf( \":\" ) < 0 ? \"on\" + type : \"\";\n\n\t\t// Handle a global trigger\n\t\tif ( !elem ) {\n\n\t\t\t// TODO: Stop taunting the data cache; remove global events and always attach to document\n\t\t\tcache = jQuery.cache;\n\t\t\tfor ( i in cache ) {\n\t\t\t\tif ( cache[ i ].events && cache[ i ].events[ type ] ) {\n\t\t\t\t\tjQuery.event.trigger( event, data, cache[ i ].handle.elem, true );\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\t// Clean up the event in case it is being reused\n\t\tevent.result = undefined;\n\t\tif ( !event.target ) {\n\t\t\tevent.target = elem;\n\t\t}\n\n\t\t// Clone any incoming data and prepend the event, creating the handler arg list\n\t\tdata = data != null ? jQuery.makeArray( data ) : [];\n\t\tdata.unshift( event );\n\n\t\t// Allow special events to draw outside the lines\n\t\tspecial = jQuery.event.special[ type ] || {};\n\t\tif ( special.trigger && special.trigger.apply( elem, data ) === false ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Determine event propagation path in advance, per W3C events spec (#9951)\n\t\t// Bubble up to document, then to window; watch for a global ownerDocument var (#9724)\n\t\teventPath = [[ elem, special.bindType || type ]];\n\t\tif ( !onlyHandlers && !special.noBubble && !jQuery.isWindow( elem ) ) {\n\n\t\t\tbubbleType = special.delegateType || type;\n\t\t\tcur = rfocusMorph.test( bubbleType + type ) ? elem : elem.parentNode;\n\t\t\tfor ( old = elem; cur; cur = cur.parentNode ) {\n\t\t\t\teventPath.push([ cur, bubbleType ]);\n\t\t\t\told = cur;\n\t\t\t}\n\n\t\t\t// Only add window if we got to document (e.g., not plain obj or detached DOM)\n\t\t\tif ( old === (elem.ownerDocument || document) ) {\n\t\t\t\teventPath.push([ old.defaultView || old.parentWindow || window, bubbleType ]);\n\t\t\t}\n\t\t}\n\n\t\t// Fire handlers on the event path\n\t\tfor ( i = 0; i < eventPath.length && !event.isPropagationStopped(); i++ ) {\n\n\t\t\tcur = eventPath[i][0];\n\t\t\tevent.type = eventPath[i][1];\n\n\t\t\thandle = ( jQuery._data( cur, \"events\" ) || {} )[ event.type ] && jQuery._data( cur, \"handle\" );\n\t\t\tif ( handle ) {\n\t\t\t\thandle.apply( cur, data );\n\t\t\t}\n\t\t\t// Note that this is a bare JS function and not a jQuery handler\n\t\t\thandle = ontype && cur[ ontype ];\n\t\t\tif ( handle && jQuery.acceptData( cur ) && handle.apply && handle.apply( cur, data ) === false ) {\n\t\t\t\tevent.preventDefault();\n\t\t\t}\n\t\t}\n\t\tevent.type = type;\n\n\t\t// If nobody prevented the default action, do it now\n\t\tif ( !onlyHandlers && !event.isDefaultPrevented() ) {\n\n\t\t\tif ( (!special._default || special._default.apply( elem.ownerDocument, data ) === false) &&\n\t\t\t\t!(type === \"click\" && jQuery.nodeName( elem, \"a\" )) && jQuery.acceptData( elem ) ) {\n\n\t\t\t\t// Call a native DOM method on the target with the same name name as the event.\n\t\t\t\t// Can't use an .isFunction() check here because IE6/7 fails that test.\n\t\t\t\t// Don't do default actions on window, that's where global variables be (#6170)\n\t\t\t\t// IE<9 dies on focus/blur to hidden element (#1486)\n\t\t\t\tif ( ontype && elem[ type ] && ((type !== \"focus\" && type !== \"blur\") || event.target.offsetWidth !== 0) && !jQuery.isWindow( elem ) ) {\n\n\t\t\t\t\t// Don't re-trigger an onFOO event when we call its FOO() method\n\t\t\t\t\told = elem[ ontype ];\n\n\t\t\t\t\tif ( old ) {\n\t\t\t\t\t\telem[ ontype ] = null;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Prevent re-triggering of the same event, since we already bubbled it above\n\t\t\t\t\tjQuery.event.triggered = type;\n\t\t\t\t\telem[ type ]();\n\t\t\t\t\tjQuery.event.triggered = undefined;\n\n\t\t\t\t\tif ( old ) {\n\t\t\t\t\t\telem[ ontype ] = old;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn event.result;\n\t},\n\n\tdispatch: function( event ) {\n\n\t\t// Make a writable jQuery.Event from the native event object\n\t\tevent = jQuery.event.fix( event || window.event );\n\n\t\tvar i, j, cur, ret, selMatch, matched, matches, handleObj, sel, related,\n\t\t\thandlers = ( (jQuery._data( this, \"events\" ) || {} )[ event.type ] || []),\n\t\t\tdelegateCount = handlers.delegateCount,\n\t\t\targs = core_slice.call( arguments ),\n\t\t\trun_all = !event.exclusive && !event.namespace,\n\t\t\tspecial = jQuery.event.special[ event.type ] || {},\n\t\t\thandlerQueue = [];\n\n\t\t// Use the fix-ed jQuery.Event rather than the (read-only) native event\n\t\targs[0] = event;\n\t\tevent.delegateTarget = this;\n\n\t\t// Call the preDispatch hook for the mapped type, and let it bail if desired\n\t\tif ( special.preDispatch && special.preDispatch.call( this, event ) === false ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Determine handlers that should run if there are delegated events\n\t\t// Avoid non-left-click bubbling in Firefox (#3861)\n\t\tif ( delegateCount && !(event.button && event.type === \"click\") ) {\n\n\t\t\tfor ( cur = event.target; cur != this; cur = cur.parentNode || this ) {\n\n\t\t\t\t// Don't process clicks (ONLY) on disabled elements (#6911, #8165, #11382, #11764)\n\t\t\t\tif ( cur.disabled !== true || event.type !== \"click\" ) {\n\t\t\t\t\tselMatch = {};\n\t\t\t\t\tmatches = [];\n\t\t\t\t\tfor ( i = 0; i < delegateCount; i++ ) {\n\t\t\t\t\t\thandleObj = handlers[ i ];\n\t\t\t\t\t\tsel = handleObj.selector;\n\n\t\t\t\t\t\tif ( selMatch[ sel ] === undefined ) {\n\t\t\t\t\t\t\tselMatch[ sel ] = handleObj.needsContext ?\n\t\t\t\t\t\t\t\tjQuery( sel, this ).index( cur ) >= 0 :\n\t\t\t\t\t\t\t\tjQuery.find( sel, this, null, [ cur ] ).length;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif ( selMatch[ sel ] ) {\n\t\t\t\t\t\t\tmatches.push( handleObj );\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tif ( matches.length ) {\n\t\t\t\t\t\thandlerQueue.push({ elem: cur, matches: matches });\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Add the remaining (directly-bound) handlers\n\t\tif ( handlers.length > delegateCount ) {\n\t\t\thandlerQueue.push({ elem: this, matches: handlers.slice( delegateCount ) });\n\t\t}\n\n\t\t// Run delegates first; they may want to stop propagation beneath us\n\t\tfor ( i = 0; i < handlerQueue.length && !event.isPropagationStopped(); i++ ) {\n\t\t\tmatched = handlerQueue[ i ];\n\t\t\tevent.currentTarget = matched.elem;\n\n\t\t\tfor ( j = 0; j < matched.matches.length && !event.isImmediatePropagationStopped(); j++ ) {\n\t\t\t\thandleObj = matched.matches[ j ];\n\n\t\t\t\t// Triggered event must either 1) be non-exclusive and have no namespace, or\n\t\t\t\t// 2) have namespace(s) a subset or equal to those in the bound event (both can have no namespace).\n\t\t\t\tif ( run_all || (!event.namespace && !handleObj.namespace) || event.namespace_re && event.namespace_re.test( handleObj.namespace ) ) {\n\n\t\t\t\t\tevent.data = handleObj.data;\n\t\t\t\t\tevent.handleObj = handleObj;\n\n\t\t\t\t\tret = ( (jQuery.event.special[ handleObj.origType ] || {}).handle || handleObj.handler )\n\t\t\t\t\t\t\t.apply( matched.elem, args );\n\n\t\t\t\t\tif ( ret !== undefined ) {\n\t\t\t\t\t\tevent.result = ret;\n\t\t\t\t\t\tif ( ret === false ) {\n\t\t\t\t\t\t\tevent.preventDefault();\n\t\t\t\t\t\t\tevent.stopPropagation();\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Call the postDispatch hook for the mapped type\n\t\tif ( special.postDispatch ) {\n\t\t\tspecial.postDispatch.call( this, event );\n\t\t}\n\n\t\treturn event.result;\n\t},\n\n\t// Includes some event props shared by KeyEvent and MouseEvent\n\t// *** attrChange attrName relatedNode srcElement are not normalized, non-W3C, deprecated, will be removed in 1.8 ***\n\tprops: \"attrChange attrName relatedNode srcElement altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which\".split(\" \"),\n\n\tfixHooks: {},\n\n\tkeyHooks: {\n\t\tprops: \"char charCode key keyCode\".split(\" \"),\n\t\tfilter: function( event, original ) {\n\n\t\t\t// Add which for key events\n\t\t\tif ( event.which == null ) {\n\t\t\t\tevent.which = original.charCode != null ? original.charCode : original.keyCode;\n\t\t\t}\n\n\t\t\treturn event;\n\t\t}\n\t},\n\n\tmouseHooks: {\n\t\tprops: \"button buttons clientX clientY fromElement offsetX offsetY pageX pageY screenX screenY toElement\".split(\" \"),\n\t\tfilter: function( event, original ) {\n\t\t\tvar eventDoc, doc, body,\n\t\t\t\tbutton = original.button,\n\t\t\t\tfromElement = original.fromElement;\n\n\t\t\t// Calculate pageX/Y if missing and clientX/Y available\n\t\t\tif ( event.pageX == null && original.clientX != null ) {\n\t\t\t\teventDoc = event.target.ownerDocument || document;\n\t\t\t\tdoc = eventDoc.documentElement;\n\t\t\t\tbody = eventDoc.body;\n\n\t\t\t\tevent.pageX = original.clientX + ( doc && doc.scrollLeft || body && body.scrollLeft || 0 ) - ( doc && doc.clientLeft || body && body.clientLeft || 0 );\n\t\t\t\tevent.pageY = original.clientY + ( doc && doc.scrollTop || body && body.scrollTop || 0 ) - ( doc && doc.clientTop || body && body.clientTop || 0 );\n\t\t\t}\n\n\t\t\t// Add relatedTarget, if necessary\n\t\t\tif ( !event.relatedTarget && fromElement ) {\n\t\t\t\tevent.relatedTarget = fromElement === event.target ? original.toElement : fromElement;\n\t\t\t}\n\n\t\t\t// Add which for click: 1 === left; 2 === middle; 3 === right\n\t\t\t// Note: button is not normalized, so don't use it\n\t\t\tif ( !event.which && button !== undefined ) {\n\t\t\t\tevent.which = ( button & 1 ? 1 : ( button & 2 ? 3 : ( button & 4 ? 2 : 0 ) ) );\n\t\t\t}\n\n\t\t\treturn event;\n\t\t}\n\t},\n\n\tfix: function( event ) {\n\t\tif ( event[ jQuery.expando ] ) {\n\t\t\treturn event;\n\t\t}\n\n\t\t// Create a writable copy of the event object and normalize some properties\n\t\tvar i, prop,\n\t\t\toriginalEvent = event,\n\t\t\tfixHook = jQuery.event.fixHooks[ event.type ] || {},\n\t\t\tcopy = fixHook.props ? this.props.concat( fixHook.props ) : this.props;\n\n\t\tevent = jQuery.Event( originalEvent );\n\n\t\tfor ( i = copy.length; i; ) {\n\t\t\tprop = copy[ --i ];\n\t\t\tevent[ prop ] = originalEvent[ prop ];\n\t\t}\n\n\t\t// Fix target property, if necessary (#1925, IE 6/7/8 & Safari2)\n\t\tif ( !event.target ) {\n\t\t\tevent.target = originalEvent.srcElement || document;\n\t\t}\n\n\t\t// Target should not be a text node (#504, Safari)\n\t\tif ( event.target.nodeType === 3 ) {\n\t\t\tevent.target = event.target.parentNode;\n\t\t}\n\n\t\t// For mouse/key events, metaKey==false if it's undefined (#3368, #11328; IE6/7/8)\n\t\tevent.metaKey = !!event.metaKey;\n\n\t\treturn fixHook.filter? fixHook.filter( event, originalEvent ) : event;\n\t},\n\n\tspecial: {\n\t\tload: {\n\t\t\t// Prevent triggered image.load events from bubbling to window.load\n\t\t\tnoBubble: true\n\t\t},\n\n\t\tfocus: {\n\t\t\tdelegateType: \"focusin\"\n\t\t},\n\t\tblur: {\n\t\t\tdelegateType: \"focusout\"\n\t\t},\n\n\t\tbeforeunload: {\n\t\t\tsetup: function( data, namespaces, eventHandle ) {\n\t\t\t\t// We only want to do this special case on windows\n\t\t\t\tif ( jQuery.isWindow( this ) ) {\n\t\t\t\t\tthis.onbeforeunload = eventHandle;\n\t\t\t\t}\n\t\t\t},\n\n\t\t\tteardown: function( namespaces, eventHandle ) {\n\t\t\t\tif ( this.onbeforeunload === eventHandle ) {\n\t\t\t\t\tthis.onbeforeunload = null;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t},\n\n\tsimulate: function( type, elem, event, bubble ) {\n\t\t// Piggyback on a donor event to simulate a different one.\n\t\t// Fake originalEvent to avoid donor's stopPropagation, but if the\n\t\t// simulated event prevents default then we do the same on the donor.\n\t\tvar e = jQuery.extend(\n\t\t\tnew jQuery.Event(),\n\t\t\tevent,\n\t\t\t{ type: type,\n\t\t\t\tisSimulated: true,\n\t\t\t\toriginalEvent: {}\n\t\t\t}\n\t\t);\n\t\tif ( bubble ) {\n\t\t\tjQuery.event.trigger( e, null, elem );\n\t\t} else {\n\t\t\tjQuery.event.dispatch.call( elem, e );\n\t\t}\n\t\tif ( e.isDefaultPrevented() ) {\n\t\t\tevent.preventDefault();\n\t\t}\n\t}\n};\n\n// Some plugins are using, but it's undocumented/deprecated and will be removed.\n// The 1.7 special event interface should provide all the hooks needed now.\njQuery.event.handle = jQuery.event.dispatch;\n\njQuery.removeEvent = document.removeEventListener ?\n\tfunction( elem, type, handle ) {\n\t\tif ( elem.removeEventListener ) {\n\t\t\telem.removeEventListener( type, handle, false );\n\t\t}\n\t} :\n\tfunction( elem, type, handle ) {\n\t\tvar name = \"on\" + type;\n\n\t\tif ( elem.detachEvent ) {\n\n\t\t\t// #8545, #7054, preventing memory leaks for custom events in IE6-8\n\t\t\t// detachEvent needed property on element, by name of that event, to properly expose it to GC\n\t\t\tif ( typeof elem[ name ] === \"undefined\" ) {\n\t\t\t\telem[ name ] = null;\n\t\t\t}\n\n\t\t\telem.detachEvent( name, handle );\n\t\t}\n\t};\n\njQuery.Event = function( src, props ) {\n\t// Allow instantiation without the 'new' keyword\n\tif ( !(this instanceof jQuery.Event) ) {\n\t\treturn new jQuery.Event( src, props );\n\t}\n\n\t// Event object\n\tif ( src && src.type ) {\n\t\tthis.originalEvent = src;\n\t\tthis.type = src.type;\n\n\t\t// Events bubbling up the document may have been marked as prevented\n\t\t// by a handler lower down the tree; reflect the correct value.\n\t\tthis.isDefaultPrevented = ( src.defaultPrevented || src.returnValue === false ||\n\t\t\tsrc.getPreventDefault && src.getPreventDefault() ) ? returnTrue : returnFalse;\n\n\t// Event type\n\t} else {\n\t\tthis.type = src;\n\t}\n\n\t// Put explicitly provided properties onto the event object\n\tif ( props ) {\n\t\tjQuery.extend( this, props );\n\t}\n\n\t// Create a timestamp if incoming event doesn't have one\n\tthis.timeStamp = src && src.timeStamp || jQuery.now();\n\n\t// Mark it as fixed\n\tthis[ jQuery.expando ] = true;\n};\n\nfunction returnFalse() {\n\treturn false;\n}\nfunction returnTrue() {\n\treturn true;\n}\n\n// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding\n// http://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html\njQuery.Event.prototype = {\n\tpreventDefault: function() {\n\t\tthis.isDefaultPrevented = returnTrue;\n\n\t\tvar e = this.originalEvent;\n\t\tif ( !e ) {\n\t\t\treturn;\n\t\t}\n\n\t\t// if preventDefault exists run it on the original event\n\t\tif ( e.preventDefault ) {\n\t\t\te.preventDefault();\n\n\t\t// otherwise set the returnValue property of the original event to false (IE)\n\t\t} else {\n\t\t\te.returnValue = false;\n\t\t}\n\t},\n\tstopPropagation: function() {\n\t\tthis.isPropagationStopped = returnTrue;\n\n\t\tvar e = this.originalEvent;\n\t\tif ( !e ) {\n\t\t\treturn;\n\t\t}\n\t\t// if stopPropagation exists run it on the original event\n\t\tif ( e.stopPropagation ) {\n\t\t\te.stopPropagation();\n\t\t}\n\t\t// otherwise set the cancelBubble property of the original event to true (IE)\n\t\te.cancelBubble = true;\n\t},\n\tstopImmediatePropagation: function() {\n\t\tthis.isImmediatePropagationStopped = returnTrue;\n\t\tthis.stopPropagation();\n\t},\n\tisDefaultPrevented: returnFalse,\n\tisPropagationStopped: returnFalse,\n\tisImmediatePropagationStopped: returnFalse\n};\n\n// Create mouseenter/leave events using mouseover/out and event-time checks\njQuery.each({\n\tmouseenter: \"mouseover\",\n\tmouseleave: \"mouseout\"\n}, function( orig, fix ) {\n\tjQuery.event.special[ orig ] = {\n\t\tdelegateType: fix,\n\t\tbindType: fix,\n\n\t\thandle: function( event ) {\n\t\t\tvar ret,\n\t\t\t\ttarget = this,\n\t\t\t\trelated = event.relatedTarget,\n\t\t\t\thandleObj = event.handleObj,\n\t\t\t\tselector = handleObj.selector;\n\n\t\t\t// For mousenter/leave call the handler if related is outside the target.\n\t\t\t// NB: No relatedTarget if the mouse left/entered the browser window\n\t\t\tif ( !related || (related !== target && !jQuery.contains( target, related )) ) {\n\t\t\t\tevent.type = handleObj.origType;\n\t\t\t\tret = handleObj.handler.apply( this, arguments );\n\t\t\t\tevent.type = fix;\n\t\t\t}\n\t\t\treturn ret;\n\t\t}\n\t};\n});\n\n// IE submit delegation\nif ( !jQuery.support.submitBubbles ) {\n\n\tjQuery.event.special.submit = {\n\t\tsetup: function() {\n\t\t\t// Only need this for delegated form submit events\n\t\t\tif ( jQuery.nodeName( this, \"form\" ) ) {\n\t\t\t\treturn false;\n\t\t\t}\n\n\t\t\t// Lazy-add a submit handler when a descendant form may potentially be submitted\n\t\t\tjQuery.event.add( this, \"click._submit keypress._submit\", function( e ) {\n\t\t\t\t// Node name check avoids a VML-related crash in IE (#9807)\n\t\t\t\tvar elem = e.target,\n\t\t\t\t\tform = jQuery.nodeName( elem, \"input\" ) || jQuery.nodeName( elem, \"button\" ) ? elem.form : undefined;\n\t\t\t\tif ( form && !jQuery._data( form, \"_submit_attached\" ) ) {\n\t\t\t\t\tjQuery.event.add( form, \"submit._submit\", function( event ) {\n\t\t\t\t\t\tevent._submit_bubble = true;\n\t\t\t\t\t});\n\t\t\t\t\tjQuery._data( form, \"_submit_attached\", true );\n\t\t\t\t}\n\t\t\t});\n\t\t\t// return undefined since we don't need an event listener\n\t\t},\n\n\t\tpostDispatch: function( event ) {\n\t\t\t// If form was submitted by the user, bubble the event up the tree\n\t\t\tif ( event._submit_bubble ) {\n\t\t\t\tdelete event._submit_bubble;\n\t\t\t\tif ( this.parentNode && !event.isTrigger ) {\n\t\t\t\t\tjQuery.event.simulate( \"submit\", this.parentNode, event, true );\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\n\t\tteardown: function() {\n\t\t\t// Only need this for delegated form submit events\n\t\t\tif ( jQuery.nodeName( this, \"form\" ) ) {\n\t\t\t\treturn false;\n\t\t\t}\n\n\t\t\t// Remove delegated handlers; cleanData eventually reaps submit handlers attached above\n\t\t\tjQuery.event.remove( this, \"._submit\" );\n\t\t}\n\t};\n}\n\n// IE change delegation and checkbox/radio fix\nif ( !jQuery.support.changeBubbles ) {\n\n\tjQuery.event.special.change = {\n\n\t\tsetup: function() {\n\n\t\t\tif ( rformElems.test( this.nodeName ) ) {\n\t\t\t\t// IE doesn't fire change on a check/radio until blur; trigger it on click\n\t\t\t\t// after a propertychange. Eat the blur-change in special.change.handle.\n\t\t\t\t// This still fires onchange a second time for check/radio after blur.\n\t\t\t\tif ( this.type === \"checkbox\" || this.type === \"radio\" ) {\n\t\t\t\t\tjQuery.event.add( this, \"propertychange._change\", function( event ) {\n\t\t\t\t\t\tif ( event.originalEvent.propertyName === \"checked\" ) {\n\t\t\t\t\t\t\tthis._just_changed = true;\n\t\t\t\t\t\t}\n\t\t\t\t\t});\n\t\t\t\t\tjQuery.event.add( this, \"click._change\", function( event ) {\n\t\t\t\t\t\tif ( this._just_changed && !event.isTrigger ) {\n\t\t\t\t\t\t\tthis._just_changed = false;\n\t\t\t\t\t\t}\n\t\t\t\t\t\t// Allow triggered, simulated change events (#11500)\n\t\t\t\t\t\tjQuery.event.simulate( \"change\", this, event, true );\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\t// Delegated event; lazy-add a change handler on descendant inputs\n\t\t\tjQuery.event.add( this, \"beforeactivate._change\", function( e ) {\n\t\t\t\tvar elem = e.target;\n\n\t\t\t\tif ( rformElems.test( elem.nodeName ) && !jQuery._data( elem, \"_change_attached\" ) ) {\n\t\t\t\t\tjQuery.event.add( elem, \"change._change\", function( event ) {\n\t\t\t\t\t\tif ( this.parentNode && !event.isSimulated && !event.isTrigger ) {\n\t\t\t\t\t\t\tjQuery.event.simulate( \"change\", this.parentNode, event, true );\n\t\t\t\t\t\t}\n\t\t\t\t\t});\n\t\t\t\t\tjQuery._data( elem, \"_change_attached\", true );\n\t\t\t\t}\n\t\t\t});\n\t\t},\n\n\t\thandle: function( event ) {\n\t\t\tvar elem = event.target;\n\n\t\t\t// Swallow native change events from checkbox/radio, we already triggered them above\n\t\t\tif ( this !== elem || event.isSimulated || event.isTrigger || (elem.type !== \"radio\" && elem.type !== \"checkbox\") ) {\n\t\t\t\treturn event.handleObj.handler.apply( this, arguments );\n\t\t\t}\n\t\t},\n\n\t\tteardown: function() {\n\t\t\tjQuery.event.remove( this, \"._change\" );\n\n\t\t\treturn !rformElems.test( this.nodeName );\n\t\t}\n\t};\n}\n\n// Create \"bubbling\" focus and blur events\nif ( !jQuery.support.focusinBubbles ) {\n\tjQuery.each({ focus: \"focusin\", blur: \"focusout\" }, function( orig, fix ) {\n\n\t\t// Attach a single capturing handler while someone wants focusin/focusout\n\t\tvar attaches = 0,\n\t\t\thandler = function( event ) {\n\t\t\t\tjQuery.event.simulate( fix, event.target, jQuery.event.fix( event ), true );\n\t\t\t};\n\n\t\tjQuery.event.special[ fix ] = {\n\t\t\tsetup: function() {\n\t\t\t\tif ( attaches++ === 0 ) {\n\t\t\t\t\tdocument.addEventListener( orig, handler, true );\n\t\t\t\t}\n\t\t\t},\n\t\t\tteardown: function() {\n\t\t\t\tif ( --attaches === 0 ) {\n\t\t\t\t\tdocument.removeEventListener( orig, handler, true );\n\t\t\t\t}\n\t\t\t}\n\t\t};\n\t});\n}\n\njQuery.fn.extend({\n\n\ton: function( types, selector, data, fn, /*INTERNAL*/ one ) {\n\t\tvar origFn, type;\n\n\t\t// Types can be a map of types/handlers\n\t\tif ( typeof types === \"object\" ) {\n\t\t\t// ( types-Object, selector, data )\n\t\t\tif ( typeof selector !== \"string\" ) { // && selector != null\n\t\t\t\t// ( types-Object, data )\n\t\t\t\tdata = data || selector;\n\t\t\t\tselector = undefined;\n\t\t\t}\n\t\t\tfor ( type in types ) {\n\t\t\t\tthis.on( type, selector, data, types[ type ], one );\n\t\t\t}\n\t\t\treturn this;\n\t\t}\n\n\t\tif ( data == null && fn == null ) {\n\t\t\t// ( types, fn )\n\t\t\tfn = selector;\n\t\t\tdata = selector = undefined;\n\t\t} else if ( fn == null ) {\n\t\t\tif ( typeof selector === \"string\" ) {\n\t\t\t\t// ( types, selector, fn )\n\t\t\t\tfn = data;\n\t\t\t\tdata = undefined;\n\t\t\t} else {\n\t\t\t\t// ( types, data, fn )\n\t\t\t\tfn = data;\n\t\t\t\tdata = selector;\n\t\t\t\tselector = undefined;\n\t\t\t}\n\t\t}\n\t\tif ( fn === false ) {\n\t\t\tfn = returnFalse;\n\t\t} else if ( !fn ) {\n\t\t\treturn this;\n\t\t}\n\n\t\tif ( one === 1 ) {\n\t\t\torigFn = fn;\n\t\t\tfn = function( event ) {\n\t\t\t\t// Can use an empty set, since event contains the info\n\t\t\t\tjQuery().off( event );\n\t\t\t\treturn origFn.apply( this, arguments );\n\t\t\t};\n\t\t\t// Use same guid so caller can remove using origFn\n\t\t\tfn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ );\n\t\t}\n\t\treturn this.each( function() {\n\t\t\tjQuery.event.add( this, types, fn, data, selector );\n\t\t});\n\t},\n\tone: function( types, selector, data, fn ) {\n\t\treturn this.on( types, selector, data, fn, 1 );\n\t},\n\toff: function( types, selector, fn ) {\n\t\tvar handleObj, type;\n\t\tif ( types && types.preventDefault && types.handleObj ) {\n\t\t\t// ( event ) dispatched jQuery.Event\n\t\t\thandleObj = types.handleObj;\n\t\t\tjQuery( types.delegateTarget ).off(\n\t\t\t\thandleObj.namespace ? handleObj.origType + \".\" + handleObj.namespace : handleObj.origType,\n\t\t\t\thandleObj.selector,\n\t\t\t\thandleObj.handler\n\t\t\t);\n\t\t\treturn this;\n\t\t}\n\t\tif ( typeof types === \"object\" ) {\n\t\t\t// ( types-object [, selector] )\n\t\t\tfor ( type in types ) {\n\t\t\t\tthis.off( type, selector, types[ type ] );\n\t\t\t}\n\t\t\treturn this;\n\t\t}\n\t\tif ( selector === false || typeof selector === \"function\" ) {\n\t\t\t// ( types [, fn] )\n\t\t\tfn = selector;\n\t\t\tselector = undefined;\n\t\t}\n\t\tif ( fn === false ) {\n\t\t\tfn = returnFalse;\n\t\t}\n\t\treturn this.each(function() {\n\t\t\tjQuery.event.remove( this, types, fn, selector );\n\t\t});\n\t},\n\n\tbind: function( types, data, fn ) {\n\t\treturn this.on( types, null, data, fn );\n\t},\n\tunbind: function( types, fn ) {\n\t\treturn this.off( types, null, fn );\n\t},\n\n\tlive: function( types, data, fn ) {\n\t\tjQuery( this.context ).on( types, this.selector, data, fn );\n\t\treturn this;\n\t},\n\tdie: function( types, fn ) {\n\t\tjQuery( this.context ).off( types, this.selector || \"**\", fn );\n\t\treturn this;\n\t},\n\n\tdelegate: function( selector, types, data, fn ) {\n\t\treturn this.on( types, selector, data, fn );\n\t},\n\tundelegate: function( selector, types, fn ) {\n\t\t// ( namespace ) or ( selector, types [, fn] )\n\t\treturn arguments.length === 1 ? this.off( selector, \"**\" ) : this.off( types, selector || \"**\", fn );\n\t},\n\n\ttrigger: function( type, data ) {\n\t\treturn this.each(function() {\n\t\t\tjQuery.event.trigger( type, data, this );\n\t\t});\n\t},\n\ttriggerHandler: function( type, data ) {\n\t\tif ( this[0] ) {\n\t\t\treturn jQuery.event.trigger( type, data, this[0], true );\n\t\t}\n\t},\n\n\ttoggle: function( fn ) {\n\t\t// Save reference to arguments for access in closure\n\t\tvar args = arguments,\n\t\t\tguid = fn.guid || jQuery.guid++,\n\t\t\ti = 0,\n\t\t\ttoggler = function( event ) {\n\t\t\t\t// Figure out which function to execute\n\t\t\t\tvar lastToggle = ( jQuery._data( this, \"lastToggle\" + fn.guid ) || 0 ) % i;\n\t\t\t\tjQuery._data( this, \"lastToggle\" + fn.guid, lastToggle + 1 );\n\n\t\t\t\t// Make sure that clicks stop\n\t\t\t\tevent.preventDefault();\n\n\t\t\t\t// and execute the function\n\t\t\t\treturn args[ lastToggle ].apply( this, arguments ) || false;\n\t\t\t};\n\n\t\t// link all the functions, so any of them can unbind this click handler\n\t\ttoggler.guid = guid;\n\t\twhile ( i < args.length ) {\n\t\t\targs[ i++ ].guid = guid;\n\t\t}\n\n\t\treturn this.click( toggler );\n\t},\n\n\thover: function( fnOver, fnOut ) {\n\t\treturn this.mouseenter( fnOver ).mouseleave( fnOut || fnOver );\n\t}\n});\n\njQuery.each( (\"blur focus focusin focusout load resize scroll unload click dblclick \" +\n\t\"mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave \" +\n\t\"change select submit keydown keypress keyup error contextmenu\").split(\" \"), function( i, name ) {\n\n\t// Handle event binding\n\tjQuery.fn[ name ] = function( data, fn ) {\n\t\tif ( fn == null ) {\n\t\t\tfn = data;\n\t\t\tdata = null;\n\t\t}\n\n\t\treturn arguments.length > 0 ?\n\t\t\tthis.on( name, null, data, fn ) :\n\t\t\tthis.trigger( name );\n\t};\n\n\tif ( rkeyEvent.test( name ) ) {\n\t\tjQuery.event.fixHooks[ name ] = jQuery.event.keyHooks;\n\t}\n\n\tif ( rmouseEvent.test( name ) ) {\n\t\tjQuery.event.fixHooks[ name ] = jQuery.event.mouseHooks;\n\t}\n});\n/*!\n * Sizzle CSS Selector Engine\n * Copyright 2012 jQuery Foundation and other contributors\n * Released under the MIT license\n * http://sizzlejs.com/\n */\n(function( window, undefined ) {\n\nvar cachedruns,\n\tassertGetIdNotName,\n\tExpr,\n\tgetText,\n\tisXML,\n\tcontains,\n\tcompile,\n\tsortOrder,\n\thasDuplicate,\n\toutermostContext,\n\n\tbaseHasDuplicate = true,\n\tstrundefined = \"undefined\",\n\n\texpando = ( \"sizcache\" + Math.random() ).replace( \".\", \"\" ),\n\n\tToken = String,\n\tdocument = window.document,\n\tdocElem = document.documentElement,\n\tdirruns = 0,\n\tdone = 0,\n\tpop = [].pop,\n\tpush = [].push,\n\tslice = [].slice,\n\t// Use a stripped-down indexOf if a native one is unavailable\n\tindexOf = [].indexOf || function( elem ) {\n\t\tvar i = 0,\n\t\t\tlen = this.length;\n\t\tfor ( ; i < len; i++ ) {\n\t\t\tif ( this[i] === elem ) {\n\t\t\t\treturn i;\n\t\t\t}\n\t\t}\n\t\treturn -1;\n\t},\n\n\t// Augment a function for special use by Sizzle\n\tmarkFunction = function( fn, value ) {\n\t\tfn[ expando ] = value == null || value;\n\t\treturn fn;\n\t},\n\n\tcreateCache = function() {\n\t\tvar cache = {},\n\t\t\tkeys = [];\n\n\t\treturn markFunction(function( key, value ) {\n\t\t\t// Only keep the most recent entries\n\t\t\tif ( keys.push( key ) > Expr.cacheLength ) {\n\t\t\t\tdelete cache[ keys.shift() ];\n\t\t\t}\n\n\t\t\t// Retrieve with (key + \" \") to avoid collision with native Object.prototype properties (see Issue #157)\n\t\t\treturn (cache[ key + \" \" ] = value);\n\t\t}, cache );\n\t},\n\n\tclassCache = createCache(),\n\ttokenCache = createCache(),\n\tcompilerCache = createCache(),\n\n\t// Regex\n\n\t// Whitespace characters http://www.w3.org/TR/css3-selectors/#whitespace\n\twhitespace = \"[\\\\x20\\\\t\\\\r\\\\n\\\\f]\",\n\t// http://www.w3.org/TR/css3-syntax/#characters\n\tcharacterEncoding = \"(?:\\\\\\\\.|[-\\\\w]|[^\\\\x00-\\\\xa0])+\",\n\n\t// Loosely modeled on CSS identifier characters\n\t// An unquoted value should be a CSS identifier (http://www.w3.org/TR/css3-selectors/#attribute-selectors)\n\t// Proper syntax: http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier\n\tidentifier = characterEncoding.replace( \"w\", \"w#\" ),\n\n\t// Acceptable operators http://www.w3.org/TR/selectors/#attribute-selectors\n\toperators = \"([*^$|!~]?=)\",\n\tattributes = \"\\\\[\" + whitespace + \"*(\" + characterEncoding + \")\" + whitespace +\n\t\t\"*(?:\" + operators + whitespace + \"*(?:(['\\\"])((?:\\\\\\\\.|[^\\\\\\\\])*?)\\\\3|(\" + identifier + \")|)|)\" + whitespace + \"*\\\\]\",\n\n\t// Prefer arguments not in parens/brackets,\n\t// then attribute selectors and non-pseudos (denoted by :),\n\t// then anything else\n\t// These preferences are here to reduce the number of selectors\n\t// needing tokenize in the PSEUDO preFilter\n\tpseudos = \":(\" + characterEncoding + \")(?:\\\\((?:(['\\\"])((?:\\\\\\\\.|[^\\\\\\\\])*?)\\\\2|([^()[\\\\]]*|(?:(?:\" + attributes + \")|[^:]|\\\\\\\\.)*|.*))\\\\)|)\",\n\n\t// For matchExpr.POS and matchExpr.needsContext\n\tpos = \":(even|odd|eq|gt|lt|nth|first|last)(?:\\\\(\" + whitespace +\n\t\t\"*((?:-\\\\d)?\\\\d*)\" + whitespace + \"*\\\\)|)(?=[^-]|$)\",\n\n\t// Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter\n\trtrim = new RegExp( \"^\" + whitespace + \"+|((?:^|[^\\\\\\\\])(?:\\\\\\\\.)*)\" + whitespace + \"+$\", \"g\" ),\n\n\trcomma = new RegExp( \"^\" + whitespace + \"*,\" + whitespace + \"*\" ),\n\trcombinators = new RegExp( \"^\" + whitespace + \"*([\\\\x20\\\\t\\\\r\\\\n\\\\f>+~])\" + whitespace + \"*\" ),\n\trpseudo = new RegExp( pseudos ),\n\n\t// Easily-parseable/retrievable ID or TAG or CLASS selectors\n\trquickExpr = /^(?:#([\\w\\-]+)|(\\w+)|\\.([\\w\\-]+))$/,\n\n\trnot = /^:not/,\n\trsibling = /[\\x20\\t\\r\\n\\f]*[+~]/,\n\trendsWithNot = /:not\\($/,\n\n\trheader = /h\\d/i,\n\trinputs = /input|select|textarea|button/i,\n\n\trbackslash = /\\\\(?!\\\\)/g,\n\n\tmatchExpr = {\n\t\t\"ID\": new RegExp( \"^#(\" + characterEncoding + \")\" ),\n\t\t\"CLASS\": new RegExp( \"^\\\\.(\" + characterEncoding + \")\" ),\n\t\t\"NAME\": new RegExp( \"^\\\\[name=['\\\"]?(\" + characterEncoding + \")['\\\"]?\\\\]\" ),\n\t\t\"TAG\": new RegExp( \"^(\" + characterEncoding.replace( \"w\", \"w*\" ) + \")\" ),\n\t\t\"ATTR\": new RegExp( \"^\" + attributes ),\n\t\t\"PSEUDO\": new RegExp( \"^\" + pseudos ),\n\t\t\"POS\": new RegExp( pos, \"i\" ),\n\t\t\"CHILD\": new RegExp( \"^:(only|nth|first|last)-child(?:\\\\(\" + whitespace +\n\t\t\t\"*(even|odd|(([+-]|)(\\\\d*)n|)\" + whitespace + \"*(?:([+-]|)\" + whitespace +\n\t\t\t\"*(\\\\d+)|))\" + whitespace + \"*\\\\)|)\", \"i\" ),\n\t\t// For use in libraries implementing .is()\n\t\t\"needsContext\": new RegExp( \"^\" + whitespace + \"*[>+~]|\" + pos, \"i\" )\n\t},\n\n\t// Support\n\n\t// Used for testing something on an element\n\tassert = function( fn ) {\n\t\tvar div = document.createElement(\"div\");\n\n\t\ttry {\n\t\t\treturn fn( div );\n\t\t} catch (e) {\n\t\t\treturn false;\n\t\t} finally {\n\t\t\t// release memory in IE\n\t\t\tdiv = null;\n\t\t}\n\t},\n\n\t// Check if getElementsByTagName(\"*\") returns only elements\n\tassertTagNameNoComments = assert(function( div ) {\n\t\tdiv.appendChild( document.createComment(\"\") );\n\t\treturn !div.getElementsByTagName(\"*\").length;\n\t}),\n\n\t// Check if getAttribute returns normalized href attributes\n\tassertHrefNotNormalized = assert(function( div ) {\n\t\tdiv.innerHTML = \"\";\n\t\treturn div.firstChild && typeof div.firstChild.getAttribute !== strundefined &&\n\t\t\tdiv.firstChild.getAttribute(\"href\") === \"#\";\n\t}),\n\n\t// Check if attributes should be retrieved by attribute nodes\n\tassertAttributes = assert(function( div ) {\n\t\tdiv.innerHTML = \"\";\n\t\tvar type = typeof div.lastChild.getAttribute(\"multiple\");\n\t\t// IE8 returns a string for some attributes even when not present\n\t\treturn type !== \"boolean\" && type !== \"string\";\n\t}),\n\n\t// Check if getElementsByClassName can be trusted\n\tassertUsableClassName = assert(function( div ) {\n\t\t// Opera can't find a second classname (in 9.6)\n\t\tdiv.innerHTML = \"\";\n\t\tif ( !div.getElementsByClassName || !div.getElementsByClassName(\"e\").length ) {\n\t\t\treturn false;\n\t\t}\n\n\t\t// Safari 3.2 caches class attributes and doesn't catch changes\n\t\tdiv.lastChild.className = \"e\";\n\t\treturn div.getElementsByClassName(\"e\").length === 2;\n\t}),\n\n\t// Check if getElementById returns elements by name\n\t// Check if getElementsByName privileges form controls or returns elements by ID\n\tassertUsableName = assert(function( div ) {\n\t\t// Inject content\n\t\tdiv.id = expando + 0;\n\t\tdiv.innerHTML = \"\";\n\t\tdocElem.insertBefore( div, docElem.firstChild );\n\n\t\t// Test\n\t\tvar pass = document.getElementsByName &&\n\t\t\t// buggy browsers will return fewer than the correct 2\n\t\t\tdocument.getElementsByName( expando ).length === 2 +\n\t\t\t// buggy browsers will return more than the correct 0\n\t\t\tdocument.getElementsByName( expando + 0 ).length;\n\t\tassertGetIdNotName = !document.getElementById( expando );\n\n\t\t// Cleanup\n\t\tdocElem.removeChild( div );\n\n\t\treturn pass;\n\t});\n\n// If slice is not available, provide a backup\ntry {\n\tslice.call( docElem.childNodes, 0 )[0].nodeType;\n} catch ( e ) {\n\tslice = function( i ) {\n\t\tvar elem,\n\t\t\tresults = [];\n\t\tfor ( ; (elem = this[i]); i++ ) {\n\t\t\tresults.push( elem );\n\t\t}\n\t\treturn results;\n\t};\n}\n\nfunction Sizzle( selector, context, results, seed ) {\n\tresults = results || [];\n\tcontext = context || document;\n\tvar match, elem, xml, m,\n\t\tnodeType = context.nodeType;\n\n\tif ( !selector || typeof selector !== \"string\" ) {\n\t\treturn results;\n\t}\n\n\tif ( nodeType !== 1 && nodeType !== 9 ) {\n\t\treturn [];\n\t}\n\n\txml = isXML( context );\n\n\tif ( !xml && !seed ) {\n\t\tif ( (match = rquickExpr.exec( selector )) ) {\n\t\t\t// Speed-up: Sizzle(\"#ID\")\n\t\t\tif ( (m = match[1]) ) {\n\t\t\t\tif ( nodeType === 9 ) {\n\t\t\t\t\telem = context.getElementById( m );\n\t\t\t\t\t// Check parentNode to catch when Blackberry 4.6 returns\n\t\t\t\t\t// nodes that are no longer in the document #6963\n\t\t\t\t\tif ( elem && elem.parentNode ) {\n\t\t\t\t\t\t// Handle the case where IE, Opera, and Webkit return items\n\t\t\t\t\t\t// by name instead of ID\n\t\t\t\t\t\tif ( elem.id === m ) {\n\t\t\t\t\t\t\tresults.push( elem );\n\t\t\t\t\t\t\treturn results;\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\treturn results;\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\t// Context is not a document\n\t\t\t\t\tif ( context.ownerDocument && (elem = context.ownerDocument.getElementById( m )) &&\n\t\t\t\t\t\tcontains( context, elem ) && elem.id === m ) {\n\t\t\t\t\t\tresults.push( elem );\n\t\t\t\t\t\treturn results;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t// Speed-up: Sizzle(\"TAG\")\n\t\t\t} else if ( match[2] ) {\n\t\t\t\tpush.apply( results, slice.call(context.getElementsByTagName( selector ), 0) );\n\t\t\t\treturn results;\n\n\t\t\t// Speed-up: Sizzle(\".CLASS\")\n\t\t\t} else if ( (m = match[3]) && assertUsableClassName && context.getElementsByClassName ) {\n\t\t\t\tpush.apply( results, slice.call(context.getElementsByClassName( m ), 0) );\n\t\t\t\treturn results;\n\t\t\t}\n\t\t}\n\t}\n\n\t// All others\n\treturn select( selector.replace( rtrim, \"$1\" ), context, results, seed, xml );\n}\n\nSizzle.matches = function( expr, elements ) {\n\treturn Sizzle( expr, null, null, elements );\n};\n\nSizzle.matchesSelector = function( elem, expr ) {\n\treturn Sizzle( expr, null, null, [ elem ] ).length > 0;\n};\n\n// Returns a function to use in pseudos for input types\nfunction createInputPseudo( type ) {\n\treturn function( elem ) {\n\t\tvar name = elem.nodeName.toLowerCase();\n\t\treturn name === \"input\" && elem.type === type;\n\t};\n}\n\n// Returns a function to use in pseudos for buttons\nfunction createButtonPseudo( type ) {\n\treturn function( elem ) {\n\t\tvar name = elem.nodeName.toLowerCase();\n\t\treturn (name === \"input\" || name === \"button\") && elem.type === type;\n\t};\n}\n\n// Returns a function to use in pseudos for positionals\nfunction createPositionalPseudo( fn ) {\n\treturn markFunction(function( argument ) {\n\t\targument = +argument;\n\t\treturn markFunction(function( seed, matches ) {\n\t\t\tvar j,\n\t\t\t\tmatchIndexes = fn( [], seed.length, argument ),\n\t\t\t\ti = matchIndexes.length;\n\n\t\t\t// Match elements found at the specified indexes\n\t\t\twhile ( i-- ) {\n\t\t\t\tif ( seed[ (j = matchIndexes[i]) ] ) {\n\t\t\t\t\tseed[j] = !(matches[j] = seed[j]);\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t});\n}\n\n/**\n * Utility function for retrieving the text value of an array of DOM nodes\n * @param {Array|Element} elem\n */\ngetText = Sizzle.getText = function( elem ) {\n\tvar node,\n\t\tret = \"\",\n\t\ti = 0,\n\t\tnodeType = elem.nodeType;\n\n\tif ( nodeType ) {\n\t\tif ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) {\n\t\t\t// Use textContent for elements\n\t\t\t// innerText usage removed for consistency of new lines (see #11153)\n\t\t\tif ( typeof elem.textContent === \"string\" ) {\n\t\t\t\treturn elem.textContent;\n\t\t\t} else {\n\t\t\t\t// Traverse its children\n\t\t\t\tfor ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {\n\t\t\t\t\tret += getText( elem );\n\t\t\t\t}\n\t\t\t}\n\t\t} else if ( nodeType === 3 || nodeType === 4 ) {\n\t\t\treturn elem.nodeValue;\n\t\t}\n\t\t// Do not include comment or processing instruction nodes\n\t} else {\n\n\t\t// If no nodeType, this is expected to be an array\n\t\tfor ( ; (node = elem[i]); i++ ) {\n\t\t\t// Do not traverse comment nodes\n\t\t\tret += getText( node );\n\t\t}\n\t}\n\treturn ret;\n};\n\nisXML = Sizzle.isXML = function( elem ) {\n\t// documentElement is verified for cases where it doesn't yet exist\n\t// (such as loading iframes in IE - #4833)\n\tvar documentElement = elem && (elem.ownerDocument || elem).documentElement;\n\treturn documentElement ? documentElement.nodeName !== \"HTML\" : false;\n};\n\n// Element contains another\ncontains = Sizzle.contains = docElem.contains ?\n\tfunction( a, b ) {\n\t\tvar adown = a.nodeType === 9 ? a.documentElement : a,\n\t\t\tbup = b && b.parentNode;\n\t\treturn a === bup || !!( bup && bup.nodeType === 1 && adown.contains && adown.contains(bup) );\n\t} :\n\tdocElem.compareDocumentPosition ?\n\tfunction( a, b ) {\n\t\treturn b && !!( a.compareDocumentPosition( b ) & 16 );\n\t} :\n\tfunction( a, b ) {\n\t\twhile ( (b = b.parentNode) ) {\n\t\t\tif ( b === a ) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\t\treturn false;\n\t};\n\nSizzle.attr = function( elem, name ) {\n\tvar val,\n\t\txml = isXML( elem );\n\n\tif ( !xml ) {\n\t\tname = name.toLowerCase();\n\t}\n\tif ( (val = Expr.attrHandle[ name ]) ) {\n\t\treturn val( elem );\n\t}\n\tif ( xml || assertAttributes ) {\n\t\treturn elem.getAttribute( name );\n\t}\n\tval = elem.getAttributeNode( name );\n\treturn val ?\n\t\ttypeof elem[ name ] === \"boolean\" ?\n\t\t\telem[ name ] ? name : null :\n\t\t\tval.specified ? val.value : null :\n\t\tnull;\n};\n\nExpr = Sizzle.selectors = {\n\n\t// Can be adjusted by the user\n\tcacheLength: 50,\n\n\tcreatePseudo: markFunction,\n\n\tmatch: matchExpr,\n\n\t// IE6/7 return a modified href\n\tattrHandle: assertHrefNotNormalized ?\n\t\t{} :\n\t\t{\n\t\t\t\"href\": function( elem ) {\n\t\t\t\treturn elem.getAttribute( \"href\", 2 );\n\t\t\t},\n\t\t\t\"type\": function( elem ) {\n\t\t\t\treturn elem.getAttribute(\"type\");\n\t\t\t}\n\t\t},\n\n\tfind: {\n\t\t\"ID\": assertGetIdNotName ?\n\t\t\tfunction( id, context, xml ) {\n\t\t\t\tif ( typeof context.getElementById !== strundefined && !xml ) {\n\t\t\t\t\tvar m = context.getElementById( id );\n\t\t\t\t\t// Check parentNode to catch when Blackberry 4.6 returns\n\t\t\t\t\t// nodes that are no longer in the document #6963\n\t\t\t\t\treturn m && m.parentNode ? [m] : [];\n\t\t\t\t}\n\t\t\t} :\n\t\t\tfunction( id, context, xml ) {\n\t\t\t\tif ( typeof context.getElementById !== strundefined && !xml ) {\n\t\t\t\t\tvar m = context.getElementById( id );\n\n\t\t\t\t\treturn m ?\n\t\t\t\t\t\tm.id === id || typeof m.getAttributeNode !== strundefined && m.getAttributeNode(\"id\").value === id ?\n\t\t\t\t\t\t\t[m] :\n\t\t\t\t\t\t\tundefined :\n\t\t\t\t\t\t[];\n\t\t\t\t}\n\t\t\t},\n\n\t\t\"TAG\": assertTagNameNoComments ?\n\t\t\tfunction( tag, context ) {\n\t\t\t\tif ( typeof context.getElementsByTagName !== strundefined ) {\n\t\t\t\t\treturn context.getElementsByTagName( tag );\n\t\t\t\t}\n\t\t\t} :\n\t\t\tfunction( tag, context ) {\n\t\t\t\tvar results = context.getElementsByTagName( tag );\n\n\t\t\t\t// Filter out possible comments\n\t\t\t\tif ( tag === \"*\" ) {\n\t\t\t\t\tvar elem,\n\t\t\t\t\t\ttmp = [],\n\t\t\t\t\t\ti = 0;\n\n\t\t\t\t\tfor ( ; (elem = results[i]); i++ ) {\n\t\t\t\t\t\tif ( elem.nodeType === 1 ) {\n\t\t\t\t\t\t\ttmp.push( elem );\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\treturn tmp;\n\t\t\t\t}\n\t\t\t\treturn results;\n\t\t\t},\n\n\t\t\"NAME\": assertUsableName && function( tag, context ) {\n\t\t\tif ( typeof context.getElementsByName !== strundefined ) {\n\t\t\t\treturn context.getElementsByName( name );\n\t\t\t}\n\t\t},\n\n\t\t\"CLASS\": assertUsableClassName && function( className, context, xml ) {\n\t\t\tif ( typeof context.getElementsByClassName !== strundefined && !xml ) {\n\t\t\t\treturn context.getElementsByClassName( className );\n\t\t\t}\n\t\t}\n\t},\n\n\trelative: {\n\t\t\">\": { dir: \"parentNode\", first: true },\n\t\t\" \": { dir: \"parentNode\" },\n\t\t\"+\": { dir: \"previousSibling\", first: true },\n\t\t\"~\": { dir: \"previousSibling\" }\n\t},\n\n\tpreFilter: {\n\t\t\"ATTR\": function( match ) {\n\t\t\tmatch[1] = match[1].replace( rbackslash, \"\" );\n\n\t\t\t// Move the given value to match[3] whether quoted or unquoted\n\t\t\tmatch[3] = ( match[4] || match[5] || \"\" ).replace( rbackslash, \"\" );\n\n\t\t\tif ( match[2] === \"~=\" ) {\n\t\t\t\tmatch[3] = \" \" + match[3] + \" \";\n\t\t\t}\n\n\t\t\treturn match.slice( 0, 4 );\n\t\t},\n\n\t\t\"CHILD\": function( match ) {\n\t\t\t/* matches from matchExpr[\"CHILD\"]\n\t\t\t\t1 type (only|nth|...)\n\t\t\t\t2 argument (even|odd|\\d*|\\d*n([+-]\\d+)?|...)\n\t\t\t\t3 xn-component of xn+y argument ([+-]?\\d*n|)\n\t\t\t\t4 sign of xn-component\n\t\t\t\t5 x of xn-component\n\t\t\t\t6 sign of y-component\n\t\t\t\t7 y of y-component\n\t\t\t*/\n\t\t\tmatch[1] = match[1].toLowerCase();\n\n\t\t\tif ( match[1] === \"nth\" ) {\n\t\t\t\t// nth-child requires argument\n\t\t\t\tif ( !match[2] ) {\n\t\t\t\t\tSizzle.error( match[0] );\n\t\t\t\t}\n\n\t\t\t\t// numeric x and y parameters for Expr.filter.CHILD\n\t\t\t\t// remember that false/true cast respectively to 0/1\n\t\t\t\tmatch[3] = +( match[3] ? match[4] + (match[5] || 1) : 2 * ( match[2] === \"even\" || match[2] === \"odd\" ) );\n\t\t\t\tmatch[4] = +( ( match[6] + match[7] ) || match[2] === \"odd\" );\n\n\t\t\t// other types prohibit arguments\n\t\t\t} else if ( match[2] ) {\n\t\t\t\tSizzle.error( match[0] );\n\t\t\t}\n\n\t\t\treturn match;\n\t\t},\n\n\t\t\"PSEUDO\": function( match ) {\n\t\t\tvar unquoted, excess;\n\t\t\tif ( matchExpr[\"CHILD\"].test( match[0] ) ) {\n\t\t\t\treturn null;\n\t\t\t}\n\n\t\t\tif ( match[3] ) {\n\t\t\t\tmatch[2] = match[3];\n\t\t\t} else if ( (unquoted = match[4]) ) {\n\t\t\t\t// Only check arguments that contain a pseudo\n\t\t\t\tif ( rpseudo.test(unquoted) &&\n\t\t\t\t\t// Get excess from tokenize (recursively)\n\t\t\t\t\t(excess = tokenize( unquoted, true )) &&\n\t\t\t\t\t// advance to the next closing parenthesis\n\t\t\t\t\t(excess = unquoted.indexOf( \")\", unquoted.length - excess ) - unquoted.length) ) {\n\n\t\t\t\t\t// excess is a negative index\n\t\t\t\t\tunquoted = unquoted.slice( 0, excess );\n\t\t\t\t\tmatch[0] = match[0].slice( 0, excess );\n\t\t\t\t}\n\t\t\t\tmatch[2] = unquoted;\n\t\t\t}\n\n\t\t\t// Return only captures needed by the pseudo filter method (type and argument)\n\t\t\treturn match.slice( 0, 3 );\n\t\t}\n\t},\n\n\tfilter: {\n\t\t\"ID\": assertGetIdNotName ?\n\t\t\tfunction( id ) {\n\t\t\t\tid = id.replace( rbackslash, \"\" );\n\t\t\t\treturn function( elem ) {\n\t\t\t\t\treturn elem.getAttribute(\"id\") === id;\n\t\t\t\t};\n\t\t\t} :\n\t\t\tfunction( id ) {\n\t\t\t\tid = id.replace( rbackslash, \"\" );\n\t\t\t\treturn function( elem ) {\n\t\t\t\t\tvar node = typeof elem.getAttributeNode !== strundefined && elem.getAttributeNode(\"id\");\n\t\t\t\t\treturn node && node.value === id;\n\t\t\t\t};\n\t\t\t},\n\n\t\t\"TAG\": function( nodeName ) {\n\t\t\tif ( nodeName === \"*\" ) {\n\t\t\t\treturn function() { return true; };\n\t\t\t}\n\t\t\tnodeName = nodeName.replace( rbackslash, \"\" ).toLowerCase();\n\n\t\t\treturn function( elem ) {\n\t\t\t\treturn elem.nodeName && elem.nodeName.toLowerCase() === nodeName;\n\t\t\t};\n\t\t},\n\n\t\t\"CLASS\": function( className ) {\n\t\t\tvar pattern = classCache[ expando ][ className + \" \" ];\n\n\t\t\treturn pattern ||\n\t\t\t\t(pattern = new RegExp( \"(^|\" + whitespace + \")\" + className + \"(\" + whitespace + \"|$)\" )) &&\n\t\t\t\tclassCache( className, function( elem ) {\n\t\t\t\t\treturn pattern.test( elem.className || (typeof elem.getAttribute !== strundefined && elem.getAttribute(\"class\")) || \"\" );\n\t\t\t\t});\n\t\t},\n\n\t\t\"ATTR\": function( name, operator, check ) {\n\t\t\treturn function( elem, context ) {\n\t\t\t\tvar result = Sizzle.attr( elem, name );\n\n\t\t\t\tif ( result == null ) {\n\t\t\t\t\treturn operator === \"!=\";\n\t\t\t\t}\n\t\t\t\tif ( !operator ) {\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\n\t\t\t\tresult += \"\";\n\n\t\t\t\treturn operator === \"=\" ? result === check :\n\t\t\t\t\toperator === \"!=\" ? result !== check :\n\t\t\t\t\toperator === \"^=\" ? check && result.indexOf( check ) === 0 :\n\t\t\t\t\toperator === \"*=\" ? check && result.indexOf( check ) > -1 :\n\t\t\t\t\toperator === \"$=\" ? check && result.substr( result.length - check.length ) === check :\n\t\t\t\t\toperator === \"~=\" ? ( \" \" + result + \" \" ).indexOf( check ) > -1 :\n\t\t\t\t\toperator === \"|=\" ? result === check || result.substr( 0, check.length + 1 ) === check + \"-\" :\n\t\t\t\t\tfalse;\n\t\t\t};\n\t\t},\n\n\t\t\"CHILD\": function( type, argument, first, last ) {\n\n\t\t\tif ( type === \"nth\" ) {\n\t\t\t\treturn function( elem ) {\n\t\t\t\t\tvar node, diff,\n\t\t\t\t\t\tparent = elem.parentNode;\n\n\t\t\t\t\tif ( first === 1 && last === 0 ) {\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\n\t\t\t\t\tif ( parent ) {\n\t\t\t\t\t\tdiff = 0;\n\t\t\t\t\t\tfor ( node = parent.firstChild; node; node = node.nextSibling ) {\n\t\t\t\t\t\t\tif ( node.nodeType === 1 ) {\n\t\t\t\t\t\t\t\tdiff++;\n\t\t\t\t\t\t\t\tif ( elem === node ) {\n\t\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t// Incorporate the offset (or cast to NaN), then check against cycle size\n\t\t\t\t\tdiff -= last;\n\t\t\t\t\treturn diff === first || ( diff % first === 0 && diff / first >= 0 );\n\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn function( elem ) {\n\t\t\t\tvar node = elem;\n\n\t\t\t\tswitch ( type ) {\n\t\t\t\t\tcase \"only\":\n\t\t\t\t\tcase \"first\":\n\t\t\t\t\t\twhile ( (node = node.previousSibling) ) {\n\t\t\t\t\t\t\tif ( node.nodeType === 1 ) {\n\t\t\t\t\t\t\t\treturn false;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tif ( type === \"first\" ) {\n\t\t\t\t\t\t\treturn true;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tnode = elem;\n\n\t\t\t\t\t\t/* falls through */\n\t\t\t\t\tcase \"last\":\n\t\t\t\t\t\twhile ( (node = node.nextSibling) ) {\n\t\t\t\t\t\t\tif ( node.nodeType === 1 ) {\n\t\t\t\t\t\t\t\treturn false;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t};\n\t\t},\n\n\t\t\"PSEUDO\": function( pseudo, argument ) {\n\t\t\t// pseudo-class names are case-insensitive\n\t\t\t// http://www.w3.org/TR/selectors/#pseudo-classes\n\t\t\t// Prioritize by case sensitivity in case custom pseudos are added with uppercase letters\n\t\t\t// Remember that setFilters inherits from pseudos\n\t\t\tvar args,\n\t\t\t\tfn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] ||\n\t\t\t\t\tSizzle.error( \"unsupported pseudo: \" + pseudo );\n\n\t\t\t// The user may use createPseudo to indicate that\n\t\t\t// arguments are needed to create the filter function\n\t\t\t// just as Sizzle does\n\t\t\tif ( fn[ expando ] ) {\n\t\t\t\treturn fn( argument );\n\t\t\t}\n\n\t\t\t// But maintain support for old signatures\n\t\t\tif ( fn.length > 1 ) {\n\t\t\t\targs = [ pseudo, pseudo, \"\", argument ];\n\t\t\t\treturn Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ?\n\t\t\t\t\tmarkFunction(function( seed, matches ) {\n\t\t\t\t\t\tvar idx,\n\t\t\t\t\t\t\tmatched = fn( seed, argument ),\n\t\t\t\t\t\t\ti = matched.length;\n\t\t\t\t\t\twhile ( i-- ) {\n\t\t\t\t\t\t\tidx = indexOf.call( seed, matched[i] );\n\t\t\t\t\t\t\tseed[ idx ] = !( matches[ idx ] = matched[i] );\n\t\t\t\t\t\t}\n\t\t\t\t\t}) :\n\t\t\t\t\tfunction( elem ) {\n\t\t\t\t\t\treturn fn( elem, 0, args );\n\t\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn fn;\n\t\t}\n\t},\n\n\tpseudos: {\n\t\t\"not\": markFunction(function( selector ) {\n\t\t\t// Trim the selector passed to compile\n\t\t\t// to avoid treating leading and trailing\n\t\t\t// spaces as combinators\n\t\t\tvar input = [],\n\t\t\t\tresults = [],\n\t\t\t\tmatcher = compile( selector.replace( rtrim, \"$1\" ) );\n\n\t\t\treturn matcher[ expando ] ?\n\t\t\t\tmarkFunction(function( seed, matches, context, xml ) {\n\t\t\t\t\tvar elem,\n\t\t\t\t\t\tunmatched = matcher( seed, null, xml, [] ),\n\t\t\t\t\t\ti = seed.length;\n\n\t\t\t\t\t// Match elements unmatched by `matcher`\n\t\t\t\t\twhile ( i-- ) {\n\t\t\t\t\t\tif ( (elem = unmatched[i]) ) {\n\t\t\t\t\t\t\tseed[i] = !(matches[i] = elem);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}) :\n\t\t\t\tfunction( elem, context, xml ) {\n\t\t\t\t\tinput[0] = elem;\n\t\t\t\t\tmatcher( input, null, xml, results );\n\t\t\t\t\treturn !results.pop();\n\t\t\t\t};\n\t\t}),\n\n\t\t\"has\": markFunction(function( selector ) {\n\t\t\treturn function( elem ) {\n\t\t\t\treturn Sizzle( selector, elem ).length > 0;\n\t\t\t};\n\t\t}),\n\n\t\t\"contains\": markFunction(function( text ) {\n\t\t\treturn function( elem ) {\n\t\t\t\treturn ( elem.textContent || elem.innerText || getText( elem ) ).indexOf( text ) > -1;\n\t\t\t};\n\t\t}),\n\n\t\t\"enabled\": function( elem ) {\n\t\t\treturn elem.disabled === false;\n\t\t},\n\n\t\t\"disabled\": function( elem ) {\n\t\t\treturn elem.disabled === true;\n\t\t},\n\n\t\t\"checked\": function( elem ) {\n\t\t\t// In CSS3, :checked should return both checked and selected elements\n\t\t\t// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked\n\t\t\tvar nodeName = elem.nodeName.toLowerCase();\n\t\t\treturn (nodeName === \"input\" && !!elem.checked) || (nodeName === \"option\" && !!elem.selected);\n\t\t},\n\n\t\t\"selected\": function( elem ) {\n\t\t\t// Accessing this property makes selected-by-default\n\t\t\t// options in Safari work properly\n\t\t\tif ( elem.parentNode ) {\n\t\t\t\telem.parentNode.selectedIndex;\n\t\t\t}\n\n\t\t\treturn elem.selected === true;\n\t\t},\n\n\t\t\"parent\": function( elem ) {\n\t\t\treturn !Expr.pseudos[\"empty\"]( elem );\n\t\t},\n\n\t\t\"empty\": function( elem ) {\n\t\t\t// http://www.w3.org/TR/selectors/#empty-pseudo\n\t\t\t// :empty is only affected by element nodes and content nodes(including text(3), cdata(4)),\n\t\t\t// not comment, processing instructions, or others\n\t\t\t// Thanks to Diego Perini for the nodeName shortcut\n\t\t\t// Greater than \"@\" means alpha characters (specifically not starting with \"#\" or \"?\")\n\t\t\tvar nodeType;\n\t\t\telem = elem.firstChild;\n\t\t\twhile ( elem ) {\n\t\t\t\tif ( elem.nodeName > \"@\" || (nodeType = elem.nodeType) === 3 || nodeType === 4 ) {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\telem = elem.nextSibling;\n\t\t\t}\n\t\t\treturn true;\n\t\t},\n\n\t\t\"header\": function( elem ) {\n\t\t\treturn rheader.test( elem.nodeName );\n\t\t},\n\n\t\t\"text\": function( elem ) {\n\t\t\tvar type, attr;\n\t\t\t// IE6 and 7 will map elem.type to 'text' for new HTML5 types (search, etc)\n\t\t\t// use getAttribute instead to test this case\n\t\t\treturn elem.nodeName.toLowerCase() === \"input\" &&\n\t\t\t\t(type = elem.type) === \"text\" &&\n\t\t\t\t( (attr = elem.getAttribute(\"type\")) == null || attr.toLowerCase() === type );\n\t\t},\n\n\t\t// Input types\n\t\t\"radio\": createInputPseudo(\"radio\"),\n\t\t\"checkbox\": createInputPseudo(\"checkbox\"),\n\t\t\"file\": createInputPseudo(\"file\"),\n\t\t\"password\": createInputPseudo(\"password\"),\n\t\t\"image\": createInputPseudo(\"image\"),\n\n\t\t\"submit\": createButtonPseudo(\"submit\"),\n\t\t\"reset\": createButtonPseudo(\"reset\"),\n\n\t\t\"button\": function( elem ) {\n\t\t\tvar name = elem.nodeName.toLowerCase();\n\t\t\treturn name === \"input\" && elem.type === \"button\" || name === \"button\";\n\t\t},\n\n\t\t\"input\": function( elem ) {\n\t\t\treturn rinputs.test( elem.nodeName );\n\t\t},\n\n\t\t\"focus\": function( elem ) {\n\t\t\tvar doc = elem.ownerDocument;\n\t\t\treturn elem === doc.activeElement && (!doc.hasFocus || doc.hasFocus()) && !!(elem.type || elem.href || ~elem.tabIndex);\n\t\t},\n\n\t\t\"active\": function( elem ) {\n\t\t\treturn elem === elem.ownerDocument.activeElement;\n\t\t},\n\n\t\t// Positional types\n\t\t\"first\": createPositionalPseudo(function() {\n\t\t\treturn [ 0 ];\n\t\t}),\n\n\t\t\"last\": createPositionalPseudo(function( matchIndexes, length ) {\n\t\t\treturn [ length - 1 ];\n\t\t}),\n\n\t\t\"eq\": createPositionalPseudo(function( matchIndexes, length, argument ) {\n\t\t\treturn [ argument < 0 ? argument + length : argument ];\n\t\t}),\n\n\t\t\"even\": createPositionalPseudo(function( matchIndexes, length ) {\n\t\t\tfor ( var i = 0; i < length; i += 2 ) {\n\t\t\t\tmatchIndexes.push( i );\n\t\t\t}\n\t\t\treturn matchIndexes;\n\t\t}),\n\n\t\t\"odd\": createPositionalPseudo(function( matchIndexes, length ) {\n\t\t\tfor ( var i = 1; i < length; i += 2 ) {\n\t\t\t\tmatchIndexes.push( i );\n\t\t\t}\n\t\t\treturn matchIndexes;\n\t\t}),\n\n\t\t\"lt\": createPositionalPseudo(function( matchIndexes, length, argument ) {\n\t\t\tfor ( var i = argument < 0 ? argument + length : argument; --i >= 0; ) {\n\t\t\t\tmatchIndexes.push( i );\n\t\t\t}\n\t\t\treturn matchIndexes;\n\t\t}),\n\n\t\t\"gt\": createPositionalPseudo(function( matchIndexes, length, argument ) {\n\t\t\tfor ( var i = argument < 0 ? argument + length : argument; ++i < length; ) {\n\t\t\t\tmatchIndexes.push( i );\n\t\t\t}\n\t\t\treturn matchIndexes;\n\t\t})\n\t}\n};\n\nfunction siblingCheck( a, b, ret ) {\n\tif ( a === b ) {\n\t\treturn ret;\n\t}\n\n\tvar cur = a.nextSibling;\n\n\twhile ( cur ) {\n\t\tif ( cur === b ) {\n\t\t\treturn -1;\n\t\t}\n\n\t\tcur = cur.nextSibling;\n\t}\n\n\treturn 1;\n}\n\nsortOrder = docElem.compareDocumentPosition ?\n\tfunction( a, b ) {\n\t\tif ( a === b ) {\n\t\t\thasDuplicate = true;\n\t\t\treturn 0;\n\t\t}\n\n\t\treturn ( !a.compareDocumentPosition || !b.compareDocumentPosition ?\n\t\t\ta.compareDocumentPosition :\n\t\t\ta.compareDocumentPosition(b) & 4\n\t\t) ? -1 : 1;\n\t} :\n\tfunction( a, b ) {\n\t\t// The nodes are identical, we can exit early\n\t\tif ( a === b ) {\n\t\t\thasDuplicate = true;\n\t\t\treturn 0;\n\n\t\t// Fallback to using sourceIndex (in IE) if it's available on both nodes\n\t\t} else if ( a.sourceIndex && b.sourceIndex ) {\n\t\t\treturn a.sourceIndex - b.sourceIndex;\n\t\t}\n\n\t\tvar al, bl,\n\t\t\tap = [],\n\t\t\tbp = [],\n\t\t\taup = a.parentNode,\n\t\t\tbup = b.parentNode,\n\t\t\tcur = aup;\n\n\t\t// If the nodes are siblings (or identical) we can do a quick check\n\t\tif ( aup === bup ) {\n\t\t\treturn siblingCheck( a, b );\n\n\t\t// If no parents were found then the nodes are disconnected\n\t\t} else if ( !aup ) {\n\t\t\treturn -1;\n\n\t\t} else if ( !bup ) {\n\t\t\treturn 1;\n\t\t}\n\n\t\t// Otherwise they're somewhere else in the tree so we need\n\t\t// to build up a full list of the parentNodes for comparison\n\t\twhile ( cur ) {\n\t\t\tap.unshift( cur );\n\t\t\tcur = cur.parentNode;\n\t\t}\n\n\t\tcur = bup;\n\n\t\twhile ( cur ) {\n\t\t\tbp.unshift( cur );\n\t\t\tcur = cur.parentNode;\n\t\t}\n\n\t\tal = ap.length;\n\t\tbl = bp.length;\n\n\t\t// Start walking down the tree looking for a discrepancy\n\t\tfor ( var i = 0; i < al && i < bl; i++ ) {\n\t\t\tif ( ap[i] !== bp[i] ) {\n\t\t\t\treturn siblingCheck( ap[i], bp[i] );\n\t\t\t}\n\t\t}\n\n\t\t// We ended someplace up the tree so do a sibling check\n\t\treturn i === al ?\n\t\t\tsiblingCheck( a, bp[i], -1 ) :\n\t\t\tsiblingCheck( ap[i], b, 1 );\n\t};\n\n// Always assume the presence of duplicates if sort doesn't\n// pass them to our comparison function (as in Google Chrome).\n[0, 0].sort( sortOrder );\nbaseHasDuplicate = !hasDuplicate;\n\n// Document sorting and removing duplicates\nSizzle.uniqueSort = function( results ) {\n\tvar elem,\n\t\tduplicates = [],\n\t\ti = 1,\n\t\tj = 0;\n\n\thasDuplicate = baseHasDuplicate;\n\tresults.sort( sortOrder );\n\n\tif ( hasDuplicate ) {\n\t\tfor ( ; (elem = results[i]); i++ ) {\n\t\t\tif ( elem === results[ i - 1 ] ) {\n\t\t\t\tj = duplicates.push( i );\n\t\t\t}\n\t\t}\n\t\twhile ( j-- ) {\n\t\t\tresults.splice( duplicates[ j ], 1 );\n\t\t}\n\t}\n\n\treturn results;\n};\n\nSizzle.error = function( msg ) {\n\tthrow new Error( \"Syntax error, unrecognized expression: \" + msg );\n};\n\nfunction tokenize( selector, parseOnly ) {\n\tvar matched, match, tokens, type,\n\t\tsoFar, groups, preFilters,\n\t\tcached = tokenCache[ expando ][ selector + \" \" ];\n\n\tif ( cached ) {\n\t\treturn parseOnly ? 0 : cached.slice( 0 );\n\t}\n\n\tsoFar = selector;\n\tgroups = [];\n\tpreFilters = Expr.preFilter;\n\n\twhile ( soFar ) {\n\n\t\t// Comma and first run\n\t\tif ( !matched || (match = rcomma.exec( soFar )) ) {\n\t\t\tif ( match ) {\n\t\t\t\t// Don't consume trailing commas as valid\n\t\t\t\tsoFar = soFar.slice( match[0].length ) || soFar;\n\t\t\t}\n\t\t\tgroups.push( tokens = [] );\n\t\t}\n\n\t\tmatched = false;\n\n\t\t// Combinators\n\t\tif ( (match = rcombinators.exec( soFar )) ) {\n\t\t\ttokens.push( matched = new Token( match.shift() ) );\n\t\t\tsoFar = soFar.slice( matched.length );\n\n\t\t\t// Cast descendant combinators to space\n\t\t\tmatched.type = match[0].replace( rtrim, \" \" );\n\t\t}\n\n\t\t// Filters\n\t\tfor ( type in Expr.filter ) {\n\t\t\tif ( (match = matchExpr[ type ].exec( soFar )) && (!preFilters[ type ] ||\n\t\t\t\t(match = preFilters[ type ]( match ))) ) {\n\n\t\t\t\ttokens.push( matched = new Token( match.shift() ) );\n\t\t\t\tsoFar = soFar.slice( matched.length );\n\t\t\t\tmatched.type = type;\n\t\t\t\tmatched.matches = match;\n\t\t\t}\n\t\t}\n\n\t\tif ( !matched ) {\n\t\t\tbreak;\n\t\t}\n\t}\n\n\t// Return the length of the invalid excess\n\t// if we're just parsing\n\t// Otherwise, throw an error or return tokens\n\treturn parseOnly ?\n\t\tsoFar.length :\n\t\tsoFar ?\n\t\t\tSizzle.error( selector ) :\n\t\t\t// Cache the tokens\n\t\t\ttokenCache( selector, groups ).slice( 0 );\n}\n\nfunction addCombinator( matcher, combinator, base ) {\n\tvar dir = combinator.dir,\n\t\tcheckNonElements = base && combinator.dir === \"parentNode\",\n\t\tdoneName = done++;\n\n\treturn combinator.first ?\n\t\t// Check against closest ancestor/preceding element\n\t\tfunction( elem, context, xml ) {\n\t\t\twhile ( (elem = elem[ dir ]) ) {\n\t\t\t\tif ( checkNonElements || elem.nodeType === 1 ) {\n\t\t\t\t\treturn matcher( elem, context, xml );\n\t\t\t\t}\n\t\t\t}\n\t\t} :\n\n\t\t// Check against all ancestor/preceding elements\n\t\tfunction( elem, context, xml ) {\n\t\t\t// We can't set arbitrary data on XML nodes, so they don't benefit from dir caching\n\t\t\tif ( !xml ) {\n\t\t\t\tvar cache,\n\t\t\t\t\tdirkey = dirruns + \" \" + doneName + \" \",\n\t\t\t\t\tcachedkey = dirkey + cachedruns;\n\t\t\t\twhile ( (elem = elem[ dir ]) ) {\n\t\t\t\t\tif ( checkNonElements || elem.nodeType === 1 ) {\n\t\t\t\t\t\tif ( (cache = elem[ expando ]) === cachedkey ) {\n\t\t\t\t\t\t\treturn elem.sizset;\n\t\t\t\t\t\t} else if ( typeof cache === \"string\" && cache.indexOf(dirkey) === 0 ) {\n\t\t\t\t\t\t\tif ( elem.sizset ) {\n\t\t\t\t\t\t\t\treturn elem;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\telem[ expando ] = cachedkey;\n\t\t\t\t\t\t\tif ( matcher( elem, context, xml ) ) {\n\t\t\t\t\t\t\t\telem.sizset = true;\n\t\t\t\t\t\t\t\treturn elem;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\telem.sizset = false;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\twhile ( (elem = elem[ dir ]) ) {\n\t\t\t\t\tif ( checkNonElements || elem.nodeType === 1 ) {\n\t\t\t\t\t\tif ( matcher( elem, context, xml ) ) {\n\t\t\t\t\t\t\treturn elem;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t};\n}\n\nfunction elementMatcher( matchers ) {\n\treturn matchers.length > 1 ?\n\t\tfunction( elem, context, xml ) {\n\t\t\tvar i = matchers.length;\n\t\t\twhile ( i-- ) {\n\t\t\t\tif ( !matchers[i]( elem, context, xml ) ) {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn true;\n\t\t} :\n\t\tmatchers[0];\n}\n\nfunction condense( unmatched, map, filter, context, xml ) {\n\tvar elem,\n\t\tnewUnmatched = [],\n\t\ti = 0,\n\t\tlen = unmatched.length,\n\t\tmapped = map != null;\n\n\tfor ( ; i < len; i++ ) {\n\t\tif ( (elem = unmatched[i]) ) {\n\t\t\tif ( !filter || filter( elem, context, xml ) ) {\n\t\t\t\tnewUnmatched.push( elem );\n\t\t\t\tif ( mapped ) {\n\t\t\t\t\tmap.push( i );\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\treturn newUnmatched;\n}\n\nfunction setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) {\n\tif ( postFilter && !postFilter[ expando ] ) {\n\t\tpostFilter = setMatcher( postFilter );\n\t}\n\tif ( postFinder && !postFinder[ expando ] ) {\n\t\tpostFinder = setMatcher( postFinder, postSelector );\n\t}\n\treturn markFunction(function( seed, results, context, xml ) {\n\t\tvar temp, i, elem,\n\t\t\tpreMap = [],\n\t\t\tpostMap = [],\n\t\t\tpreexisting = results.length,\n\n\t\t\t// Get initial elements from seed or context\n\t\t\telems = seed || multipleContexts( selector || \"*\", context.nodeType ? [ context ] : context, [] ),\n\n\t\t\t// Prefilter to get matcher input, preserving a map for seed-results synchronization\n\t\t\tmatcherIn = preFilter && ( seed || !selector ) ?\n\t\t\t\tcondense( elems, preMap, preFilter, context, xml ) :\n\t\t\t\telems,\n\n\t\t\tmatcherOut = matcher ?\n\t\t\t\t// If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results,\n\t\t\t\tpostFinder || ( seed ? preFilter : preexisting || postFilter ) ?\n\n\t\t\t\t\t// ...intermediate processing is necessary\n\t\t\t\t\t[] :\n\n\t\t\t\t\t// ...otherwise use results directly\n\t\t\t\t\tresults :\n\t\t\t\tmatcherIn;\n\n\t\t// Find primary matches\n\t\tif ( matcher ) {\n\t\t\tmatcher( matcherIn, matcherOut, context, xml );\n\t\t}\n\n\t\t// Apply postFilter\n\t\tif ( postFilter ) {\n\t\t\ttemp = condense( matcherOut, postMap );\n\t\t\tpostFilter( temp, [], context, xml );\n\n\t\t\t// Un-match failing elements by moving them back to matcherIn\n\t\t\ti = temp.length;\n\t\t\twhile ( i-- ) {\n\t\t\t\tif ( (elem = temp[i]) ) {\n\t\t\t\t\tmatcherOut[ postMap[i] ] = !(matcherIn[ postMap[i] ] = elem);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif ( seed ) {\n\t\t\tif ( postFinder || preFilter ) {\n\t\t\t\tif ( postFinder ) {\n\t\t\t\t\t// Get the final matcherOut by condensing this intermediate into postFinder contexts\n\t\t\t\t\ttemp = [];\n\t\t\t\t\ti = matcherOut.length;\n\t\t\t\t\twhile ( i-- ) {\n\t\t\t\t\t\tif ( (elem = matcherOut[i]) ) {\n\t\t\t\t\t\t\t// Restore matcherIn since elem is not yet a final match\n\t\t\t\t\t\t\ttemp.push( (matcherIn[i] = elem) );\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tpostFinder( null, (matcherOut = []), temp, xml );\n\t\t\t\t}\n\n\t\t\t\t// Move matched elements from seed to results to keep them synchronized\n\t\t\t\ti = matcherOut.length;\n\t\t\t\twhile ( i-- ) {\n\t\t\t\t\tif ( (elem = matcherOut[i]) &&\n\t\t\t\t\t\t(temp = postFinder ? indexOf.call( seed, elem ) : preMap[i]) > -1 ) {\n\n\t\t\t\t\t\tseed[temp] = !(results[temp] = elem);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t// Add elements to results, through postFinder if defined\n\t\t} else {\n\t\t\tmatcherOut = condense(\n\t\t\t\tmatcherOut === results ?\n\t\t\t\t\tmatcherOut.splice( preexisting, matcherOut.length ) :\n\t\t\t\t\tmatcherOut\n\t\t\t);\n\t\t\tif ( postFinder ) {\n\t\t\t\tpostFinder( null, results, matcherOut, xml );\n\t\t\t} else {\n\t\t\t\tpush.apply( results, matcherOut );\n\t\t\t}\n\t\t}\n\t});\n}\n\nfunction matcherFromTokens( tokens ) {\n\tvar checkContext, matcher, j,\n\t\tlen = tokens.length,\n\t\tleadingRelative = Expr.relative[ tokens[0].type ],\n\t\timplicitRelative = leadingRelative || Expr.relative[\" \"],\n\t\ti = leadingRelative ? 1 : 0,\n\n\t\t// The foundational matcher ensures that elements are reachable from top-level context(s)\n\t\tmatchContext = addCombinator( function( elem ) {\n\t\t\treturn elem === checkContext;\n\t\t}, implicitRelative, true ),\n\t\tmatchAnyContext = addCombinator( function( elem ) {\n\t\t\treturn indexOf.call( checkContext, elem ) > -1;\n\t\t}, implicitRelative, true ),\n\t\tmatchers = [ function( elem, context, xml ) {\n\t\t\treturn ( !leadingRelative && ( xml || context !== outermostContext ) ) || (\n\t\t\t\t(checkContext = context).nodeType ?\n\t\t\t\t\tmatchContext( elem, context, xml ) :\n\t\t\t\t\tmatchAnyContext( elem, context, xml ) );\n\t\t} ];\n\n\tfor ( ; i < len; i++ ) {\n\t\tif ( (matcher = Expr.relative[ tokens[i].type ]) ) {\n\t\t\tmatchers = [ addCombinator( elementMatcher( matchers ), matcher ) ];\n\t\t} else {\n\t\t\tmatcher = Expr.filter[ tokens[i].type ].apply( null, tokens[i].matches );\n\n\t\t\t// Return special upon seeing a positional matcher\n\t\t\tif ( matcher[ expando ] ) {\n\t\t\t\t// Find the next relative operator (if any) for proper handling\n\t\t\t\tj = ++i;\n\t\t\t\tfor ( ; j < len; j++ ) {\n\t\t\t\t\tif ( Expr.relative[ tokens[j].type ] ) {\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn setMatcher(\n\t\t\t\t\ti > 1 && elementMatcher( matchers ),\n\t\t\t\t\ti > 1 && tokens.slice( 0, i - 1 ).join(\"\").replace( rtrim, \"$1\" ),\n\t\t\t\t\tmatcher,\n\t\t\t\t\ti < j && matcherFromTokens( tokens.slice( i, j ) ),\n\t\t\t\t\tj < len && matcherFromTokens( (tokens = tokens.slice( j )) ),\n\t\t\t\t\tj < len && tokens.join(\"\")\n\t\t\t\t);\n\t\t\t}\n\t\t\tmatchers.push( matcher );\n\t\t}\n\t}\n\n\treturn elementMatcher( matchers );\n}\n\nfunction matcherFromGroupMatchers( elementMatchers, setMatchers ) {\n\tvar bySet = setMatchers.length > 0,\n\t\tbyElement = elementMatchers.length > 0,\n\t\tsuperMatcher = function( seed, context, xml, results, expandContext ) {\n\t\t\tvar elem, j, matcher,\n\t\t\t\tsetMatched = [],\n\t\t\t\tmatchedCount = 0,\n\t\t\t\ti = \"0\",\n\t\t\t\tunmatched = seed && [],\n\t\t\t\toutermost = expandContext != null,\n\t\t\t\tcontextBackup = outermostContext,\n\t\t\t\t// We must always have either seed elements or context\n\t\t\t\telems = seed || byElement && Expr.find[\"TAG\"]( \"*\", expandContext && context.parentNode || context ),\n\t\t\t\t// Nested matchers should use non-integer dirruns\n\t\t\t\tdirrunsUnique = (dirruns += contextBackup == null ? 1 : Math.E);\n\n\t\t\tif ( outermost ) {\n\t\t\t\toutermostContext = context !== document && context;\n\t\t\t\tcachedruns = superMatcher.el;\n\t\t\t}\n\n\t\t\t// Add elements passing elementMatchers directly to results\n\t\t\tfor ( ; (elem = elems[i]) != null; i++ ) {\n\t\t\t\tif ( byElement && elem ) {\n\t\t\t\t\tfor ( j = 0; (matcher = elementMatchers[j]); j++ ) {\n\t\t\t\t\t\tif ( matcher( elem, context, xml ) ) {\n\t\t\t\t\t\t\tresults.push( elem );\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tif ( outermost ) {\n\t\t\t\t\t\tdirruns = dirrunsUnique;\n\t\t\t\t\t\tcachedruns = ++superMatcher.el;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\t// Track unmatched elements for set filters\n\t\t\t\tif ( bySet ) {\n\t\t\t\t\t// They will have gone through all possible matchers\n\t\t\t\t\tif ( (elem = !matcher && elem) ) {\n\t\t\t\t\t\tmatchedCount--;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Lengthen the array for every element, matched or not\n\t\t\t\t\tif ( seed ) {\n\t\t\t\t\t\tunmatched.push( elem );\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Apply set filters to unmatched elements\n\t\t\tmatchedCount += i;\n\t\t\tif ( bySet && i !== matchedCount ) {\n\t\t\t\tfor ( j = 0; (matcher = setMatchers[j]); j++ ) {\n\t\t\t\t\tmatcher( unmatched, setMatched, context, xml );\n\t\t\t\t}\n\n\t\t\t\tif ( seed ) {\n\t\t\t\t\t// Reintegrate element matches to eliminate the need for sorting\n\t\t\t\t\tif ( matchedCount > 0 ) {\n\t\t\t\t\t\twhile ( i-- ) {\n\t\t\t\t\t\t\tif ( !(unmatched[i] || setMatched[i]) ) {\n\t\t\t\t\t\t\t\tsetMatched[i] = pop.call( results );\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t// Discard index placeholder values to get only actual matches\n\t\t\t\t\tsetMatched = condense( setMatched );\n\t\t\t\t}\n\n\t\t\t\t// Add matches to results\n\t\t\t\tpush.apply( results, setMatched );\n\n\t\t\t\t// Seedless set matches succeeding multiple successful matchers stipulate sorting\n\t\t\t\tif ( outermost && !seed && setMatched.length > 0 &&\n\t\t\t\t\t( matchedCount + setMatchers.length ) > 1 ) {\n\n\t\t\t\t\tSizzle.uniqueSort( results );\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Override manipulation of globals by nested matchers\n\t\t\tif ( outermost ) {\n\t\t\t\tdirruns = dirrunsUnique;\n\t\t\t\toutermostContext = contextBackup;\n\t\t\t}\n\n\t\t\treturn unmatched;\n\t\t};\n\n\tsuperMatcher.el = 0;\n\treturn bySet ?\n\t\tmarkFunction( superMatcher ) :\n\t\tsuperMatcher;\n}\n\ncompile = Sizzle.compile = function( selector, group /* Internal Use Only */ ) {\n\tvar i,\n\t\tsetMatchers = [],\n\t\telementMatchers = [],\n\t\tcached = compilerCache[ expando ][ selector + \" \" ];\n\n\tif ( !cached ) {\n\t\t// Generate a function of recursive functions that can be used to check each element\n\t\tif ( !group ) {\n\t\t\tgroup = tokenize( selector );\n\t\t}\n\t\ti = group.length;\n\t\twhile ( i-- ) {\n\t\t\tcached = matcherFromTokens( group[i] );\n\t\t\tif ( cached[ expando ] ) {\n\t\t\t\tsetMatchers.push( cached );\n\t\t\t} else {\n\t\t\t\telementMatchers.push( cached );\n\t\t\t}\n\t\t}\n\n\t\t// Cache the compiled function\n\t\tcached = compilerCache( selector, matcherFromGroupMatchers( elementMatchers, setMatchers ) );\n\t}\n\treturn cached;\n};\n\nfunction multipleContexts( selector, contexts, results ) {\n\tvar i = 0,\n\t\tlen = contexts.length;\n\tfor ( ; i < len; i++ ) {\n\t\tSizzle( selector, contexts[i], results );\n\t}\n\treturn results;\n}\n\nfunction select( selector, context, results, seed, xml ) {\n\tvar i, tokens, token, type, find,\n\t\tmatch = tokenize( selector ),\n\t\tj = match.length;\n\n\tif ( !seed ) {\n\t\t// Try to minimize operations if there is only one group\n\t\tif ( match.length === 1 ) {\n\n\t\t\t// Take a shortcut and set the context if the root selector is an ID\n\t\t\ttokens = match[0] = match[0].slice( 0 );\n\t\t\tif ( tokens.length > 2 && (token = tokens[0]).type === \"ID\" &&\n\t\t\t\t\tcontext.nodeType === 9 && !xml &&\n\t\t\t\t\tExpr.relative[ tokens[1].type ] ) {\n\n\t\t\t\tcontext = Expr.find[\"ID\"]( token.matches[0].replace( rbackslash, \"\" ), context, xml )[0];\n\t\t\t\tif ( !context ) {\n\t\t\t\t\treturn results;\n\t\t\t\t}\n\n\t\t\t\tselector = selector.slice( tokens.shift().length );\n\t\t\t}\n\n\t\t\t// Fetch a seed set for right-to-left matching\n\t\t\tfor ( i = matchExpr[\"POS\"].test( selector ) ? -1 : tokens.length - 1; i >= 0; i-- ) {\n\t\t\t\ttoken = tokens[i];\n\n\t\t\t\t// Abort if we hit a combinator\n\t\t\t\tif ( Expr.relative[ (type = token.type) ] ) {\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tif ( (find = Expr.find[ type ]) ) {\n\t\t\t\t\t// Search, expanding context for leading sibling combinators\n\t\t\t\t\tif ( (seed = find(\n\t\t\t\t\t\ttoken.matches[0].replace( rbackslash, \"\" ),\n\t\t\t\t\t\trsibling.test( tokens[0].type ) && context.parentNode || context,\n\t\t\t\t\t\txml\n\t\t\t\t\t)) ) {\n\n\t\t\t\t\t\t// If seed is empty or no tokens remain, we can return early\n\t\t\t\t\t\ttokens.splice( i, 1 );\n\t\t\t\t\t\tselector = seed.length && tokens.join(\"\");\n\t\t\t\t\t\tif ( !selector ) {\n\t\t\t\t\t\t\tpush.apply( results, slice.call( seed, 0 ) );\n\t\t\t\t\t\t\treturn results;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Compile and execute a filtering function\n\t// Provide `match` to avoid retokenization if we modified the selector above\n\tcompile( selector, match )(\n\t\tseed,\n\t\tcontext,\n\t\txml,\n\t\tresults,\n\t\trsibling.test( selector )\n\t);\n\treturn results;\n}\n\nif ( document.querySelectorAll ) {\n\t(function() {\n\t\tvar disconnectedMatch,\n\t\t\toldSelect = select,\n\t\t\trescape = /'|\\\\/g,\n\t\t\trattributeQuotes = /\\=[\\x20\\t\\r\\n\\f]*([^'\"\\]]*)[\\x20\\t\\r\\n\\f]*\\]/g,\n\n\t\t\t// qSa(:focus) reports false when true (Chrome 21), no need to also add to buggyMatches since matches checks buggyQSA\n\t\t\t// A support test would require too much code (would include document ready)\n\t\t\trbuggyQSA = [ \":focus\" ],\n\n\t\t\t// matchesSelector(:active) reports false when true (IE9/Opera 11.5)\n\t\t\t// A support test would require too much code (would include document ready)\n\t\t\t// just skip matchesSelector for :active\n\t\t\trbuggyMatches = [ \":active\" ],\n\t\t\tmatches = docElem.matchesSelector ||\n\t\t\t\tdocElem.mozMatchesSelector ||\n\t\t\t\tdocElem.webkitMatchesSelector ||\n\t\t\t\tdocElem.oMatchesSelector ||\n\t\t\t\tdocElem.msMatchesSelector;\n\n\t\t// Build QSA regex\n\t\t// Regex strategy adopted from Diego Perini\n\t\tassert(function( div ) {\n\t\t\t// Select is set to empty string on purpose\n\t\t\t// This is to test IE's treatment of not explictly\n\t\t\t// setting a boolean content attribute,\n\t\t\t// since its presence should be enough\n\t\t\t// http://bugs.jquery.com/ticket/12359\n\t\t\tdiv.innerHTML = \"\";\n\n\t\t\t// IE8 - Some boolean attributes are not treated correctly\n\t\t\tif ( !div.querySelectorAll(\"[selected]\").length ) {\n\t\t\t\trbuggyQSA.push( \"\\\\[\" + whitespace + \"*(?:checked|disabled|ismap|multiple|readonly|selected|value)\" );\n\t\t\t}\n\n\t\t\t// Webkit/Opera - :checked should return selected option elements\n\t\t\t// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked\n\t\t\t// IE8 throws error here (do not put tests after this one)\n\t\t\tif ( !div.querySelectorAll(\":checked\").length ) {\n\t\t\t\trbuggyQSA.push(\":checked\");\n\t\t\t}\n\t\t});\n\n\t\tassert(function( div ) {\n\n\t\t\t// Opera 10-12/IE9 - ^= $= *= and empty values\n\t\t\t// Should not select anything\n\t\t\tdiv.innerHTML = \"\";\n\t\t\tif ( div.querySelectorAll(\"[test^='']\").length ) {\n\t\t\t\trbuggyQSA.push( \"[*^$]=\" + whitespace + \"*(?:\\\"\\\"|'')\" );\n\t\t\t}\n\n\t\t\t// FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled)\n\t\t\t// IE8 throws error here (do not put tests after this one)\n\t\t\tdiv.innerHTML = \"\";\n\t\t\tif ( !div.querySelectorAll(\":enabled\").length ) {\n\t\t\t\trbuggyQSA.push(\":enabled\", \":disabled\");\n\t\t\t}\n\t\t});\n\n\t\t// rbuggyQSA always contains :focus, so no need for a length check\n\t\trbuggyQSA = /* rbuggyQSA.length && */ new RegExp( rbuggyQSA.join(\"|\") );\n\n\t\tselect = function( selector, context, results, seed, xml ) {\n\t\t\t// Only use querySelectorAll when not filtering,\n\t\t\t// when this is not xml,\n\t\t\t// and when no QSA bugs apply\n\t\t\tif ( !seed && !xml && !rbuggyQSA.test( selector ) ) {\n\t\t\t\tvar groups, i,\n\t\t\t\t\told = true,\n\t\t\t\t\tnid = expando,\n\t\t\t\t\tnewContext = context,\n\t\t\t\t\tnewSelector = context.nodeType === 9 && selector;\n\n\t\t\t\t// qSA works strangely on Element-rooted queries\n\t\t\t\t// We can work around this by specifying an extra ID on the root\n\t\t\t\t// and working up from there (Thanks to Andrew Dupont for the technique)\n\t\t\t\t// IE 8 doesn't work on object elements\n\t\t\t\tif ( context.nodeType === 1 && context.nodeName.toLowerCase() !== \"object\" ) {\n\t\t\t\t\tgroups = tokenize( selector );\n\n\t\t\t\t\tif ( (old = context.getAttribute(\"id\")) ) {\n\t\t\t\t\t\tnid = old.replace( rescape, \"\\\\$&\" );\n\t\t\t\t\t} else {\n\t\t\t\t\t\tcontext.setAttribute( \"id\", nid );\n\t\t\t\t\t}\n\t\t\t\t\tnid = \"[id='\" + nid + \"'] \";\n\n\t\t\t\t\ti = groups.length;\n\t\t\t\t\twhile ( i-- ) {\n\t\t\t\t\t\tgroups[i] = nid + groups[i].join(\"\");\n\t\t\t\t\t}\n\t\t\t\t\tnewContext = rsibling.test( selector ) && context.parentNode || context;\n\t\t\t\t\tnewSelector = groups.join(\",\");\n\t\t\t\t}\n\n\t\t\t\tif ( newSelector ) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tpush.apply( results, slice.call( newContext.querySelectorAll(\n\t\t\t\t\t\t\tnewSelector\n\t\t\t\t\t\t), 0 ) );\n\t\t\t\t\t\treturn results;\n\t\t\t\t\t} catch(qsaError) {\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tif ( !old ) {\n\t\t\t\t\t\t\tcontext.removeAttribute(\"id\");\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn oldSelect( selector, context, results, seed, xml );\n\t\t};\n\n\t\tif ( matches ) {\n\t\t\tassert(function( div ) {\n\t\t\t\t// Check to see if it's possible to do matchesSelector\n\t\t\t\t// on a disconnected node (IE 9)\n\t\t\t\tdisconnectedMatch = matches.call( div, \"div\" );\n\n\t\t\t\t// This should fail with an exception\n\t\t\t\t// Gecko does not error, returns false instead\n\t\t\t\ttry {\n\t\t\t\t\tmatches.call( div, \"[test!='']:sizzle\" );\n\t\t\t\t\trbuggyMatches.push( \"!=\", pseudos );\n\t\t\t\t} catch ( e ) {}\n\t\t\t});\n\n\t\t\t// rbuggyMatches always contains :active and :focus, so no need for a length check\n\t\t\trbuggyMatches = /* rbuggyMatches.length && */ new RegExp( rbuggyMatches.join(\"|\") );\n\n\t\t\tSizzle.matchesSelector = function( elem, expr ) {\n\t\t\t\t// Make sure that attribute selectors are quoted\n\t\t\t\texpr = expr.replace( rattributeQuotes, \"='$1']\" );\n\n\t\t\t\t// rbuggyMatches always contains :active, so no need for an existence check\n\t\t\t\tif ( !isXML( elem ) && !rbuggyMatches.test( expr ) && !rbuggyQSA.test( expr ) ) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tvar ret = matches.call( elem, expr );\n\n\t\t\t\t\t\t// IE 9's matchesSelector returns false on disconnected nodes\n\t\t\t\t\t\tif ( ret || disconnectedMatch ||\n\t\t\t\t\t\t\t\t// As well, disconnected nodes are said to be in a document\n\t\t\t\t\t\t\t\t// fragment in IE 9\n\t\t\t\t\t\t\t\telem.document && elem.document.nodeType !== 11 ) {\n\t\t\t\t\t\t\treturn ret;\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch(e) {}\n\t\t\t\t}\n\n\t\t\t\treturn Sizzle( expr, null, null, [ elem ] ).length > 0;\n\t\t\t};\n\t\t}\n\t})();\n}\n\n// Deprecated\nExpr.pseudos[\"nth\"] = Expr.pseudos[\"eq\"];\n\n// Back-compat\nfunction setFilters() {}\nExpr.filters = setFilters.prototype = Expr.pseudos;\nExpr.setFilters = new setFilters();\n\n// Override sizzle attribute retrieval\nSizzle.attr = jQuery.attr;\njQuery.find = Sizzle;\njQuery.expr = Sizzle.selectors;\njQuery.expr[\":\"] = jQuery.expr.pseudos;\njQuery.unique = Sizzle.uniqueSort;\njQuery.text = Sizzle.getText;\njQuery.isXMLDoc = Sizzle.isXML;\njQuery.contains = Sizzle.contains;\n\n\n})( window );\nvar runtil = /Until$/,\n\trparentsprev = /^(?:parents|prev(?:Until|All))/,\n\tisSimple = /^.[^:#\\[\\.,]*$/,\n\trneedsContext = jQuery.expr.match.needsContext,\n\t// methods guaranteed to produce a unique set when starting from a unique set\n\tguaranteedUnique = {\n\t\tchildren: true,\n\t\tcontents: true,\n\t\tnext: true,\n\t\tprev: true\n\t};\n\njQuery.fn.extend({\n\tfind: function( selector ) {\n\t\tvar i, l, length, n, r, ret,\n\t\t\tself = this;\n\n\t\tif ( typeof selector !== \"string\" ) {\n\t\t\treturn jQuery( selector ).filter(function() {\n\t\t\t\tfor ( i = 0, l = self.length; i < l; i++ ) {\n\t\t\t\t\tif ( jQuery.contains( self[ i ], this ) ) {\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\n\t\tret = this.pushStack( \"\", \"find\", selector );\n\n\t\tfor ( i = 0, l = this.length; i < l; i++ ) {\n\t\t\tlength = ret.length;\n\t\t\tjQuery.find( selector, this[i], ret );\n\n\t\t\tif ( i > 0 ) {\n\t\t\t\t// Make sure that the results are unique\n\t\t\t\tfor ( n = length; n < ret.length; n++ ) {\n\t\t\t\t\tfor ( r = 0; r < length; r++ ) {\n\t\t\t\t\t\tif ( ret[r] === ret[n] ) {\n\t\t\t\t\t\t\tret.splice(n--, 1);\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn ret;\n\t},\n\n\thas: function( target ) {\n\t\tvar i,\n\t\t\ttargets = jQuery( target, this ),\n\t\t\tlen = targets.length;\n\n\t\treturn this.filter(function() {\n\t\t\tfor ( i = 0; i < len; i++ ) {\n\t\t\t\tif ( jQuery.contains( this, targets[i] ) ) {\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t},\n\n\tnot: function( selector ) {\n\t\treturn this.pushStack( winnow(this, selector, false), \"not\", selector);\n\t},\n\n\tfilter: function( selector ) {\n\t\treturn this.pushStack( winnow(this, selector, true), \"filter\", selector );\n\t},\n\n\tis: function( selector ) {\n\t\treturn !!selector && (\n\t\t\ttypeof selector === \"string\" ?\n\t\t\t\t// If this is a positional/relative selector, check membership in the returned set\n\t\t\t\t// so $(\"p:first\").is(\"p:last\") won't return true for a doc with two \"p\".\n\t\t\t\trneedsContext.test( selector ) ?\n\t\t\t\t\tjQuery( selector, this.context ).index( this[0] ) >= 0 :\n\t\t\t\t\tjQuery.filter( selector, this ).length > 0 :\n\t\t\t\tthis.filter( selector ).length > 0 );\n\t},\n\n\tclosest: function( selectors, context ) {\n\t\tvar cur,\n\t\t\ti = 0,\n\t\t\tl = this.length,\n\t\t\tret = [],\n\t\t\tpos = rneedsContext.test( selectors ) || typeof selectors !== \"string\" ?\n\t\t\t\tjQuery( selectors, context || this.context ) :\n\t\t\t\t0;\n\n\t\tfor ( ; i < l; i++ ) {\n\t\t\tcur = this[i];\n\n\t\t\twhile ( cur && cur.ownerDocument && cur !== context && cur.nodeType !== 11 ) {\n\t\t\t\tif ( pos ? pos.index(cur) > -1 : jQuery.find.matchesSelector(cur, selectors) ) {\n\t\t\t\t\tret.push( cur );\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tcur = cur.parentNode;\n\t\t\t}\n\t\t}\n\n\t\tret = ret.length > 1 ? jQuery.unique( ret ) : ret;\n\n\t\treturn this.pushStack( ret, \"closest\", selectors );\n\t},\n\n\t// Determine the position of an element within\n\t// the matched set of elements\n\tindex: function( elem ) {\n\n\t\t// No argument, return index in parent\n\t\tif ( !elem ) {\n\t\t\treturn ( this[0] && this[0].parentNode ) ? this.prevAll().length : -1;\n\t\t}\n\n\t\t// index in selector\n\t\tif ( typeof elem === \"string\" ) {\n\t\t\treturn jQuery.inArray( this[0], jQuery( elem ) );\n\t\t}\n\n\t\t// Locate the position of the desired element\n\t\treturn jQuery.inArray(\n\t\t\t// If it receives a jQuery object, the first element is used\n\t\t\telem.jquery ? elem[0] : elem, this );\n\t},\n\n\tadd: function( selector, context ) {\n\t\tvar set = typeof selector === \"string\" ?\n\t\t\t\tjQuery( selector, context ) :\n\t\t\t\tjQuery.makeArray( selector && selector.nodeType ? [ selector ] : selector ),\n\t\t\tall = jQuery.merge( this.get(), set );\n\n\t\treturn this.pushStack( isDisconnected( set[0] ) || isDisconnected( all[0] ) ?\n\t\t\tall :\n\t\t\tjQuery.unique( all ) );\n\t},\n\n\taddBack: function( selector ) {\n\t\treturn this.add( selector == null ?\n\t\t\tthis.prevObject : this.prevObject.filter(selector)\n\t\t);\n\t}\n});\n\njQuery.fn.andSelf = jQuery.fn.addBack;\n\n// A painfully simple check to see if an element is disconnected\n// from a document (should be improved, where feasible).\nfunction isDisconnected( node ) {\n\treturn !node || !node.parentNode || node.parentNode.nodeType === 11;\n}\n\nfunction sibling( cur, dir ) {\n\tdo {\n\t\tcur = cur[ dir ];\n\t} while ( cur && cur.nodeType !== 1 );\n\n\treturn cur;\n}\n\njQuery.each({\n\tparent: function( elem ) {\n\t\tvar parent = elem.parentNode;\n\t\treturn parent && parent.nodeType !== 11 ? parent : null;\n\t},\n\tparents: function( elem ) {\n\t\treturn jQuery.dir( elem, \"parentNode\" );\n\t},\n\tparentsUntil: function( elem, i, until ) {\n\t\treturn jQuery.dir( elem, \"parentNode\", until );\n\t},\n\tnext: function( elem ) {\n\t\treturn sibling( elem, \"nextSibling\" );\n\t},\n\tprev: function( elem ) {\n\t\treturn sibling( elem, \"previousSibling\" );\n\t},\n\tnextAll: function( elem ) {\n\t\treturn jQuery.dir( elem, \"nextSibling\" );\n\t},\n\tprevAll: function( elem ) {\n\t\treturn jQuery.dir( elem, \"previousSibling\" );\n\t},\n\tnextUntil: function( elem, i, until ) {\n\t\treturn jQuery.dir( elem, \"nextSibling\", until );\n\t},\n\tprevUntil: function( elem, i, until ) {\n\t\treturn jQuery.dir( elem, \"previousSibling\", until );\n\t},\n\tsiblings: function( elem ) {\n\t\treturn jQuery.sibling( ( elem.parentNode || {} ).firstChild, elem );\n\t},\n\tchildren: function( elem ) {\n\t\treturn jQuery.sibling( elem.firstChild );\n\t},\n\tcontents: function( elem ) {\n\t\treturn jQuery.nodeName( elem, \"iframe\" ) ?\n\t\t\telem.contentDocument || elem.contentWindow.document :\n\t\t\tjQuery.merge( [], elem.childNodes );\n\t}\n}, function( name, fn ) {\n\tjQuery.fn[ name ] = function( until, selector ) {\n\t\tvar ret = jQuery.map( this, fn, until );\n\n\t\tif ( !runtil.test( name ) ) {\n\t\t\tselector = until;\n\t\t}\n\n\t\tif ( selector && typeof selector === \"string\" ) {\n\t\t\tret = jQuery.filter( selector, ret );\n\t\t}\n\n\t\tret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret;\n\n\t\tif ( this.length > 1 && rparentsprev.test( name ) ) {\n\t\t\tret = ret.reverse();\n\t\t}\n\n\t\treturn this.pushStack( ret, name, core_slice.call( arguments ).join(\",\") );\n\t};\n});\n\njQuery.extend({\n\tfilter: function( expr, elems, not ) {\n\t\tif ( not ) {\n\t\t\texpr = \":not(\" + expr + \")\";\n\t\t}\n\n\t\treturn elems.length === 1 ?\n\t\t\tjQuery.find.matchesSelector(elems[0], expr) ? [ elems[0] ] : [] :\n\t\t\tjQuery.find.matches(expr, elems);\n\t},\n\n\tdir: function( elem, dir, until ) {\n\t\tvar matched = [],\n\t\t\tcur = elem[ dir ];\n\n\t\twhile ( cur && cur.nodeType !== 9 && (until === undefined || cur.nodeType !== 1 || !jQuery( cur ).is( until )) ) {\n\t\t\tif ( cur.nodeType === 1 ) {\n\t\t\t\tmatched.push( cur );\n\t\t\t}\n\t\t\tcur = cur[dir];\n\t\t}\n\t\treturn matched;\n\t},\n\n\tsibling: function( n, elem ) {\n\t\tvar r = [];\n\n\t\tfor ( ; n; n = n.nextSibling ) {\n\t\t\tif ( n.nodeType === 1 && n !== elem ) {\n\t\t\t\tr.push( n );\n\t\t\t}\n\t\t}\n\n\t\treturn r;\n\t}\n});\n\n// Implement the identical functionality for filter and not\nfunction winnow( elements, qualifier, keep ) {\n\n\t// Can't pass null or undefined to indexOf in Firefox 4\n\t// Set to 0 to skip string check\n\tqualifier = qualifier || 0;\n\n\tif ( jQuery.isFunction( qualifier ) ) {\n\t\treturn jQuery.grep(elements, function( elem, i ) {\n\t\t\tvar retVal = !!qualifier.call( elem, i, elem );\n\t\t\treturn retVal === keep;\n\t\t});\n\n\t} else if ( qualifier.nodeType ) {\n\t\treturn jQuery.grep(elements, function( elem, i ) {\n\t\t\treturn ( elem === qualifier ) === keep;\n\t\t});\n\n\t} else if ( typeof qualifier === \"string\" ) {\n\t\tvar filtered = jQuery.grep(elements, function( elem ) {\n\t\t\treturn elem.nodeType === 1;\n\t\t});\n\n\t\tif ( isSimple.test( qualifier ) ) {\n\t\t\treturn jQuery.filter(qualifier, filtered, !keep);\n\t\t} else {\n\t\t\tqualifier = jQuery.filter( qualifier, filtered );\n\t\t}\n\t}\n\n\treturn jQuery.grep(elements, function( elem, i ) {\n\t\treturn ( jQuery.inArray( elem, qualifier ) >= 0 ) === keep;\n\t});\n}\nfunction createSafeFragment( document ) {\n\tvar list = nodeNames.split( \"|\" ),\n\tsafeFrag = document.createDocumentFragment();\n\n\tif ( safeFrag.createElement ) {\n\t\twhile ( list.length ) {\n\t\t\tsafeFrag.createElement(\n\t\t\t\tlist.pop()\n\t\t\t);\n\t\t}\n\t}\n\treturn safeFrag;\n}\n\nvar nodeNames = \"abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|\" +\n\t\t\"header|hgroup|mark|meter|nav|output|progress|section|summary|time|video\",\n\trinlinejQuery = / jQuery\\d+=\"(?:null|\\d+)\"/g,\n\trleadingWhitespace = /^\\s+/,\n\trxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\\w:]+)[^>]*)\\/>/gi,\n\trtagName = /<([\\w:]+)/,\n\trtbody = /]\", \"i\"),\n\trcheckableType = /^(?:checkbox|radio)$/,\n\t// checked=\"checked\" or checked\n\trchecked = /checked\\s*(?:[^=]|=\\s*.checked.)/i,\n\trscriptType = /\\/(java|ecma)script/i,\n\trcleanScript = /^\\s*\\s*$/g,\n\twrapMap = {\n\t\toption: [ 1, \"\" ],\n\t\tlegend: [ 1, \"\" ],\n\t\tthead: [ 1, \"
\", \"
\" ],\n\t\ttr: [ 2, \"
\", \"
\" ],\n\t\ttd: [ 3, \"
\", \"
\" ],\n\t\tcol: [ 2, \"
\", \"
\" ],\n\t\tarea: [ 1, \"\" ],\n\t\t_default: [ 0, \"\", \"\" ]\n\t},\n\tsafeFragment = createSafeFragment( document ),\n\tfragmentDiv = safeFragment.appendChild( document.createElement(\"div\") );\n\nwrapMap.optgroup = wrapMap.option;\nwrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead;\nwrapMap.th = wrapMap.td;\n\n// IE6-8 can't serialize link, script, style, or any html5 (NoScope) tags,\n// unless wrapped in a div with non-breaking characters in front of it.\nif ( !jQuery.support.htmlSerialize ) {\n\twrapMap._default = [ 1, \"X
\", \"
\" ];\n}\n\njQuery.fn.extend({\n\ttext: function( value ) {\n\t\treturn jQuery.access( this, function( value ) {\n\t\t\treturn value === undefined ?\n\t\t\t\tjQuery.text( this ) :\n\t\t\t\tthis.empty().append( ( this[0] && this[0].ownerDocument || document ).createTextNode( value ) );\n\t\t}, null, value, arguments.length );\n\t},\n\n\twrapAll: function( html ) {\n\t\tif ( jQuery.isFunction( html ) ) {\n\t\t\treturn this.each(function(i) {\n\t\t\t\tjQuery(this).wrapAll( html.call(this, i) );\n\t\t\t});\n\t\t}\n\n\t\tif ( this[0] ) {\n\t\t\t// The elements to wrap the target around\n\t\t\tvar wrap = jQuery( html, this[0].ownerDocument ).eq(0).clone(true);\n\n\t\t\tif ( this[0].parentNode ) {\n\t\t\t\twrap.insertBefore( this[0] );\n\t\t\t}\n\n\t\t\twrap.map(function() {\n\t\t\t\tvar elem = this;\n\n\t\t\t\twhile ( elem.firstChild && elem.firstChild.nodeType === 1 ) {\n\t\t\t\t\telem = elem.firstChild;\n\t\t\t\t}\n\n\t\t\t\treturn elem;\n\t\t\t}).append( this );\n\t\t}\n\n\t\treturn this;\n\t},\n\n\twrapInner: function( html ) {\n\t\tif ( jQuery.isFunction( html ) ) {\n\t\t\treturn this.each(function(i) {\n\t\t\t\tjQuery(this).wrapInner( html.call(this, i) );\n\t\t\t});\n\t\t}\n\n\t\treturn this.each(function() {\n\t\t\tvar self = jQuery( this ),\n\t\t\t\tcontents = self.contents();\n\n\t\t\tif ( contents.length ) {\n\t\t\t\tcontents.wrapAll( html );\n\n\t\t\t} else {\n\t\t\t\tself.append( html );\n\t\t\t}\n\t\t});\n\t},\n\n\twrap: function( html ) {\n\t\tvar isFunction = jQuery.isFunction( html );\n\n\t\treturn this.each(function(i) {\n\t\t\tjQuery( this ).wrapAll( isFunction ? html.call(this, i) : html );\n\t\t});\n\t},\n\n\tunwrap: function() {\n\t\treturn this.parent().each(function() {\n\t\t\tif ( !jQuery.nodeName( this, \"body\" ) ) {\n\t\t\t\tjQuery( this ).replaceWith( this.childNodes );\n\t\t\t}\n\t\t}).end();\n\t},\n\n\tappend: function() {\n\t\treturn this.domManip(arguments, true, function( elem ) {\n\t\t\tif ( this.nodeType === 1 || this.nodeType === 11 ) {\n\t\t\t\tthis.appendChild( elem );\n\t\t\t}\n\t\t});\n\t},\n\n\tprepend: function() {\n\t\treturn this.domManip(arguments, true, function( elem ) {\n\t\t\tif ( this.nodeType === 1 || this.nodeType === 11 ) {\n\t\t\t\tthis.insertBefore( elem, this.firstChild );\n\t\t\t}\n\t\t});\n\t},\n\n\tbefore: function() {\n\t\tif ( !isDisconnected( this[0] ) ) {\n\t\t\treturn this.domManip(arguments, false, function( elem ) {\n\t\t\t\tthis.parentNode.insertBefore( elem, this );\n\t\t\t});\n\t\t}\n\n\t\tif ( arguments.length ) {\n\t\t\tvar set = jQuery.clean( arguments );\n\t\t\treturn this.pushStack( jQuery.merge( set, this ), \"before\", this.selector );\n\t\t}\n\t},\n\n\tafter: function() {\n\t\tif ( !isDisconnected( this[0] ) ) {\n\t\t\treturn this.domManip(arguments, false, function( elem ) {\n\t\t\t\tthis.parentNode.insertBefore( elem, this.nextSibling );\n\t\t\t});\n\t\t}\n\n\t\tif ( arguments.length ) {\n\t\t\tvar set = jQuery.clean( arguments );\n\t\t\treturn this.pushStack( jQuery.merge( this, set ), \"after\", this.selector );\n\t\t}\n\t},\n\n\t// keepData is for internal use only--do not document\n\tremove: function( selector, keepData ) {\n\t\tvar elem,\n\t\t\ti = 0;\n\n\t\tfor ( ; (elem = this[i]) != null; i++ ) {\n\t\t\tif ( !selector || jQuery.filter( selector, [ elem ] ).length ) {\n\t\t\t\tif ( !keepData && elem.nodeType === 1 ) {\n\t\t\t\t\tjQuery.cleanData( elem.getElementsByTagName(\"*\") );\n\t\t\t\t\tjQuery.cleanData( [ elem ] );\n\t\t\t\t}\n\n\t\t\t\tif ( elem.parentNode ) {\n\t\t\t\t\telem.parentNode.removeChild( elem );\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn this;\n\t},\n\n\tempty: function() {\n\t\tvar elem,\n\t\t\ti = 0;\n\n\t\tfor ( ; (elem = this[i]) != null; i++ ) {\n\t\t\t// Remove element nodes and prevent memory leaks\n\t\t\tif ( elem.nodeType === 1 ) {\n\t\t\t\tjQuery.cleanData( elem.getElementsByTagName(\"*\") );\n\t\t\t}\n\n\t\t\t// Remove any remaining nodes\n\t\t\twhile ( elem.firstChild ) {\n\t\t\t\telem.removeChild( elem.firstChild );\n\t\t\t}\n\t\t}\n\n\t\treturn this;\n\t},\n\n\tclone: function( dataAndEvents, deepDataAndEvents ) {\n\t\tdataAndEvents = dataAndEvents == null ? false : dataAndEvents;\n\t\tdeepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents;\n\n\t\treturn this.map( function () {\n\t\t\treturn jQuery.clone( this, dataAndEvents, deepDataAndEvents );\n\t\t});\n\t},\n\n\thtml: function( value ) {\n\t\treturn jQuery.access( this, function( value ) {\n\t\t\tvar elem = this[0] || {},\n\t\t\t\ti = 0,\n\t\t\t\tl = this.length;\n\n\t\t\tif ( value === undefined ) {\n\t\t\t\treturn elem.nodeType === 1 ?\n\t\t\t\t\telem.innerHTML.replace( rinlinejQuery, \"\" ) :\n\t\t\t\t\tundefined;\n\t\t\t}\n\n\t\t\t// See if we can take a shortcut and just use innerHTML\n\t\t\tif ( typeof value === \"string\" && !rnoInnerhtml.test( value ) &&\n\t\t\t\t( jQuery.support.htmlSerialize || !rnoshimcache.test( value ) ) &&\n\t\t\t\t( jQuery.support.leadingWhitespace || !rleadingWhitespace.test( value ) ) &&\n\t\t\t\t!wrapMap[ ( rtagName.exec( value ) || [\"\", \"\"] )[1].toLowerCase() ] ) {\n\n\t\t\t\tvalue = value.replace( rxhtmlTag, \"<$1>\" );\n\n\t\t\t\ttry {\n\t\t\t\t\tfor (; i < l; i++ ) {\n\t\t\t\t\t\t// Remove element nodes and prevent memory leaks\n\t\t\t\t\t\telem = this[i] || {};\n\t\t\t\t\t\tif ( elem.nodeType === 1 ) {\n\t\t\t\t\t\t\tjQuery.cleanData( elem.getElementsByTagName( \"*\" ) );\n\t\t\t\t\t\t\telem.innerHTML = value;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\telem = 0;\n\n\t\t\t\t// If using innerHTML throws an exception, use the fallback method\n\t\t\t\t} catch(e) {}\n\t\t\t}\n\n\t\t\tif ( elem ) {\n\t\t\t\tthis.empty().append( value );\n\t\t\t}\n\t\t}, null, value, arguments.length );\n\t},\n\n\treplaceWith: function( value ) {\n\t\tif ( !isDisconnected( this[0] ) ) {\n\t\t\t// Make sure that the elements are removed from the DOM before they are inserted\n\t\t\t// this can help fix replacing a parent with child elements\n\t\t\tif ( jQuery.isFunction( value ) ) {\n\t\t\t\treturn this.each(function(i) {\n\t\t\t\t\tvar self = jQuery(this), old = self.html();\n\t\t\t\t\tself.replaceWith( value.call( this, i, old ) );\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tif ( typeof value !== \"string\" ) {\n\t\t\t\tvalue = jQuery( value ).detach();\n\t\t\t}\n\n\t\t\treturn this.each(function() {\n\t\t\t\tvar next = this.nextSibling,\n\t\t\t\t\tparent = this.parentNode;\n\n\t\t\t\tjQuery( this ).remove();\n\n\t\t\t\tif ( next ) {\n\t\t\t\t\tjQuery(next).before( value );\n\t\t\t\t} else {\n\t\t\t\t\tjQuery(parent).append( value );\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\n\t\treturn this.length ?\n\t\t\tthis.pushStack( jQuery(jQuery.isFunction(value) ? value() : value), \"replaceWith\", value ) :\n\t\t\tthis;\n\t},\n\n\tdetach: function( selector ) {\n\t\treturn this.remove( selector, true );\n\t},\n\n\tdomManip: function( args, table, callback ) {\n\n\t\t// Flatten any nested arrays\n\t\targs = [].concat.apply( [], args );\n\n\t\tvar results, first, fragment, iNoClone,\n\t\t\ti = 0,\n\t\t\tvalue = args[0],\n\t\t\tscripts = [],\n\t\t\tl = this.length;\n\n\t\t// We can't cloneNode fragments that contain checked, in WebKit\n\t\tif ( !jQuery.support.checkClone && l > 1 && typeof value === \"string\" && rchecked.test( value ) ) {\n\t\t\treturn this.each(function() {\n\t\t\t\tjQuery(this).domManip( args, table, callback );\n\t\t\t});\n\t\t}\n\n\t\tif ( jQuery.isFunction(value) ) {\n\t\t\treturn this.each(function(i) {\n\t\t\t\tvar self = jQuery(this);\n\t\t\t\targs[0] = value.call( this, i, table ? self.html() : undefined );\n\t\t\t\tself.domManip( args, table, callback );\n\t\t\t});\n\t\t}\n\n\t\tif ( this[0] ) {\n\t\t\tresults = jQuery.buildFragment( args, this, scripts );\n\t\t\tfragment = results.fragment;\n\t\t\tfirst = fragment.firstChild;\n\n\t\t\tif ( fragment.childNodes.length === 1 ) {\n\t\t\t\tfragment = first;\n\t\t\t}\n\n\t\t\tif ( first ) {\n\t\t\t\ttable = table && jQuery.nodeName( first, \"tr\" );\n\n\t\t\t\t// Use the original fragment for the last item instead of the first because it can end up\n\t\t\t\t// being emptied incorrectly in certain situations (#8070).\n\t\t\t\t// Fragments from the fragment cache must always be cloned and never used in place.\n\t\t\t\tfor ( iNoClone = results.cacheable || l - 1; i < l; i++ ) {\n\t\t\t\t\tcallback.call(\n\t\t\t\t\t\ttable && jQuery.nodeName( this[i], \"table\" ) ?\n\t\t\t\t\t\t\tfindOrAppend( this[i], \"tbody\" ) :\n\t\t\t\t\t\t\tthis[i],\n\t\t\t\t\t\ti === iNoClone ?\n\t\t\t\t\t\t\tfragment :\n\t\t\t\t\t\t\tjQuery.clone( fragment, true, true )\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Fix #11809: Avoid leaking memory\n\t\t\tfragment = first = null;\n\n\t\t\tif ( scripts.length ) {\n\t\t\t\tjQuery.each( scripts, function( i, elem ) {\n\t\t\t\t\tif ( elem.src ) {\n\t\t\t\t\t\tif ( jQuery.ajax ) {\n\t\t\t\t\t\t\tjQuery.ajax({\n\t\t\t\t\t\t\t\turl: elem.src,\n\t\t\t\t\t\t\t\ttype: \"GET\",\n\t\t\t\t\t\t\t\tdataType: \"script\",\n\t\t\t\t\t\t\t\tasync: false,\n\t\t\t\t\t\t\t\tglobal: false,\n\t\t\t\t\t\t\t\t\"throws\": true\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tjQuery.error(\"no ajax\");\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\tjQuery.globalEval( ( elem.text || elem.textContent || elem.innerHTML || \"\" ).replace( rcleanScript, \"\" ) );\n\t\t\t\t\t}\n\n\t\t\t\t\tif ( elem.parentNode ) {\n\t\t\t\t\t\telem.parentNode.removeChild( elem );\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\treturn this;\n\t}\n});\n\nfunction findOrAppend( elem, tag ) {\n\treturn elem.getElementsByTagName( tag )[0] || elem.appendChild( elem.ownerDocument.createElement( tag ) );\n}\n\nfunction cloneCopyEvent( src, dest ) {\n\n\tif ( dest.nodeType !== 1 || !jQuery.hasData( src ) ) {\n\t\treturn;\n\t}\n\n\tvar type, i, l,\n\t\toldData = jQuery._data( src ),\n\t\tcurData = jQuery._data( dest, oldData ),\n\t\tevents = oldData.events;\n\n\tif ( events ) {\n\t\tdelete curData.handle;\n\t\tcurData.events = {};\n\n\t\tfor ( type in events ) {\n\t\t\tfor ( i = 0, l = events[ type ].length; i < l; i++ ) {\n\t\t\t\tjQuery.event.add( dest, type, events[ type ][ i ] );\n\t\t\t}\n\t\t}\n\t}\n\n\t// make the cloned public data object a copy from the original\n\tif ( curData.data ) {\n\t\tcurData.data = jQuery.extend( {}, curData.data );\n\t}\n}\n\nfunction cloneFixAttributes( src, dest ) {\n\tvar nodeName;\n\n\t// We do not need to do anything for non-Elements\n\tif ( dest.nodeType !== 1 ) {\n\t\treturn;\n\t}\n\n\t// clearAttributes removes the attributes, which we don't want,\n\t// but also removes the attachEvent events, which we *do* want\n\tif ( dest.clearAttributes ) {\n\t\tdest.clearAttributes();\n\t}\n\n\t// mergeAttributes, in contrast, only merges back on the\n\t// original attributes, not the events\n\tif ( dest.mergeAttributes ) {\n\t\tdest.mergeAttributes( src );\n\t}\n\n\tnodeName = dest.nodeName.toLowerCase();\n\n\tif ( nodeName === \"object\" ) {\n\t\t// IE6-10 improperly clones children of object elements using classid.\n\t\t// IE10 throws NoModificationAllowedError if parent is null, #12132.\n\t\tif ( dest.parentNode ) {\n\t\t\tdest.outerHTML = src.outerHTML;\n\t\t}\n\n\t\t// This path appears unavoidable for IE9. When cloning an object\n\t\t// element in IE9, the outerHTML strategy above is not sufficient.\n\t\t// If the src has innerHTML and the destination does not,\n\t\t// copy the src.innerHTML into the dest.innerHTML. #10324\n\t\tif ( jQuery.support.html5Clone && (src.innerHTML && !jQuery.trim(dest.innerHTML)) ) {\n\t\t\tdest.innerHTML = src.innerHTML;\n\t\t}\n\n\t} else if ( nodeName === \"input\" && rcheckableType.test( src.type ) ) {\n\t\t// IE6-8 fails to persist the checked state of a cloned checkbox\n\t\t// or radio button. Worse, IE6-7 fail to give the cloned element\n\t\t// a checked appearance if the defaultChecked value isn't also set\n\n\t\tdest.defaultChecked = dest.checked = src.checked;\n\n\t\t// IE6-7 get confused and end up setting the value of a cloned\n\t\t// checkbox/radio button to an empty string instead of \"on\"\n\t\tif ( dest.value !== src.value ) {\n\t\t\tdest.value = src.value;\n\t\t}\n\n\t// IE6-8 fails to return the selected option to the default selected\n\t// state when cloning options\n\t} else if ( nodeName === \"option\" ) {\n\t\tdest.selected = src.defaultSelected;\n\n\t// IE6-8 fails to set the defaultValue to the correct value when\n\t// cloning other types of input fields\n\t} else if ( nodeName === \"input\" || nodeName === \"textarea\" ) {\n\t\tdest.defaultValue = src.defaultValue;\n\n\t// IE blanks contents when cloning scripts\n\t} else if ( nodeName === \"script\" && dest.text !== src.text ) {\n\t\tdest.text = src.text;\n\t}\n\n\t// Event data gets referenced instead of copied if the expando\n\t// gets copied too\n\tdest.removeAttribute( jQuery.expando );\n}\n\njQuery.buildFragment = function( args, context, scripts ) {\n\tvar fragment, cacheable, cachehit,\n\t\tfirst = args[ 0 ];\n\n\t// Set context from what may come in as undefined or a jQuery collection or a node\n\t// Updated to fix #12266 where accessing context[0] could throw an exception in IE9/10 &\n\t// also doubles as fix for #8950 where plain objects caused createDocumentFragment exception\n\tcontext = context || document;\n\tcontext = !context.nodeType && context[0] || context;\n\tcontext = context.ownerDocument || context;\n\n\t// Only cache \"small\" (1/2 KB) HTML strings that are associated with the main document\n\t// Cloning options loses the selected state, so don't cache them\n\t// IE 6 doesn't like it when you put
![\"56K.Cloud](\"https://raw.githubusercontent.com/56kcloud/Training/master/img/56k.jpg\")
\n\nWelcome to [56K.Cloud](https://www.56k.cloud) Docker Introduction Training.\n\nThis Docker tutorial consists of the following sections:\n\n* [Docker Getting Started with Containers](https://training.play-with-docker.com/ops-s1-hello/)\n* [Docker Images](https://training.play-with-docker.com/ops-s1-images/)\n* [Docker Networking](https://training.play-with-docker.com/docker-networking-hol/)\n* [Docker Swarm](https://training.play-with-docker.com/ops-s1-swarm-intro/)\n"
},
{
"path": "Docker/12factor/00_application.md",
"content": "# Build the application\n\nTo illustrate the 12 factors, we start by creating a simple Node.js application as a HTTP Rest API exposing CRUD verbs on a *message* model.\n\nThere is a couple of prerequisite to build this application\n* [Node.js 4.4.5 (LTS)](https://nodejs.org/en/)\n* [mongo 3.2](https://docs.mongodb.org/manual/installation/)\n\n## Routes exposed\n\nHTTP verb | URI | Action\n----------| --- | ------\nGET | /message | list all messages\nGET | /message/ID | get message with ID\nPOST | /message | create a new message\nPUT | /message/ID | modify message with ID\nDELETE | /message/ID | delete message with ID\n\n## Setup\n\n* Install Sails.js (it's to Node.js what RoR is to Ruby): `sudo npm install sails -g`\n* Create the application: `sails new messageApp && cd messageApp`\n* Launch the application: `sails lift`\n\n## First tests\n\nCreate new messages\n\n```\ncurl -XPOST http://localhost:1337/message?text=hello\ncurl -XPOST http://localhost:1337/message?text=hola\n```\n\nGet list of messages\n\n```\ncurl http://localhost:1337/message\n\n[\n {\n \"text\": \"hello\",\n \"createdAt\": \"2015-11-08T13:15:15.363Z\",\n \"updatedAt\": \"2015-11-08T13:15:15.363Z\",\n \"id\": \"5638b363c5cd0825511690bd\"\n },\n {\n \"text\": \"hola\",\n \"createdAt\": \"2015-11-08T13:15:45.774Z\",\n \"updatedAt\": \"2015-11-08T13:15:45.774Z\",\n \"id\": \"5638b381c5cd0825511690be\"\n }\n]\n```\n\nModify a message\n\n```\ncurl -XPUT http://localhost:1337/message/5638b363c5cd0825511690bd?text=hey\n```\n\nDelete a message\n\n ```\n curl -XDELETE http://localhost:1337/message/5638b381c5cd0825511690be\n ```\n\nGet updates list of messages\n\n```\ncurl http://localhost:1337/message\n\n[\n {\n \"text\": \"hey\",\n \"createdAt\": \"2015-11-08T13:15:15.363Z\",\n \"updatedAt\": \"2015-11-08T13:19:40.179Z\",\n \"id\": \"5638b363c5cd0825511690bd\"\n }\n]\n```\n\n[Next](01_codebase.md)\n"
},
{
"path": "Docker/12factor/01_codebase.md",
"content": "# 1 - Codebase\n\n**one application <=> one codebase**\n\nIf there are several codebase, it's not an application, it's a distributed system containing multiple applications.\n\nOne codebase used for several deployments of the application\n* development\n* staging\n* production\n\n## What does that mean for our application ?\n\nWe will use Git versioning system (could have chosen subversion, ...) to handle our source code.\n\n* Create a repo on [Github](https://github.com)\n* Put the code under git\n\n```\n$ echo \"# messageApp\" >> README.md\n$ git init\n$ git add .\n$ git commit -m 'First commit'\n$ git remote add origin git@github.com:GITUSER/messageApp.git\n$ git push origin master\n```\n\nThe update we've done is not linked with Docker, but we'll see in a next chapter that this will greatly help the integration of several components of the Docker ecosystem.\n\n[Previous](00_application.md) - [Next](02_dependencies.md)\n"
},
{
"path": "Docker/12factor/02_dependencies.md",
"content": "# 2 - Dependencies\n\nApplication's dependencies must be declared and isolated\n\n## What does that mean for our application ?\n\nDeclaration are done in package.json file.\n\nLet's add sails-mongo (mongodb driver) as we'll need it very quicky\n\n`npm install sails-mongo --save`\n\nThe package.json file should look like the following:\n\n```\n{\n \"name\": \"messageApp\",\n \"private\": true,\n \"version\": \"0.0.0\",\n \"description\": \"a Sails application\",\n \"keywords\": [],\n \"dependencies\": {\n \"ejs\": \"2.3.4\",\n \"grunt\": \"0.4.5\",\n \"grunt-contrib-clean\": \"0.6.0\",\n \"grunt-contrib-coffee\": \"0.13.0\",\n \"grunt-contrib-concat\": \"0.5.1\",\n \"grunt-contrib-copy\": \"0.5.0\",\n \"grunt-contrib-cssmin\": \"0.9.0\",\n \"grunt-contrib-jst\": \"0.6.0\",\n \"grunt-contrib-less\": \"1.1.0\",\n \"grunt-contrib-uglify\": \"0.7.0\",\n \"grunt-contrib-watch\": \"0.5.3\",\n \"grunt-sails-linker\": \"~0.10.1\",\n \"grunt-sync\": \"0.2.4\",\n \"include-all\": \"~0.1.6\",\n \"rc\": \"1.0.1\",\n \"sails\": \"~0.12.3\",\n \"sails-disk\": \"~0.10.9\",\n \"sails-mongo\": \"^0.12.0\" // Newly added dependency\n },\n \"scripts\": {\n \"debug\": \"node debug app.js\",\n \"start\": \"node app.js\"\n },\n \"main\": \"app.js\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git://github.com/GITUSER/messageApp.git\"\n },\n \"author\": \"AUTHOR\",\n \"license\": \"\"\n}\n```\n\nDependencies are isolated within _node-modules_ folder where all the [npm](https://npmjs.org) libraries are compiled and installed.\n\n```\n$ ls node_modules/\nejs grunt-contrib-coffee grunt-contrib-cssmin grunt-contrib-uglify grunt-sync sails\ngrunt grunt-contrib-concat grunt-contrib-jst grunt-contrib-watch include-all sails-disk\ngrunt-contrib-clean grunt-contrib-copy grunt-contrib-less grunt-sails-linker rc sails-mongo\n```\n\n[Previous](01_codebase.md) - [Next](03_configuration.md)\n"
},
{
"path": "Docker/12factor/03_configuration.md",
"content": "# 3 - Configuration\n\nConfiguration (credentials, database connection string, ...) should be stored in the environment.\n\n## What does that mean for our application ?\n\nIn _config/connections.js_, we define the _mongo_ connection and use MONGO_URL environment variable to pass the mongo connection string.\n\n```node\nmodule.exports.connections = {\n mongo: {\n adapter: 'sails-mongo',\n url: process.env.MONGO_URL\n }\n};\n```\n\nIn _config/model.js_, we make sure the _mongo_ connection defined above is the one used.\n\n```node\nmodule.exports.models = {\n connection: 'mongo',\n migrate: 'safe'\n};\n```\n\nThose changes enable to provide a different _MONGO_URL_ very easily as it's defined in the environment.\n\n[Previous](02_dependencies.md) - [Next ](04_external_services.md)\n"
},
{
"path": "Docker/12factor/04_external_services.md",
"content": "# 4 - External services\n\nHandle external services as external resources of the application.\n\nExamples:\n* database\n* log services\n* ...\n\nThis ensure the application is loosely coupled with the services so it can easily switch provider or instance if needed\n\n## What does that mean for our application ?\n\nAt this point, the only external service the application is using is MongoDB database. The loose coupling is already done by the MONGO_URL used to pass the connection string.\n\nIf something wrong happens with our instance of MongoDB (assuming a single instance is used, which is generally a bad idea...), we can easily switch to a new instance, providing a new MONGO_URL environment variable and restarting the application.\n\n[Previous](03_configuration.md) - [Next](05_build_release_run.md)\n"
},
{
"path": "Docker/12factor/05_build_release_run.md",
"content": "# 5 - Build / Release / Run\n\nBuild / Release and Run phases must be kept separated\n\n\n\nA release is deployed on the execution environment and must be immutable.\n\n## What does that mean for our application ?\n\nWe'll use Docker in the whole development pipeline. We will start by adding a Dockerfile that will help define the build phase (during which the dependencies are compiled in _node-modules_ folder)\n\n```\nFROM node:4.4.5\nENV LAST_UPDATED 20160617T185400\n\n# Copy source code\nCOPY . /app\n\n# Change working directory\nWORKDIR /app\n\n# Install dependencies\nRUN npm install\n\n# Expose API port to the outside\nENV PORT 80\nEXPOSE 80\n\n# Launch application\nCMD [\"npm\",\"start\"]\n```\n\nLet's build our application `$ docker build -t message-app:v0.1 .`\n\nAnd verify the resulting image is in the list of available images\n\n```\n$ docker images\nREPOSITORY TAG IMAGE ID CREATED SIZE\nmessage-app v0.1 f35464cf4b0b 2 seconds ago 769 MB\n```\n\nNow the image (build) is available, execution environment must be injected to create a release.\n\nThere are several options to inject the configuration in the build, among them\n* create a new image based on the build\n* define a Compose file\n\nWe'll go for the second option and define a docker-compose file where the MONGO_URL will be set with the value of the execution environment\n\n```\nversion: '3'\nservices:\n mongo:\n image: mongo:3.2\n volumes:\n - mongo-data:/data/db\n expose:\n - \"27017\"\n app:\n image: message-app:v0.1\n ports:\n - \"8000:80\"\n links:\n - mongo\n depends_on:\n - mongo\n environment:\n - MONGO_URL=mongodb://mongo/messageApp\nvolumes:\n mongo-data:\n```\n\nThis file defines a release as it considers a given build and inject the execution environment.\n\nThe run phase can be done manually with Compose CLI or through an orchestrator (Docker Cloud).\n\nCompose CLI enables to run the global application as simple as `docker-compose up -d`\n\n[Previous](04_external_services.md) - [Next](06_processes.md)\n"
},
{
"path": "Docker/12factor/06_processes.md",
"content": "# 6 - Processes\n\nAn application is made up of several processes.\n\nEach process must be stateless and must not have local storage (sessions, ...).\n\nThis is required\n* for scalability\n* fault tolerance (crashes, ...)\n\nThe data that need to be persisted, must be saved in a stateful resources (Database, shared filesystem, ...)\n\nEg: sessions can easily be saved in a Redis kv store\n\nNote: Sticky session violate 12 factor.\n\n## What does that mean for our application ?\n\nIn _config/sessions.js_, we need to modify the adapter to store session in a distributed Redis kv store (MongoDB is another possible option).\n\n```\nmodule.exports.session = {\n ...\n adapter: 'redis',\n host: process.env.REDIS_HOST || 'localhost',\n ...\n};\n```\n\nOnce done, the app needs to be rebuilt `docker build -t message-app:v0.2 .`\n\n**REDIS_HOST** needs to be added to the docker-compose file as the new release will run against this kv store.\n\n```\nversion: '3'\nservices:\n mongo:\n image: mongo:3.2\n volumes:\n - mongo-data:/data/db\n expose:\n - \"27017\"\n kv:\n image: redis:alpine\n volumes:\n - redis-data:/data\n expose:\n - \"6379\"\n app:\n image: message-app:v0.2 # New version taking into account REDIS_URL\n ports:\n - \"8000:80\"\n links:\n - mongo\n depends_on:\n - mongo\n environment:\n - MONGO_URL=mongodb://mongo/messageApp\n - REDIS_URL=redis\nvolumes:\n mongo-data:\n redis-data:\n```\n\n[Previous](05_build_release_run.md) - [Next](07_port_binding.md)\n"
},
{
"path": "Docker/12factor/07_port_binding.md",
"content": "# 7 - Port binding\n\nThis factor is related to the exposition of the application to the outside.\n\nTo be compliant with 12 factor, an app must use specialized dependencies (such as http server, ...) and exposes its service through a port.\n\nThe host has the responsibility to route the request to the correct application through port mapping.\n\n## What does that mean for our application ?\n\nDocker already handles that for us, as we can see in the docker-compose file. The **app** container exposes port 80 internally and the host maps it against its port 8000.\n\n```\nversion: '3'\nservices:\n mongo:\n image: mongo:3.2\n volumes:\n - mongo-data:/data/db\n expose:\n - \"27017\"\n kv:\n image: redis:alpine\n volumes:\n - redis-data:/data\n expose:\n - \"6379\"\n app:\n image: message-app:v0.2 # New version taking into account REDIS_URL\n ports:\n - \"8000:80\" // app service is exposed on the port 8000 of the host\n links:\n - mongo\n depends_on:\n - mongo\n environment:\n - MONGO_URL=mongodb://mongo/messageApp\n - REDIS_URL=redis\nvolumes:\n mongo-data:\n redis-data:\n```\n\nIf several instances of the app services needs to be deployed, the configuration above cannot be used as a given port on the host cannot map several ports in the containers.\n\nIn this case, we can use a load balancer to which the host will map a port. The load balancer will then be in charge to balance the traffic on the different instances of the services. \n\n[Previous](06_processes.md) - [Next](08_concurrency.md)\n"
},
{
"path": "Docker/12factor/08_concurrency.md",
"content": "# 8 - Concurrency\n\nHorizontal scalability with the processes model.\n\nThe app can be seen as a set of processes of different types\n* web server\n* worker\n* cron\n\nEach process needs to be able to scale horizontally, it can have its own internal multiplexing.\n\n## What does that mean for our application ?\n\nThe messageApp only have one type of process (http server), it's doing the multiplexing using Node.js http server.\n\nThis process can be easily scalable (stateless process).\n\n[Previous](07_port_binding.md) - [Next](09_disposability.md)\n"
},
{
"path": "Docker/12factor/09_disposability.md",
"content": "# 9 - Disposability\n\nEach process of an application must be disposable.\n\n* it must have a quick startup\n * ease the horizontal scalability\n* it must ensure a clean shutdown\n * stop listening on the port\n * finish to handle the current request\n * usage of a queueing system for long lasting (worker type) process\n\n## What does that mean for our application ?\n\nOur application exposes HTTP endPoints that are easy and quick to handle. If we were to have some long lasting worker processes, the usage of a queueing system, like Apache Kafka, would be a great choice.\n\nKafka stores indexes of events processed by each worker. When a worker is restared, it can provide an index indicating at which point in time it needs to restart the event handling. Doing so no events are lost.\n\n[Docker Store](https://store.docker.com) offers several image of Kafka ([Spotify](https://store.docker.com/community/images/spotify/kafka), [Wurstmeister](https://store.docker.com/community/images/wurstmeister/kafka), ...) that can easily be integrated in the docker-compose file of the application.\n\nBelow is an example of how Kafka (and zookeeper) could be added to our docker-compose file. Of course, this means the application has been slightly changed to be able to write and read to/from Kafka.\n\n\n```\n# Kafka message broker\nzookeeper:\n image: wurstmeister/zookeeper\n ports:\n - \"2181:2181\"\nkafka:\n image: wurstmeister/kafka\n ports:\n - \"9092:9092\"\n links:\n - zookeeper:zk\n environment:\n KAFKA_ADVERTISED_HOST_NAME: 192.168.99.100\n KAFKA_CREATE_TOPICS: \"DATA:1:1\"\n volumes:\n - /var/run/docker.sock:/var/run/docker.sock\n```\n\n[Previous](08_concurrency.md) - [Next](10_dev_prod_parity.md)\n"
},
{
"path": "Docker/12factor/10_dev_prod_parity.md",
"content": "# 10 - Dev / Prod parity\n\nThe different environments must be as close as possible.\n\nDocker is very good at reducing the gap as the same services can be deployed on the developer machine as they could on any Docker Hosts.\n\nA lot of external services are available on the Docker Store and can be used in an existing application. Using those components enables a developer to use Postgres in development instead of SQLite or other lighter alternative. This reduces the risk of small differences that could show up later, when the app is on production.\n\nThis factor shows an orientation toward continuous deployment, where development can go from dev to production in a very short timeframe, thus avoiding the big bang effect at each release.\n\n\n## What does that mean for our application ?\n\nThe docker-compose file we built so far can be ran on the local machine or on any Docker Host. So Docker really shines at this level as it handles everything for us.\n\nThe exact same application can run on each environment.\n\n[Previous](09_disposability.md) - [Next](11_logs.md)\n"
},
{
"path": "Docker/12factor/11_logs.md",
"content": "# 11 - Logs\n\nLogs need to be handle as a timeseries of textual events\n\nThe application should not handle or save logs locally but must write them in stdout / stderr.\n\nA lot of services offer a centralized log management ([Elastic Stack / ELK](https://www.elastic.co/products) , [Splunk](http://splunk.com), [Logentries](https://logentries.com), ...), and most of them are very easily integrated with Docker.\n\nExample of Logentries dashboard:\n\n\n\n## What does that mean for our application ?\n\nIn order to centralize the logs, we can add a **log** service in our docker-compose file. The API token (provided by logentries) needs to be added to the service.\n\nAs we can see in the volume section, the Docker socket needs to be mounted so logentries container can retrieve each logs emitted by the running containers and send them to logentries external service.\n\n```\nlog:\n command: '-t XXXXXX-XXXXX-XXXXX-XXXXX'\n image: 'logentries/docker-logentries’\n restart: always\n volumes:\n - '/var/run/docker.sock:/var/run/docker.sock'\n```\n\n\n[Previous](10_dev_prod_parity.md) - [Next](12_admin_processes.md)\n"
},
{
"path": "Docker/12factor/12_admin_processes.md",
"content": "# 12 - Admin processes\n\nAdmin process should be seen as a one-off process (opposed to long running processes that make up an application).\n\nUsually used for maintenance task, though a REPL, admin process must be executed on the same release (codebase + configuration) than the application.\n\n## What does that mean for our application ?\n\nIn the docker-compose file we could define an admin service that is ran at the same time as the application and in which we could jump (`docker exec -ti ADMIN_CONTAINER_ID bash`) to execute some admin tasks. The container is able to access all the other containers of the application (provided it belongs to the same networks)\n\n[Previous](11_logs.md)\n"
},
{
"path": "Docker/12factor/README.md",
"content": "# 12 Factor Application\n\nToday, a lot of applications are services deployed in the cloud, on infrastructure of cloud providers such as Amazon AWS, Google Compute Engine, DigitalOcean, Rackspace, OVH, ...\n\nHeroku is PaaS (Platform as a Service) that relies on Amazon AWS and which makes the deployment of applications as easy as `git push heroku master` (ran from the root of your application).\n\nWith the huge number of applications deployed on Heroku, engineers of the company acquired a great knowledge of what should be done to get cloud native application.\n\n12 factor methodology is the result of their observations. As the name states, it presents 12 principles that will help application to be cloud ready, horizontally scalable, and portable.\n\n# Organisation of this lab\n\nIn this lab, we will start by building a simple Node.js application as an HTTP Rest API exposing CRUD (Create / Read / Update / Delete) verbs on a *message* model.\n\nHTTP verb | URI | Action\n----------| --- | ------\nGET | /message | list all messages\nGET | /message/ID | get message with ID\nPOST | /message | create a message user\nPUT | /message/ID | modify message with ID\nDELETE | /message/ID | delete message with ID\n\nWe will then follow each one of the 12 factor and see how this can leverage our application. At the same time, we will see that Docker is a really great fit for several of those factors.\n\n# Let's get started !\n\n[Build the application](00_application.md)\n\n[1 - Codebase](01_codebase.md)\n\n[2 - Dependencies](02_dependencies.md)\n\n[3 - Configuration](03_configuration.md)\n\n[4 - External services](04_external_services.md)\n\n[5 - Build / Release / Run](05_build_release_run.md)\n\n[6 - Processes](06_processes.md)\n\n[7 - Port binding](07_port_binding.md)\n\n[8 - Concurrency](08_concurrency.md)\n\n[9 - Disposability](09_disposability.md)\n\n[10 - Dev / Prod parity](10_dev_prod_parity.md)\n\n[11 - Logs](11_logs.md)\n\n[12 - Admin processes](12_admin_processes.md)\n\nDo not hesitate to provide comments / feedback you may have in order to improve this lab.\n"
},
{
"path": "Docker/Docker-Orchestration/readme.md",
"content": "## Advanced Docker Orchestration by Jérôme Petazzoni\n\n- [Slides](https://jpetazzo.github.io/orchestration-workshop)\n- [Orchestration Workshop](https://github.com/docker/orchestration-workshop)\n\n\n## Workshop Outline\n\n- Pre-requirements\n- VM environment\n- Our sample application\n- Running the application\n- Container port mapping\n- Identifying bottlenecks\n- Scaling HTTP on a single node\n- Put a load balancer on it\n- Connecting to containers on other hosts\n- Abstracting remote services with ambassadors\n- Various considerations about ambassadors\n- Docker for ops\n- Backups\n- Starting more containers from your container\n- Docker events stream\n- Attaching labels\n- Logs\n- Storing container logs in an ELK stack\n- Security upgrades\n- Network traffic analysis\n- Dynamic orchestration\n- Hands-on Swarm\n- Deploying Swarm\n- Cluster discovery\n- Resource allocation\n- Connecting containers with ambassadors\n- Setting up Consul and overlay networks\n- Multi-host networking\n- Building images with Swarm\n- Deploying a local registry\n- Scaling workers\n- Distributing Machine credentials\n- Highly available Swarm managers\n- Highly available containers\n- Conclusions\n"
},
{
"path": "Docker/README.md",
"content": "# Container, Cloud & DevOps Tutorials and Labs\n\n![\"56K.Cloud](\"../img/56k.jpg\")
\n\nThis repo contains [Docker](https://docker.com) labs and tutorials authored both by Docker and by members of the community. We welcome contributions and want to grow the repo.\n\n#### Docker Tutorials:\n\n- [Docker Kickstart](kickstart/readme.md)\n- [Docker Training DevOpsDays](DevOpsDays/readme.md)\n- [Docker Swarm Mode](swarm-mode/README.md)\n- [Docker Security](security/README.md)\n- [Docker Networking](networking/)\n\n#### Additional Docker Labs\n\nBe sure to check out the additional Docker resources section aimed at Developers.\n\n- [Docker Additional Resources](additional-ressources/)\n\n#### Contributing\n\nWe want to see this repo grow, so if you have a tutorial to submit or contributions to existing tutorials, please see this guide:\n\n[Guide to submitting your tutorial](./../contribute.md)\n"
},
{
"path": "Docker/additional-ressources/README.md",
"content": "# Additional Docker Ressources\n\nThis repo contains [Docker](https://docker.com) labs and tutorials, useful links, newsletters, and general Docker ressources. We welcome contributions and want to grow the repo.\n\n#### Useful Links\n\n* [Awesome Docker](http://veggiemonk.github.io/awesome-docker/)\n* [Docker Documentation](http://docs.docker.com)\n* [Docker Labs](https://github.com/docker/labs)\n* [Play-with-Docker](https://labs.play-with-docker.com)\n* [More Hands-On Docker Training](http://training.play-with-docker.com/alacart/)\n\n\n#### Newsletters\n\n* [Docker Newsletter](http://email.docker.com/ZJI6a09YT0000w0vp30KLFC)\n* [5 for Friday](http://brianchristner.us3.list-manage.com/track/click?u=fc0e7be4fb674995b89251efb&id=7205e15ac9&e=f62a500248)\n* [The New Stack](https://thenewstack.io)\n* [Sysdig](https://sysdig.com/blog)\n* []\n\n#### Useful Projects\n\n* [Brian Christner](www.github.com/vegasbrianc/prometheus)\n* [Cloud Native Foundation](https://www.cncf.io)\n* [Jess Frazzle](https://github.com/jessfraz/dockerfiles)\n* [Prometheus](prometheus.io)\n* [Traefik Proxy](https://traefik.io)\n* \n\n\n#### Docker Tutorials:\n* [Configuring developer tools and programming languages](developer-tools/README.md)\n * Java\n * [Live Debugging Java with Docker](developer-tools/java-debugging)\n * [Docker for Java Developers](developer-tools/java/)\n * Node.js\n * [Live Debugging a Node.js application in Docker](developer-tools/nodejs-debugging)\n * [Dockerizing a Node.js application](developer-tools/nodejs/porting/)\n* [Docker for ASP.NET and Windows containers](windows/readme.md)\n* [Building a 12 Factor app with Docker](12factor/README.md)\n* [Hands-on Labs from DockerCon US 2017](dockercon-us-2017/)\n"
},
{
"path": "Docker/additional-ressources/developer-tools/README.md",
"content": "# Developer Tools Tutorials\n\nThis directory contains tutorials on how to set-up and use common developer tools and programming languages with Docker. We encourage you to [contribute](../contribute.md) your own tutorials here.\n\n## IDEs\n\nWith the introduction of [Docker for Mac](https://www.docker.com/products/docker#/mac) and [Docker for Windows](https://www.docker.com/products/docker#/windows), developers on those platforms got to use a feature that developers on [Docker for Linux](https://www.docker.com/products/docker#linux) had all along: in-container development. With improvements in volume management, Docker is able to detect when code in a volume changes, and update the code in the container. That means you get features like live debugging in a running container, without having to rebuild the container.\n\nYou can also have all your dependencies in a container. All you need is Docker and something to edit your source files on your machine, and you're good to go. That means you can, for instance, debug Node.js in your container without having Node.js on your local machine.\n\nIn order to take advantage of this feature in an IDE, there is some set-up required as there is for any project. The following sections describe how to configure different languages and IDEs to do in-container development.\n\n### [Java Developer Tools](https://github.com/docker/labs/tree/master/developer-tools/java-debugging) including:\n+ Eclipse\n+ IntelliJ\n+ Netbeans\n\n### [Node.js Developer Tools](https://github.com/docker/labs/blob/master/developer-tools/nodejs-debugging/README.md) including:\n+ Visual Studio Code\n\n## Programming languages\nThis is a more comprehensive section detailing how to set-up and optimize your experience using Docker with particular programming languages.\n\n+ [Java](java/)\n+ [Node.js](nodejs/porting/)\n"
},
{
"path": "Docker/additional-ressources/developer-tools/README_es.md",
"content": "# Tutoriales de Herramientas de Desarrollo\n\nEste directorio contiene tutoriales sobre como configurar y usar herramientas de desarrollo comunes con docker. Te animamos a [contribuir](../contribute.md) con tus propios tutoriales aquí.\n\n## IDEs\n\nCon la introducción de [Docker for Mac](https://www.docker.com/products/docker#/mac) y [Docker for Windows](https://www.docker.com/products/docker#/windows), los desarrolladores pueden ahora desarrollar dentro del contenedor de la misma manera que lo hacen los usuarios que utilizan [Docker for Linux](https://www.docker.com/products/docker#linux). Con mejoras en la administración de volúmenes, Docker permite detectar cuando el código en los volúmenes cambia, y actualizar el código en el contenedor. Esto significa que ahora es posible depurar un contenedor en vivo que se encuentra en ejecución, sin tener que reconstruir el contenedor.\n\n### [Herramientas de Desarrollo Java](https://github.com/docker/labs/tree/master/developer-tools/java-debugging) incluye:\n+ Eclipse\n+ IntelliJ\n+ Netbeans\n"
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/appa-common-commands.adoc",
"content": "[appendix]\n[[Common_Docker_Commands]]\n== Common Docker Commands\n\nHere is the list of commonly used Docker commands:\n\n[width=\"100%\", options=\"header\"]\n|==================\n| Purpose| Command\n2+^s| Image\n| Build an image| `docker image build --rm=true .`\n| Install an image | `docker image pull ${IMAGE}`\n| List of installed images | `docker image ls`\n| List of installed images (detailed listing) | `docker image ls --no-trunc`\n| Remove an image | `docker image rm ${IMAGE_ID}`\n| Remove unused images | `docker image prune`\n| Remove all images | `docker image rm $(docker image ls -aq)`\n2+^s| Containers\n| Run a container | `docker container run`\n| List of running containers | `docker container ls`\n| List of all containers | `docker container ls -a`\n| Stop a container | `docker container stop ${CID}`\n| Stop all running containers | `docker container stop $(docker container ls -q)`\n| List all exited containers with status 1 | `docker container ls -a --filter \"exited=1\"`\n| Remove a container | `docker container rm ${CID}`\n| Remove container by a regular expression | `docker container ls -a \\| grep wildfly \\| awk '{print $1}' \\| xargs docker container rm -f`\n| Remove all exited containers | `docker container rm -f $(docker container ls -a \\| grep Exit \\| awk '{ print $1 }')`\n| Remove all containers | `docker container rm $(docker container ls -aq)`\n| Find IP address of the container | `docker container inspect --format '{{ .NetworkSettings.IPAddress }}' ${CID}`\n| Attach to a container | `docker container attach ${CID}`\n| Open a shell in to a container | `docker container \texec -it ${CID} bash`\n| Get container id for an image by a regular expression | `docker container ls \\| grep wildfly \\| awk '{print $1}'`\n|==================\n\n=== Exit code status\n\nThe exit code from `docker run` gives information about why the container failed to run or why it exited. The complete list of code is listed:\n\nhttps://docs.docker.com/engine/reference/run/#exit-status\n\nAll other codes are the exit code of the command running in the container."
},
{
"path": "Docker/additional-ressources/developer-tools/java/chapters/appb-troubleshooting.adoc",
"content": "[appendix]\n[[Troubleshooting]]\n\n== Troubleshooting Docker\n\n=== Network Timed Out\n\nDepending upon the network speed and restrictions, you may not be able to download Docker images from Docker Store. The error message may look like:\n\n```console\n$ docker pull arungupta/wildfly-mysql-javaee7\nUsing default tag: latest\nPulling repository docker.io/arungupta/wildfly-mysql-javaee7\nNetwork timed out while trying to connect to https://index.docker.io/v1/repositories/arungupta/wildfly-mysql-javaee7/images. You may want to check your internet connection or if you are behind a proxy.\n```\n\nThis section provide a couple of alternatives to solve this.\n\n==== Restart Docker Machine\n\nIt seems like Docker Machine gets into a strange state and restarting it fixes that.\n\n```console\ndocker-machine restart