🔖 Prepare to release 1.0.0-alpha2

brazil-data-cube · Sep 1, 2022 · f2607c9 · f2607c9
1 parent 695421c
commit f2607c9
Show file tree

Hide file tree

Showing 3 changed files with 31 additions and 3 deletions.
diff --git a/CHANGES.rst b/CHANGES.rst
@@ -11,8 +11,15 @@ Changes
 =======
 
 
+Version 1.0.0-alpha2 (2022-09-01)
+---------------------------------
+
+- Fix documentation RUNNING.rst
+- Fix migration conflict with LCCS-DB instance `#169 <https://github.com/brazil-data-cube/bdc-catalog/issues/169>`_.
+
+
 Version 1.0.0-alpha1 (2022-07-21)
---------------------------
+---------------------------------
 
 - Add authorization control to items `#78 <https://github.com/brazil-data-cube/bdc-catalog/issues/78>`_.
 - Review JSONSchemas for collection metadata - instrument key `#68 <https://github.com/brazil-data-cube/bdc-catalog/issues/68>`_.

diff --git a/RUNNING.rst b/RUNNING.rst
@@ -1,6 +1,6 @@
 ..
     This file is part of BDC-Catalog.
-    Copyright (C) 2019-2020 INPE.
+    Copyright (C) 2019-2022 INPE.
 
     BDC-Catalog is free software; you can redistribute it and/or modify it
     under the terms of the MIT License; see LICENSE file for more details.
@@ -9,6 +9,27 @@
 Running BDC-Catalog in the Command Line
 =======================================
 
+The Brazil Data Cube Catalog system uses the `Alembic Environment <https://alembic.sqlalchemy.org/en/latest/>`_
+to upgrade/downgrade versions. If you would like to use it as experimental environments (dev only), you may consider to follow
+`Development Mode`.
+
+For production environment, we strongly recommend you to adopt alembic migration way to be able to support improvements.
+
+
+Development Mode
+----------------
+
+**This step is not recommended for production environments. It will not generate alembic migration tree.**
+
+For development purposes, we have prepared a command line `bdc-db db create-schema` to create all definitions for BDC-Catalog::
+
+        export SQLALCHEMY_DATABASE_URI="postgresql://postgres:password@localhost:5432/bdcdb"
+        bdc-db db init
+        bdc-db db create-namespaces
+        bdc-db db create-extension-postgis
+        lccs-db db create-extension-hstore
+        bdc-db db create-schema
+
 
 Creating database definition
 ----------------------------

diff --git a/bdc_catalog/version.py b/bdc_catalog/version.py
@@ -9,4 +9,4 @@
 """Version information for BDC-Catalog."""
 
 
-__version__ = '1.0.0-alpha1'
+__version__ = '1.0.0-alpha2'