From 889805c5d2a0d60ce84189f7063987f4bba44232 Mon Sep 17 00:00:00 2001 From: James Page Date: Mon, 12 Nov 2018 10:07:10 +0000 Subject: [PATCH 1/3] Misc updates to readme including a basic boot and access section --- README.md | 54 +++++++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 43 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 123250c..f8cac2d 100644 --- a/README.md +++ b/README.md @@ -2,9 +2,11 @@ [![Snap Status](https://build.snapcraft.io/badge/CanonicalLtd/microstack.svg)](https://build.snapcraft.io/user/CanonicalLtd/microstack) -OpenStack in a snap that you can run locally. +OpenStack in a snap that you can run locally on a single machine! -## User Guide +`microstack` currently provides Nova, Keystone, Glance and Neutron OpenStack services. + +## Installation `microstack` is frequently updated to provide the latest stable updates of the most recent OpenStack release. The quickest was to get started is to install directly from the snap store. You can install `microstack` using: @@ -12,27 +14,57 @@ OpenStack in a snap that you can run locally. sudo snap install microstack --classic --edge ``` -Once the snap is installed, you need to perform a one off configuration process: - -``` -sudo microstack.configure -``` - -This will initialize all OpenStack services, configure access, network and an image to use on the local OpenStack deployment. ## Accessing OpenStack -`microstack` provides a pre-configured OpenStack CLI to access the local OpenStack deployment; its namespace using the `microstack` prefix: +`microstack` provides a pre-configured OpenStack CLI to access the local OpenStack deployment; its namespaced using the `microstack` prefix: ``` microstack.openstack server list ``` +You can setup this command as an alias for `openstack` if you wish (removing the need for the `microstack.` prefix): + +``` +sudo snap alias microstack.openstack openstack +``` + +## Booting and accessing an instance + +`microstack` comes preconfigured with networking and images so you can get starting using OpenStack as soon as `microstack` is installed; to boot an instance: + +``` +microstack.openstack server create --flavor m1.small --nic net-id=test --image cirros my-microstack-server +``` + +To access the instance, you'll need to assign it a floating IP address: + +``` +ALLOCATED_FIP=`microstack.openstack floating ip create -f value -c floating_ip_address external` +microstack.openstack server add floating ip my-microstack-server $ALLOCATED_FIP +``` + +and as you would expect, `microstack` is just like a full OpenStack Cloud and does not allow ingress access to the instance by default, so next enable SSH and ping access to the instance: + +``` +SECGROUP_ID=`microstack.openstack security group list --project admin -f value -c ID` +microstack.openstack security group rule create $SECGROUP_ID --proto tcp --remote-ip 0.0.0.0/0 --dst-port 22 +microstack.openstack security group rule create $SECGROUP_ID --proto icmp --remote-ip 0.0.0.0/0 +``` + +once this is complete you should be able to SSH to the instance: + +``` +ssh cirros@$ALLOCATED_FIP +``` + +Happy `microstack`ing! + ## Stopping and starting microstack You may wish to temporarily shutdown microstack when not in use without un-installing it. -microstack can be shutdown using: +`microstack` can be shutdown using: ``` sudo snap disable microstack From fbb9395801300bd59262b672621122a5916ec666 Mon Sep 17 00:00:00 2001 From: James Page Date: Mon, 12 Nov 2018 10:09:24 +0000 Subject: [PATCH 2/3] Add part for accessing Horizon as well --- 1 | 84 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 11 ++++++-- 2 files changed, 93 insertions(+), 2 deletions(-) create mode 100644 1 diff --git a/1 b/1 new file mode 100644 index 0000000..971d8ca --- /dev/null +++ b/1 @@ -0,0 +1,84 @@ +# microstack + +[![Snap Status](https://build.snapcraft.io/badge/CanonicalLtd/microstack.svg)](https://build.snapcraft.io/user/CanonicalLtd/microstack) + +OpenStack in a snap that you can run locally on a single machine! + +`microstack` currently provides Nova, Keystone, Glance, Horizon and Neutron OpenStack services. + +## Installation + +`microstack` is frequently updated to provide the latest stable updates of the most recent OpenStack release. The quickest was to get started is to install directly from the snap store. You can install `microstack` using: + +``` +sudo snap install microstack --classic --edge +``` + + +## Accessing OpenStack + +`microstack` provides a pre-configured OpenStack CLI to access the local OpenStack deployment; its namespaced using the `microstack` prefix: + +``` +microstack.openstack server list +``` + +You can setup this command as an alias for `openstack` if you wish (removing the need for the `microstack.` prefix): + +``` +sudo snap alias microstack.openstack openstack +``` + +Alternatively you can access the Horizon OpenStack dashboard on `http://127.0.0.1` with the following credentials: + +``` +username: admin +password: keystone +``` + +## Booting and accessing an instance + +`microstack` comes preconfigured with networking and images so you can get starting using OpenStack as soon as `microstack` is installed; to boot an instance: + +``` +microstack.openstack server create --flavor m1.small --nic net-id=test --image cirros my-microstack-server +``` + +To access the instance, you'll need to assign it a floating IP address: + +``` +ALLOCATED_FIP=`microstack.openstack floating ip create -f value -c floating_ip_address external` +microstack.openstack server add floating ip my-microstack-server $ALLOCATED_FIP +``` + +and as you would expect, `microstack` is just like a full OpenStack Cloud and does not allow ingress access to the instance by default, so next enable SSH and ping access to the instance: + +``` +SECGROUP_ID=`microstack.openstack security group list --project admin -f value -c ID` +microstack.openstack security group rule create $SECGROUP_ID --proto tcp --remote-ip 0.0.0.0/0 --dst-port 22 +microstack.openstack security group rule create $SECGROUP_ID --proto icmp --remote-ip 0.0.0.0/0 +``` + +once this is complete you should be able to SSH to the instance: + +``` +ssh cirros@$ALLOCATED_FIP +``` + +Happy `microstack`ing! + +## Stopping and starting microstack + +You may wish to temporarily shutdown microstack when not in use without un-installing it. + +`microstack` can be shutdown using: + +``` +sudo snap disable microstack +``` + +and re-enabled latest using: + +``` +sudo snap enable microstack +``` diff --git a/README.md b/README.md index f8cac2d..971d8ca 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ OpenStack in a snap that you can run locally on a single machine! -`microstack` currently provides Nova, Keystone, Glance and Neutron OpenStack services. +`microstack` currently provides Nova, Keystone, Glance, Horizon and Neutron OpenStack services. ## Installation @@ -29,6 +29,13 @@ You can setup this command as an alias for `openstack` if you wish (removing the sudo snap alias microstack.openstack openstack ``` +Alternatively you can access the Horizon OpenStack dashboard on `http://127.0.0.1` with the following credentials: + +``` +username: admin +password: keystone +``` + ## Booting and accessing an instance `microstack` comes preconfigured with networking and images so you can get starting using OpenStack as soon as `microstack` is installed; to boot an instance: @@ -40,7 +47,7 @@ microstack.openstack server create --flavor m1.small --nic net-id=test --image c To access the instance, you'll need to assign it a floating IP address: ``` -ALLOCATED_FIP=`microstack.openstack floating ip create -f value -c floating_ip_address external` +ALLOCATED_FIP=`microstack.openstack floating ip create -f value -c floating_ip_address external` microstack.openstack server add floating ip my-microstack-server $ALLOCATED_FIP ``` From bf8885a7d3d4ea05cbaf793098f39f0c33d49bc0 Mon Sep 17 00:00:00 2001 From: James Page Date: Mon, 12 Nov 2018 10:09:36 +0000 Subject: [PATCH 3/3] Drop 1 doh --- 1 | 84 --------------------------------------------------------------- 1 file changed, 84 deletions(-) delete mode 100644 1 diff --git a/1 b/1 deleted file mode 100644 index 971d8ca..0000000 --- a/1 +++ /dev/null @@ -1,84 +0,0 @@ -# microstack - -[![Snap Status](https://build.snapcraft.io/badge/CanonicalLtd/microstack.svg)](https://build.snapcraft.io/user/CanonicalLtd/microstack) - -OpenStack in a snap that you can run locally on a single machine! - -`microstack` currently provides Nova, Keystone, Glance, Horizon and Neutron OpenStack services. - -## Installation - -`microstack` is frequently updated to provide the latest stable updates of the most recent OpenStack release. The quickest was to get started is to install directly from the snap store. You can install `microstack` using: - -``` -sudo snap install microstack --classic --edge -``` - - -## Accessing OpenStack - -`microstack` provides a pre-configured OpenStack CLI to access the local OpenStack deployment; its namespaced using the `microstack` prefix: - -``` -microstack.openstack server list -``` - -You can setup this command as an alias for `openstack` if you wish (removing the need for the `microstack.` prefix): - -``` -sudo snap alias microstack.openstack openstack -``` - -Alternatively you can access the Horizon OpenStack dashboard on `http://127.0.0.1` with the following credentials: - -``` -username: admin -password: keystone -``` - -## Booting and accessing an instance - -`microstack` comes preconfigured with networking and images so you can get starting using OpenStack as soon as `microstack` is installed; to boot an instance: - -``` -microstack.openstack server create --flavor m1.small --nic net-id=test --image cirros my-microstack-server -``` - -To access the instance, you'll need to assign it a floating IP address: - -``` -ALLOCATED_FIP=`microstack.openstack floating ip create -f value -c floating_ip_address external` -microstack.openstack server add floating ip my-microstack-server $ALLOCATED_FIP -``` - -and as you would expect, `microstack` is just like a full OpenStack Cloud and does not allow ingress access to the instance by default, so next enable SSH and ping access to the instance: - -``` -SECGROUP_ID=`microstack.openstack security group list --project admin -f value -c ID` -microstack.openstack security group rule create $SECGROUP_ID --proto tcp --remote-ip 0.0.0.0/0 --dst-port 22 -microstack.openstack security group rule create $SECGROUP_ID --proto icmp --remote-ip 0.0.0.0/0 -``` - -once this is complete you should be able to SSH to the instance: - -``` -ssh cirros@$ALLOCATED_FIP -``` - -Happy `microstack`ing! - -## Stopping and starting microstack - -You may wish to temporarily shutdown microstack when not in use without un-installing it. - -`microstack` can be shutdown using: - -``` -sudo snap disable microstack -``` - -and re-enabled latest using: - -``` -sudo snap enable microstack -```