{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "How to start a Pod\n",
    "==================\n",
    "\n",
    "In this notebook, we show you how to create a single container Pod.\n",
    "\n",
    "Start by importing the Kubernetes module\n",
    "-----------------------------------------"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "from kubernetes import client, config"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If you are using a proxy, you can use the _client Configuration_ to setup the host that the client should use. Otherwise read the kubeconfig file."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "config.load_incluster_config()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Pods are a stable resource in the V1 API group. Instantiate a client for that API group endpoint."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "v1=client.CoreV1Api()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "collapsed": false,
    "scrolled": false
   },
   "outputs": [],
   "source": [
    "pod=client.V1Pod()\n",
    "spec=client.V1PodSpec()\n",
    "pod.metadata=client.V1ObjectMeta(name=\"busybox\")\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In this example, we only start one container in the Pod. The container is an instnace of the _V1Container_ class. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "container=client.V1Container()\n",
    "container.image=\"busybox\"\n",
    "container.args=[\"sleep\", \"3600\"]\n",
    "container.name=\"busybox\""
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The specification of the Pod is made of a single container in its list."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "spec.containers = [container]\n",
    "pod.spec = spec"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Get existing list of Pods, before the creation of the new Pod."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "172.17.0.6  default  jupyter\n"
     ]
    }
   ],
   "source": [
    "ret = v1.list_namespaced_pod(namespace=\"default\")\n",
    "for i in ret.items:\n",
    "    print(\"%s  %s  %s\" % (i.status.pod_ip, i.metadata.namespace, i.metadata.name))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You are now ready to create the Pod."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'metadata': {'annotations': None,\n",
       "              'cluster_name': None,\n",
       "              'creation_timestamp': u'2017-04-01T23:30:48Z',\n",
       "              'deletion_grace_period_seconds': None,\n",
       "              'deletion_timestamp': None,\n",
       "              'finalizers': None,\n",
       "              'generate_name': None,\n",
       "              'generation': None,\n",
       "              'labels': None,\n",
       "              'name': 'busybox',\n",
       "              'namespace': 'default',\n",
       "              'owner_references': None,\n",
       "              'resource_version': '26551',\n",
       "              'self_link': '/api/v1/namespaces/default/pods/busybox',\n",
       "              'uid': '3c6a0821-1733-11e7-877c-0800277d3a21'},\n",
       " 'spec': {'active_deadline_seconds': None,\n",
       "          'containers': [{'args': ['sleep', '3600'],\n",
       "                          'command': None,\n",
       "                          'env': None,\n",
       "                          'image': 'busybox',\n",
       "                          'image_pull_policy': 'Always',\n",
       "                          'lifecycle': None,\n",
       "                          'liveness_probe': None,\n",
       "                          'name': 'busybox',\n",
       "                          'ports': None,\n",
       "                          'readiness_probe': None,\n",
       "                          'resources': {'limits': None, 'requests': None},\n",
       "                          'security_context': None,\n",
       "                          'stdin': None,\n",
       "                          'stdin_once': None,\n",
       "                          'termination_message_path': '/dev/termination-log',\n",
       "                          'tty': None,\n",
       "                          'volume_mounts': [{'mount_path': '/var/run/secrets/kubernetes.io/serviceaccount',\n",
       "                                             'name': 'default-token-x47xb',\n",
       "                                             'read_only': True,\n",
       "                                             'sub_path': None}],\n",
       "                          'working_dir': None}],\n",
       "          'dns_policy': 'ClusterFirst',\n",
       "          'host_ipc': None,\n",
       "          'host_network': None,\n",
       "          'host_pid': None,\n",
       "          'hostname': None,\n",
       "          'image_pull_secrets': None,\n",
       "          'node_name': None,\n",
       "          'node_selector': None,\n",
       "          'restart_policy': 'Always',\n",
       "          'security_context': {'fs_group': None,\n",
       "                               'run_as_non_root': None,\n",
       "                               'run_as_user': None,\n",
       "                               'se_linux_options': None,\n",
       "                               'supplemental_groups': None},\n",
       "          'service_account': 'default',\n",
       "          'service_account_name': 'default',\n",
       "          'subdomain': None,\n",
       "          'termination_grace_period_seconds': 30,\n",
       "          'volumes': [{'name': 'default-token-x47xb'}]},\n",
       " 'status': {'conditions': None,\n",
       "            'container_statuses': None,\n",
       "            'host_ip': None,\n",
       "            'message': None,\n",
       "            'phase': 'Pending',\n",
       "            'pod_ip': None,\n",
       "            'reason': None,\n",
       "            'start_time': None}}"
      ]
     },
     "execution_count": 8,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "v1.create_namespaced_pod(namespace=\"default\",body=pod)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Get list of Pods, after the creation of the new Pod. Note the newly created pod with name \"busybox\""
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "None  default  busybox\n",
      "172.17.0.6  default  jupyter\n"
     ]
    }
   ],
   "source": [
    "ret = v1.list_namespaced_pod(namespace=\"default\")\n",
    "for i in ret.items:\n",
    "    print(\"%s  %s  %s\" % (i.status.pod_ip, i.metadata.namespace, i.metadata.name))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Delete the Pod\n",
    "--------------\n",
    "\n",
    "You refer to the Pod by name, you need to add its namespace and pass some _delete_ options."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "collapsed": false,
    "scrolled": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'code': None,\n",
       " 'details': None,\n",
       " 'message': None,\n",
       " 'metadata': {'resource_version': '26556',\n",
       "              'self_link': '/api/v1/namespaces/default/pods/busybox'},\n",
       " 'reason': None,\n",
       " 'status': \"{u'phase': u'Pending', u'conditions': [{u'status': u'True', u'lastProbeTime': None, u'type': u'Initialized', u'lastTransitionTime': u'2017-04-01T23:30:48Z'}, {u'status': u'False', u'lastTransitionTime': u'2017-04-01T23:30:48Z', u'reason': u'ContainersNotReady', u'lastProbeTime': None, u'message': u'containers with unready status: [busybox]', u'type': u'Ready'}, {u'status': u'True', u'lastProbeTime': None, u'type': u'PodScheduled', u'lastTransitionTime': u'2017-04-01T23:30:48Z'}], u'containerStatuses': [{u'restartCount': 0, u'name': u'busybox', u'image': u'busybox', u'imageID': u'', u'state': {u'waiting': {u'reason': u'ContainerCreating'}}, u'ready': False, u'lastState': {}}], u'startTime': u'2017-04-01T23:30:48Z', u'hostIP': u'192.168.99.100'}\"}"
      ]
     },
     "execution_count": 10,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "v1.delete_namespaced_pod(name=\"busybox\", namespace=\"default\", body=client.V1DeleteOptions())"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 2",
   "language": "python",
   "name": "python2"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 2
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython2",
   "version": "2.7.12"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}