Merge pull request #33 from javacruft/rename-to-openstack

Rename snap from microstack to openstack
This commit is contained in:
James Page 2018-11-13 14:13:54 +00:00 committed by GitHub
commit 36f20aaee3
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 27 additions and 27 deletions

View File

@ -1,32 +1,32 @@
# microstack # openstack
[![Snap Status](https://build.snapcraft.io/badge/CanonicalLtd/microstack.svg)](https://build.snapcraft.io/user/CanonicalLtd/microstack) [![Snap Status](https://build.snapcraft.io/badge/CanonicalLtd/openstack.svg)](https://build.snapcraft.io/user/CanonicalLtd/openstack)
OpenStack in a snap that you can run locally on a single machine! OpenStack in a snap that you can run locally on a single machine!
`microstack` currently provides Nova, Keystone, Glance, Horizon and Neutron OpenStack services. `openstack` currently provides Nova, Keystone, Glance, Horizon and Neutron OpenStack services.
## Installation ## 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: `openstack` 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 `openstack` using:
``` ```
sudo snap install microstack --classic --edge sudo snap install openstack --classic --edge
``` ```
## Accessing OpenStack ## Accessing OpenStack
`microstack` provides a pre-configured OpenStack CLI to access the local OpenStack deployment; its namespaced using the `microstack` prefix: `openstack` provides a pre-configured OpenStack CLI to access the local OpenStack deployment; its namespaced using the `openstack` prefix:
``` ```
microstack.openstack server list openstack.openstack server list
``` ```
You can setup this command as an alias for `openstack` if you wish (removing the need for the `microstack.` prefix): You can setup this command as an alias for `openstack` if you wish (removing the need for the `openstack.` prefix):
``` ```
sudo snap alias microstack.openstack openstack sudo snap alias openstack.openstack openstack
``` ```
Alternatively you can access the Horizon OpenStack dashboard on `http://127.0.0.1` with the following credentials: Alternatively you can access the Horizon OpenStack dashboard on `http://127.0.0.1` with the following credentials:
@ -38,25 +38,25 @@ password: keystone
## Booting and accessing an instance ## 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: `openstack` comes preconfigured with networking and images so you can get starting using OpenStack as soon as `openstack` is installed; to boot an instance:
``` ```
microstack.openstack server create --flavor m1.small --nic net-id=test --image cirros my-microstack-server openstack.openstack server create --flavor m1.small --nic net-id=test --image cirros my-openstack-server
``` ```
To access the instance, you'll need to assign it a floating IP address: 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=`openstack.openstack floating ip create -f value -c floating_ip_address external`
microstack.openstack server add floating ip my-microstack-server $ALLOCATED_FIP openstack.openstack server add floating ip my-openstack-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: and as you would expect, `openstack` 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` SECGROUP_ID=`openstack.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 openstack.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 openstack.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: once this is complete you should be able to SSH to the instance:
@ -65,20 +65,20 @@ once this is complete you should be able to SSH to the instance:
ssh cirros@$ALLOCATED_FIP ssh cirros@$ALLOCATED_FIP
``` ```
Happy `microstack`ing! Happy `openstack`ing!
## Stopping and starting microstack ## Stopping and starting openstack
You may wish to temporarily shutdown microstack when not in use without un-installing it. You may wish to temporarily shutdown openstack when not in use without un-installing it.
`microstack` can be shutdown using: `openstack` can be shutdown using:
``` ```
sudo snap disable microstack sudo snap disable openstack
``` ```
and re-enabled latest using: and re-enabled latest using:
``` ```
sudo snap enable microstack sudo snap enable openstack
``` ```

View File

@ -1,4 +1,4 @@
name: microstack name: openstack
version: rocky version: rocky
summary: OpenStack on your laptop. summary: OpenStack on your laptop.
description: | description: |
@ -611,7 +611,7 @@ parts:
# required to ensure that pathing to files etc works at # required to ensure that pathing to files etc works at
# runtime # runtime
# * is not used to avoid directory merge conflicts # * is not used to avoid directory merge conflicts
snap/microstack/current/: ./ snap/openstack/current/: ./
kvm-support: kvm-support:
plugin: nil plugin: nil
@ -689,7 +689,7 @@ parts:
# required to ensure that pathing to files etc works at # required to ensure that pathing to files etc works at
# runtime # runtime
# * is not used to avoid directory merge conflicts # * is not used to avoid directory merge conflicts
snap/microstack/current/: ./ snap/openstack/current/: ./
# MySQL # MySQL
mysql-server: mysql-server:
@ -770,7 +770,7 @@ parts:
# required to ensure that pathing to files etc works at # required to ensure that pathing to files etc works at
# runtime # runtime
# * is not used to avoid directory merge conflicts # * is not used to avoid directory merge conflicts
snap/microstack/current/: ./ snap/openstack/current/: ./
ipset: ipset:
source: http://ipset.netfilter.org/ipset-6.30.tar.bz2 source: http://ipset.netfilter.org/ipset-6.30.tar.bz2