You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2023/01/05 16:41:47 UTC
[isis] branch ISIS-3255 updated (67c85ddcf4 -> 7a6178a9ed)
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a change to branch ISIS-3255
in repository https://gitbox.apache.org/repos/asf/isis.git
omit 67c85ddcf4 ISIS-3255: improves index.html a tiny bit
omit 3a833f2ded ISIS-3255: fixes up docs
omit dfcff1b5c0 ISIS-3255: updates references to starter and demo apps to new deployment locations under causeway.dev
omit 2cfe78feac ISIS-3255: adds docs for setting up the other apps
omit 40c7de2e34 ISIS-3255: updates docs on letsencrypt with ACA
omit 39215d3440 ISIS-3255: adds docs on using ACA to host nightlies
omit 0289e6bf92 ISIS-3255: updates index.html with warning re: Windows classpath length limits
add 08091428cb Bump dependency-check-maven from 7.4.1 to 7.4.3
add fad6d11096 Merge pull request #1309 from apache/dependabot/maven/master/org.owasp-dependency-check-maven-7.4.3
add 77deb22dd8 Bump error_prone_annotations from 2.16 to 2.17.0
add cf9c91c9e2 Merge pull request #1313 from apache/dependabot/maven/master/com.google.errorprone-error_prone_annotations-2.17.0
add 42e73097c8 Bump easymock from 5.0.1 to 5.1.0
add a7f16e3c88 Merge pull request #1316 from apache/dependabot/maven/master/org.easymock-easymock-5.1.0
add 036e7a4403 Bump vaadin.version from 23.3.1 to 23.3.2
add e58d393d6a Merge pull request #1307 from apache/dependabot/maven/master/vaadin.version-23.3.2
add 1a46614f65 Bump javaparser-core from 3.24.9 to 3.24.10
add ebae7b9097 Merge pull request #1314 from apache/dependabot/maven/master/com.github.javaparser-javaparser-core-3.24.10
add 34a3e2b599 Bump maven-model-builder from 3.8.6 to 3.8.7
add 99d278261a Merge pull request #1315 from apache/dependabot/maven/master/org.apache.maven-maven-model-builder-3.8.7
add 7fb94aa612 Bump maven-jaxb2-plugin from 0.15.1 to 0.15.2
add 7a65fd6de2 Merge pull request #1310 from apache/dependabot/maven/master/org.jvnet.jaxb2.maven2-maven-jaxb2-plugin-0.15.2
add a28f7f38b9 ISIS-3317: CSS navbar link color fix
add c99038bbb5 ISIS-3317: flatly CSS Navbar Font Color fixes
new 479c0d9032 ISIS-3255: updates index.html with warning re: Windows classpath length limits
new fac142c539 ISIS-3255: adds docs on using ACA to host nightlies
new 46a693751c ISIS-3255: updates docs on letsencrypt with ACA
new f7de4dae59 ISIS-3255: adds docs for setting up the other apps
new 4d27289597 ISIS-3255: updates references to starter and demo apps to new deployment locations under causeway.dev
new 8e54f8a314 ISIS-3255: fixes up docs
new 7a6178a9ed ISIS-3255: improves index.html a tiny bit
This update added new revisions after undoing existing revisions.
That is to say, some revisions that were in the old version of the
branch are not in the new version. This situation occurs
when a user --force pushes a change and generates a repository
containing something like this:
* -- * -- B -- O -- O -- O (67c85ddcf4)
\
N -- N -- N refs/heads/ISIS-3255 (7a6178a9ed)
You should already have received notification emails for all of the O
revisions, and so the following emails describe only the N revisions
from the common base, B.
Any revisions marked "omit" are not gone; other references still
refer to them. Any revisions marked "discard" are gone forever.
The 7 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
api/schema/pom.xml | 2 +-
bom/pom.xml | 8 ++++----
core/pom.xml | 2 +-
tooling/javamodel/pom.xml | 2 +-
tooling/pom.xml | 2 +-
.../ui/pages/common/bootstrap/css/bootstrap-overrides-all-v2.css | 3 +--
.../ui/pages/common/bootstrap/css/bootstrap-overrides-flatly.css | 6 +++---
7 files changed, 12 insertions(+), 13 deletions(-)
[isis] 04/07: ISIS-3255: adds docs for setting up the other apps
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch ISIS-3255
in repository https://gitbox.apache.org/repos/asf/isis.git
commit f7de4dae593b71f3aec977cfe9aaf92a7ec3a8f6
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Wed Jan 4 10:47:38 2023 +0000
ISIS-3255: adds docs for setting up the other apps
---
.../conguide/modules/nightlies/pages/about.adoc | 448 ++++++++++++++++++++-
1 file changed, 436 insertions(+), 12 deletions(-)
diff --git a/antora/components/conguide/modules/nightlies/pages/about.adoc b/antora/components/conguide/modules/nightlies/pages/about.adoc
index 5db1b649ee..39fbecf01f 100644
--- a/antora/components/conguide/modules/nightlies/pages/about.adoc
+++ b/antora/components/conguide/modules/nightlies/pages/about.adoc
@@ -152,10 +152,10 @@ Container Apps environment created. To deploy a container app, use: az container
----
-=== Create container apps
+== Create Container App
We will create a container app manually.
-In the <<#automation,automation (below)>>, we will simply update the container (replacing the image with a new one).
+Later, in the <<#automation,automation>> section, we will simply update the container (replacing the image with a new one).
We'll start with the link:https://hub.docker.com/repository/docker/apacheisis/demo-wicket-jpa[apacheisis/demo-wicket-jpa] Docker image:
@@ -165,7 +165,7 @@ We'll start with the link:https://hub.docker.com/repository/docker/apacheisis/de
----
APP_NAME="demo-wicket-jpa"
IMAGE_NAME="apacheisis/demo-wicket-jpa"
-IMAGE_VERSION="2.0.0-M9.20221224-0226-7c658a3c"
+IMAGE_VERSION="2.0.0-M9.20221018-1911-d3980668"
----
* create the app
@@ -194,7 +194,7 @@ Container app created. Access your app at https://demo-wicket-jpa.graytree-90c75
image::image-2023-01-03-08-31-58-018.png[width=600]
-== Lets Encrypt
+== Use Lets Encrypt for SSL Certs
as per: link:https://dev.to/shibayan/how-to-quickly-setup-a-lets-encrypt-certificate-in-azure-container-apps-3nd7[this blog post] blog, the link:https://github.com/shibayan/containerapps-acmebot[shibayan/containerapps-acmebot] repo provides an Azure deployment that handles the LetsEncrypt certificates.
@@ -222,7 +222,7 @@ results in:
image::image-2023-01-03-18-10-33-567.png[width=800]
-== Enable App Service Authentication & Access control (IAM)
+=== Enable App Service Authentication & Access control (IAM)
Continuing with the link:https://github.com/shibayan/containerapps-acmebot/wiki/Getting-Started#3-enable-app-service-authentication[README]:
@@ -235,13 +235,13 @@ image::image-2023-01-03-18-16-01-614.png[width=800]
image::image-2023-01-03-18-22-59-542.png[width=1000]
-== Access function app
+=== Access function app
Continuing further with the link:https://github.com/shibayan/containerapps-acmebot/wiki/Getting-Started#5-access-to-function-app[README]:
-* locate the name of the function app (`func-acmbeot-y3a6` above)
+* locate the name of the function app (`func-acmebot-y3a6` above)
-* navigate to link:https://func-acmbeot-y3a6.azurewebsites.net/add-certificate[], and grant permissions to access the site:
+* navigate to link:https://func-acmebot-y3a6.azurewebsites.net/add-certificate[], and grant permissions to access the site:
+
image::image-2023-01-03-18-27-32-832.png[width=300]
@@ -270,6 +270,431 @@ image::image-2023-01-04-06-25-56-926.png[width=400]
image::image-2023-01-04-06-31-36-293.png[width=800]
+== Deploy Remaining Apps
+
+For each app, the steps are:
+
+* Set common environment variables
++
+[source,bash]
+----
+RESOURCE_GROUP="causeway-nightlies-rg"
+CONTAINERAPPS_ENVIRONMENT="causeway-nightlies-aca-env"
+----
+
+* Set app-specific environment variables
+
+* Create the container app
+* Manually configure scaling
+* Manually setup `CNAME` record in `apps.incode.work` DNS zone
+* Using the acmebot function app, link:https://func-acmebot-y3a6.azurewebsites.net/add-certificate[Add the certicate] for the container app
+
+
+=== demo-wicket-jpa
+
+Done previously
+
+=== demo-wicket-jpa-snapshot
+
+Steps:
+
+* Environment variables
++
+[source,bash]
+----
+APP_NAME="demo-wicket-jpa-snapshot"
+IMAGE_NAME="apacheisis/demo-wicket-jpa"
+IMAGE_VERSION="2.0.0-M9.20221229-0233-"
+----
++
+NOTE: Hmm, looks like there's an issue with our generation of the image version, missing the sha Id suffix.
+But this image _does_ exist.
+
+* Deploy
++
+[source,bash]
+----
+az containerapp create \
+ --name $APP_NAME \
+ --resource-group $RESOURCE_GROUP \
+ --environment $CONTAINERAPPS_ENVIRONMENT \
+ --image $IMAGE_NAME:$IMAGE_VERSION \
+ --target-port 8080 \
+ --ingress 'external' \
+ --query properties.configuration.ingress.fqdn
+----
+
+* Manually Configure Scaling
+
+* Manually setup DNS
++
+to `demo-wicket-jpa.apps.incode.work`
+
+* Register with LetsEncrypt Function App
+
+
+
+
+=== demo-wicket-jdo
+
+Steps:
+
+* Environment variables
++
+[source,bash]
+----
+APP_NAME="demo-wicket-jdo"
+IMAGE_NAME="apacheisis/demo-wicket-jdo"
+IMAGE_VERSION="2.0.0-M9.20221018-1911-d3980668"
+----
+
+* Deploy
++
+[source,bash]
+----
+az containerapp create \
+ --name $APP_NAME \
+ --resource-group $RESOURCE_GROUP \
+ --environment $CONTAINERAPPS_ENVIRONMENT \
+ --image $IMAGE_NAME:$IMAGE_VERSION \
+ --target-port 8080 \
+ --ingress 'external' \
+ --query properties.configuration.ingress.fqdn
+----
+
+* Manually Configure Scaling
+
+* Manually setup DNS
++
+to `demo-wicket-jdo.apps.incode.work`
+
+* Register with LetsEncrypt Function App
+
+
+=== demo-wicket-jdo-snapshot
+
+Steps:
+
+* Environment variables
++
+[source,bash]
+----
+APP_NAME="demo-wicket-jdo-snapshot"
+IMAGE_NAME="apacheisis/demo-wicket-jdo"
+IMAGE_VERSION="2.0.0-M9.20221229-0233-"
+----
++
+NOTE: Hmm, looks like there's an issue with our generation of the image version, missing the sha Id suffix.
+But this image _does_ exist.
+
+* Deploy
++
+[source,bash]
+----
+az containerapp create \
+ --name $APP_NAME \
+ --resource-group $RESOURCE_GROUP \
+ --environment $CONTAINERAPPS_ENVIRONMENT \
+ --image $IMAGE_NAME:$IMAGE_VERSION \
+ --target-port 8080 \
+ --ingress 'external' \
+ --query properties.configuration.ingress.fqdn
+----
+
+* Manually Configure Scaling
+
+* Manually setup DNS
++
+to `demo-wicket-jdo.apps.incode.work`
+
+* Register with LetsEncrypt Function App
+
+
+=== simpleapp (jpa)
+
+Steps:
+
+* Environment variables
++
+[source,bash]
+----
+APP_NAME="simpleapp-jpa"
+IMAGE_NAME="apacheisis/simpleapp"
+IMAGE_VERSION="jpa"
+----
+
+* Deploy
++
+[source,bash]
+----
+az containerapp create \
+ --name $APP_NAME \
+ --resource-group $RESOURCE_GROUP \
+ --environment $CONTAINERAPPS_ENVIRONMENT \
+ --image $IMAGE_NAME:$IMAGE_VERSION \
+ --target-port 8080 \
+ --ingress 'external' \
+ --query properties.configuration.ingress.fqdn
+----
+
+* Manually Configure Scaling
+
+* Manually setup DNS
++
+to `simpleapp-jpa.apps.incode.work`
+
+* Register with LetsEncrypt Function App
+
+=== simpleapp (jpa-SNAPSHOT)
+
+Steps:
+
+* Environment variables
++
+[source,bash]
+----
+APP_NAME="simpleapp-jpa-snapshot"
+IMAGE_NAME="apacheisis/simpleapp"
+IMAGE_VERSION="jpa-SNAPSHOT"
+----
+
+* Deploy
++
+[source,bash]
+----
+az containerapp create \
+ --name $APP_NAME \
+ --resource-group $RESOURCE_GROUP \
+ --environment $CONTAINERAPPS_ENVIRONMENT \
+ --image $IMAGE_NAME:$IMAGE_VERSION \
+ --target-port 8080 \
+ --ingress 'external' \
+ --query properties.configuration.ingress.fqdn
+----
+
+* Manually Configure Scaling
+
+* Manually setup DNS
++
+to `simpleapp-jpa-SNAPSHOT.apps.incode.work`
+
+* Register with LetsEncrypt Function App
+
+
+=== simpleapp (jdo)
+
+Steps:
+
+* Environment variables
++
+[source,bash]
+----
+APP_NAME="simpleapp-jdo"
+IMAGE_NAME="apacheisis/simpleapp"
+IMAGE_VERSION="jdo"
+----
+
+* Deploy
++
+[source,bash]
+----
+az containerapp create \
+ --name $APP_NAME \
+ --resource-group $RESOURCE_GROUP \
+ --environment $CONTAINERAPPS_ENVIRONMENT \
+ --image $IMAGE_NAME:$IMAGE_VERSION \
+ --target-port 8080 \
+ --ingress 'external' \
+ --query properties.configuration.ingress.fqdn
+----
+
+* Manually Configure Scaling
+
+* Manually setup DNS
++
+to `simpleapp-jdo.apps.incode.work`
+
+* Register with LetsEncrypt Function App
+
+=== simpleapp (jdo-SNAPSHOT)
+
+Steps:
+
+* Environment variables
++
+[source,bash]
+----
+APP_NAME="simpleapp-jdo-snapshot"
+IMAGE_NAME="apacheisis/simpleapp"
+IMAGE_VERSION="jdo-SNAPSHOT"
+----
+
+* Deploy
++
+[source,bash]
+----
+az containerapp create \
+ --name $APP_NAME \
+ --resource-group $RESOURCE_GROUP \
+ --environment $CONTAINERAPPS_ENVIRONMENT \
+ --image $IMAGE_NAME:$IMAGE_VERSION \
+ --target-port 8080 \
+ --ingress 'external' \
+ --query properties.configuration.ingress.fqdn
+----
+
+* Manually Configure Scaling
+
+* Manually setup DNS
++
+to `simpleapp-jdo-SNAPSHOT.apps.incode.work`
+
+* Register with LetsEncrypt Function App
+
+=== helloworld (jpa)
+
+Steps:
+
+* Environment variables
++
+[source,bash]
+----
+APP_NAME="helloworld-jpa"
+IMAGE_NAME="apacheisis/helloworld"
+IMAGE_VERSION="jpa"
+----
+
+* Deploy
++
+[source,bash]
+----
+az containerapp create \
+ --name $APP_NAME \
+ --resource-group $RESOURCE_GROUP \
+ --environment $CONTAINERAPPS_ENVIRONMENT \
+ --image $IMAGE_NAME:$IMAGE_VERSION \
+ --target-port 8080 \
+ --ingress 'external' \
+ --query properties.configuration.ingress.fqdn
+----
+
+* Manually Configure Scaling
+
+* Manually setup DNS
++
+to `helloworld-jpa.apps.incode.work`
+
+* Register with LetsEncrypt Function App
+
+=== helloworld (jpa-SNAPSHOT)
+
+Steps:
+
+* Environment variables
++
+[source,bash]
+----
+APP_NAME="helloworld-jpa-snapshot"
+IMAGE_NAME="apacheisis/helloworld"
+IMAGE_VERSION="jpa-SNAPSHOT"
+----
+
+* Deploy
++
+[source,bash]
+----
+az containerapp create \
+ --name $APP_NAME \
+ --resource-group $RESOURCE_GROUP \
+ --environment $CONTAINERAPPS_ENVIRONMENT \
+ --image $IMAGE_NAME:$IMAGE_VERSION \
+ --target-port 8080 \
+ --ingress 'external' \
+ --query properties.configuration.ingress.fqdn
+----
+
+* Manually Configure Scaling
+
+* Manually setup DNS
++
+to `helloworld-jpa-SNAPSHOT.apps.incode.work`
+
+* Register with LetsEncrypt Function App
+
+
+=== helloworld (jdo)
+
+Steps:
+
+* Environment variables
++
+[source,bash]
+----
+APP_NAME="helloworld-jdo"
+IMAGE_NAME="apacheisis/helloworld"
+IMAGE_VERSION="jdo"
+----
+
+* Deploy
++
+[source,bash]
+----
+az containerapp create \
+ --name $APP_NAME \
+ --resource-group $RESOURCE_GROUP \
+ --environment $CONTAINERAPPS_ENVIRONMENT \
+ --image $IMAGE_NAME:$IMAGE_VERSION \
+ --target-port 8080 \
+ --ingress 'external' \
+ --query properties.configuration.ingress.fqdn
+----
+
+* Manually Configure Scaling
+
+* Manually setup DNS
++
+to `helloworld-jdo.apps.incode.work`
+
+* Register with LetsEncrypt Function App
+
+=== helloworld (jdo-SNAPSHOT)
+
+Steps:
+
+* Environment variables
++
+[source,bash]
+----
+APP_NAME="helloworld-jdo-snapshot"
+IMAGE_NAME="apacheisis/helloworld"
+IMAGE_VERSION="jdo-SNAPSHOT"
+----
+
+* Deploy
++
+[source,bash]
+----
+az containerapp create \
+ --name $APP_NAME \
+ --resource-group $RESOURCE_GROUP \
+ --environment $CONTAINERAPPS_ENVIRONMENT \
+ --image $IMAGE_NAME:$IMAGE_VERSION \
+ --target-port 8080 \
+ --ingress 'external' \
+ --query properties.configuration.ingress.fqdn
+----
+
+* Manually Configure Scaling
+
+* Manually setup DNS
++
+to `helloworld-jdo-SNAPSHOT.apps.incode.work`
+
+* Register with LetsEncrypt Function App
+
+
+
+
== Automation
The nightly automation simply needs to update the apps with new images; there is no need to create ACA environments etc from scratch.
@@ -278,17 +703,16 @@ The nightly automation simply needs to update the apps with new images; there is
To see what this mean, let's first just update the app manually.
-Working with the `demo-wicket-jpa` app:
+Working with the `demo-wicket-jpa-latest` app:
* update the environment variables:
+
[source,bash]
----
-IMAGE_VERSION="2.0.0-M9.20221229-0233-"
+IMAGE_VERSION="2.0.0-M9.20221224-0226-7c658a3c"
----
+
-NOTE: Hmm, looks like there's an issue with our generation of the image version, missing the sha Id suffix.
-But this image _does_ exist.
+(just selecting an earlier version).
* Update the image using `az containerapp update`:
+
[isis] 05/07: ISIS-3255: updates references to starter and demo apps to new deployment locations under causeway.dev
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch ISIS-3255
in repository https://gitbox.apache.org/repos/asf/isis.git
commit 4d272895976e615fd44fa7fe1073372b148755e5
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Thu Jan 5 15:10:47 2023 +0000
ISIS-3255: updates references to starter and demo apps to new deployment locations under causeway.dev
---
.../images/image-2023-01-05-11-44-09-855.png | Bin 0 -> 98140 bytes
.../conguide/modules/nightlies/pages/about.adoc | 319 +++++----------------
.../nightlies/partials/az-containerapp-create.adoc | 12 +
antora/supplemental-ui/index.html | 6 +-
examples/vanilla/pom.xml | 41 ---
latest-nightly.sh | 22 --
.../modules/ROOT/pages/features/where-am-i.adoc | 2 +-
7 files changed, 92 insertions(+), 310 deletions(-)
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-05-11-44-09-855.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-05-11-44-09-855.png
new file mode 100644
index 0000000000..36c77fa2d3
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-05-11-44-09-855.png differ
diff --git a/antora/components/conguide/modules/nightlies/pages/about.adoc b/antora/components/conguide/modules/nightlies/pages/about.adoc
index 39fbecf01f..692e995778 100644
--- a/antora/components/conguide/modules/nightlies/pages/about.adoc
+++ b/antora/components/conguide/modules/nightlies/pages/about.adoc
@@ -170,17 +170,7 @@ IMAGE_VERSION="2.0.0-M9.20221018-1911-d3980668"
* create the app
+
-[source,bash]
-----
-az containerapp create \
- --name $APP_NAME \
- --resource-group $RESOURCE_GROUP \
- --environment $CONTAINERAPPS_ENVIRONMENT \
- --image $IMAGE_NAME:$IMAGE_VERSION \
- --target-port 8080 \
- --ingress 'external' \
- --query properties.configuration.ingress.fqdn
-----
+include::partial$az-containerapp-create.adoc[]
+
resulting in:
+
@@ -202,7 +192,7 @@ Following its link:https://github.com/shibayan/containerapps-acmebot/wiki/Gettin
=== DNS management
-Created DNS zone for `incode.work`, and then a child zone `apps.incode.work`.
+Created DNS zone for `causeway.dev`, and then a child zone `apps.causeway.dev`.
NOTE: the intention is to change this to a more suitable domain.
@@ -286,8 +276,8 @@ CONTAINERAPPS_ENVIRONMENT="causeway-nightlies-aca-env"
* Create the container app
* Manually configure scaling
-* Manually setup `CNAME` record in `apps.incode.work` DNS zone
-* Using the acmebot function app, link:https://func-acmebot-y3a6.azurewebsites.net/add-certificate[Add the certicate] for the container app
+* Manually setup `CNAME` record in `apps.causeway.dev` DNS zone
+* Using the acmebot function app, link:https://func-acmebot-y3a6.azurewebsites.net/add-certificate[add the certificate] for the container app
=== demo-wicket-jpa
@@ -304,7 +294,7 @@ Steps:
----
APP_NAME="demo-wicket-jpa-snapshot"
IMAGE_NAME="apacheisis/demo-wicket-jpa"
-IMAGE_VERSION="2.0.0-M9.20221229-0233-"
+IMAGE_VERSION="latest"
----
+
NOTE: Hmm, looks like there's an issue with our generation of the image version, missing the sha Id suffix.
@@ -312,23 +302,13 @@ But this image _does_ exist.
* Deploy
+
-[source,bash]
-----
-az containerapp create \
- --name $APP_NAME \
- --resource-group $RESOURCE_GROUP \
- --environment $CONTAINERAPPS_ENVIRONMENT \
- --image $IMAGE_NAME:$IMAGE_VERSION \
- --target-port 8080 \
- --ingress 'external' \
- --query properties.configuration.ingress.fqdn
-----
+include::partial$az-containerapp-create.adoc[]
* Manually Configure Scaling
* Manually setup DNS
+
-to `demo-wicket-jpa.apps.incode.work`
+to `demo-wicket-jpa-snapshot.apps.causeway.dev`
* Register with LetsEncrypt Function App
@@ -350,23 +330,13 @@ IMAGE_VERSION="2.0.0-M9.20221018-1911-d3980668"
* Deploy
+
-[source,bash]
-----
-az containerapp create \
- --name $APP_NAME \
- --resource-group $RESOURCE_GROUP \
- --environment $CONTAINERAPPS_ENVIRONMENT \
- --image $IMAGE_NAME:$IMAGE_VERSION \
- --target-port 8080 \
- --ingress 'external' \
- --query properties.configuration.ingress.fqdn
-----
+include::partial$az-containerapp-create.adoc[]
* Manually Configure Scaling
* Manually setup DNS
+
-to `demo-wicket-jdo.apps.incode.work`
+to `demo-wicket-jdo.apps.causeway.dev`
* Register with LetsEncrypt Function App
@@ -381,7 +351,7 @@ Steps:
----
APP_NAME="demo-wicket-jdo-snapshot"
IMAGE_NAME="apacheisis/demo-wicket-jdo"
-IMAGE_VERSION="2.0.0-M9.20221229-0233-"
+IMAGE_VERSION="latest"
----
+
NOTE: Hmm, looks like there's an issue with our generation of the image version, missing the sha Id suffix.
@@ -389,23 +359,13 @@ But this image _does_ exist.
* Deploy
+
-[source,bash]
-----
-az containerapp create \
- --name $APP_NAME \
- --resource-group $RESOURCE_GROUP \
- --environment $CONTAINERAPPS_ENVIRONMENT \
- --image $IMAGE_NAME:$IMAGE_VERSION \
- --target-port 8080 \
- --ingress 'external' \
- --query properties.configuration.ingress.fqdn
-----
+include::partial$az-containerapp-create.adoc[]
* Manually Configure Scaling
* Manually setup DNS
+
-to `demo-wicket-jdo.apps.incode.work`
+to `demo-wicket-jdo-snapshot.apps.causeway.dev`
* Register with LetsEncrypt Function App
@@ -425,23 +385,13 @@ IMAGE_VERSION="jpa"
* Deploy
+
-[source,bash]
-----
-az containerapp create \
- --name $APP_NAME \
- --resource-group $RESOURCE_GROUP \
- --environment $CONTAINERAPPS_ENVIRONMENT \
- --image $IMAGE_NAME:$IMAGE_VERSION \
- --target-port 8080 \
- --ingress 'external' \
- --query properties.configuration.ingress.fqdn
-----
+include::partial$az-containerapp-create.adoc[]
* Manually Configure Scaling
* Manually setup DNS
+
-to `simpleapp-jpa.apps.incode.work`
+to `simpleapp-jpa.apps.causeway.dev`
* Register with LetsEncrypt Function App
@@ -460,23 +410,13 @@ IMAGE_VERSION="jpa-SNAPSHOT"
* Deploy
+
-[source,bash]
-----
-az containerapp create \
- --name $APP_NAME \
- --resource-group $RESOURCE_GROUP \
- --environment $CONTAINERAPPS_ENVIRONMENT \
- --image $IMAGE_NAME:$IMAGE_VERSION \
- --target-port 8080 \
- --ingress 'external' \
- --query properties.configuration.ingress.fqdn
-----
+include::partial$az-containerapp-create.adoc[]
* Manually Configure Scaling
* Manually setup DNS
+
-to `simpleapp-jpa-SNAPSHOT.apps.incode.work`
+to `simpleapp-jpa-snapshot.apps.causeway.dev`
* Register with LetsEncrypt Function App
@@ -496,23 +436,13 @@ IMAGE_VERSION="jdo"
* Deploy
+
-[source,bash]
-----
-az containerapp create \
- --name $APP_NAME \
- --resource-group $RESOURCE_GROUP \
- --environment $CONTAINERAPPS_ENVIRONMENT \
- --image $IMAGE_NAME:$IMAGE_VERSION \
- --target-port 8080 \
- --ingress 'external' \
- --query properties.configuration.ingress.fqdn
-----
+include::partial$az-containerapp-create.adoc[]
* Manually Configure Scaling
* Manually setup DNS
+
-to `simpleapp-jdo.apps.incode.work`
+to `simpleapp-jdo.apps.causeway.dev`
* Register with LetsEncrypt Function App
@@ -531,23 +461,13 @@ IMAGE_VERSION="jdo-SNAPSHOT"
* Deploy
+
-[source,bash]
-----
-az containerapp create \
- --name $APP_NAME \
- --resource-group $RESOURCE_GROUP \
- --environment $CONTAINERAPPS_ENVIRONMENT \
- --image $IMAGE_NAME:$IMAGE_VERSION \
- --target-port 8080 \
- --ingress 'external' \
- --query properties.configuration.ingress.fqdn
-----
+include::partial$az-containerapp-create.adoc[]
* Manually Configure Scaling
* Manually setup DNS
+
-to `simpleapp-jdo-SNAPSHOT.apps.incode.work`
+to `simpleapp-jdo.apps.causeway.dev`
* Register with LetsEncrypt Function App
@@ -566,23 +486,13 @@ IMAGE_VERSION="jpa"
* Deploy
+
-[source,bash]
-----
-az containerapp create \
- --name $APP_NAME \
- --resource-group $RESOURCE_GROUP \
- --environment $CONTAINERAPPS_ENVIRONMENT \
- --image $IMAGE_NAME:$IMAGE_VERSION \
- --target-port 8080 \
- --ingress 'external' \
- --query properties.configuration.ingress.fqdn
-----
+include::partial$az-containerapp-create.adoc[]
* Manually Configure Scaling
* Manually setup DNS
+
-to `helloworld-jpa.apps.incode.work`
+to `helloworld-jpa.apps.causeway.dev`
* Register with LetsEncrypt Function App
@@ -601,23 +511,13 @@ IMAGE_VERSION="jpa-SNAPSHOT"
* Deploy
+
-[source,bash]
-----
-az containerapp create \
- --name $APP_NAME \
- --resource-group $RESOURCE_GROUP \
- --environment $CONTAINERAPPS_ENVIRONMENT \
- --image $IMAGE_NAME:$IMAGE_VERSION \
- --target-port 8080 \
- --ingress 'external' \
- --query properties.configuration.ingress.fqdn
-----
+include::partial$az-containerapp-create.adoc[]
* Manually Configure Scaling
* Manually setup DNS
+
-to `helloworld-jpa-SNAPSHOT.apps.incode.work`
+to `helloworld-jpa-snapshot.apps.causeway.dev`
* Register with LetsEncrypt Function App
@@ -637,23 +537,13 @@ IMAGE_VERSION="jdo"
* Deploy
+
-[source,bash]
-----
-az containerapp create \
- --name $APP_NAME \
- --resource-group $RESOURCE_GROUP \
- --environment $CONTAINERAPPS_ENVIRONMENT \
- --image $IMAGE_NAME:$IMAGE_VERSION \
- --target-port 8080 \
- --ingress 'external' \
- --query properties.configuration.ingress.fqdn
-----
+include::partial$az-containerapp-create.adoc[]
* Manually Configure Scaling
* Manually setup DNS
+
-to `helloworld-jdo.apps.incode.work`
+to `helloworld-jdo.apps.causeway.dev`
* Register with LetsEncrypt Function App
@@ -672,23 +562,13 @@ IMAGE_VERSION="jdo-SNAPSHOT"
* Deploy
+
-[source,bash]
-----
-az containerapp create \
- --name $APP_NAME \
- --resource-group $RESOURCE_GROUP \
- --environment $CONTAINERAPPS_ENVIRONMENT \
- --image $IMAGE_NAME:$IMAGE_VERSION \
- --target-port 8080 \
- --ingress 'external' \
- --query properties.configuration.ingress.fqdn
-----
+include::partial$az-containerapp-create.adoc[]
* Manually Configure Scaling
* Manually setup DNS
+
-to `helloworld-jdo-SNAPSHOT.apps.incode.work`
+to `helloworld-jdo-snapshot.apps.causeway.dev`
* Register with LetsEncrypt Function App
@@ -697,117 +577,70 @@ to `helloworld-jdo-SNAPSHOT.apps.incode.work`
== Automation
-The nightly automation simply needs to update the apps with new images; there is no need to create ACA environments etc from scratch.
+The nightly automation simply needs to update the apps with new images, using `az container revision copy`.
+There is no need to create ACA environments etc from scratch.
-=== Manual update first
+=== Prereqs
-To see what this mean, let's first just update the app manually.
+We require an Azure Service Principal for the CI/CD job to use.
-Working with the `demo-wicket-jpa-latest` app:
+Following https://dev.to/erudinsky/how-to-deploy-to-azure-with-gitlab-authentication-credentials-store-runner-config-yaml-pipeline-example-37bp[this blog post] and also https://learn.microsoft.com/en-us/cli/azure/create-an-azure-service-principal-azure-cli#password-based-authentication[MS docs]:
-* update the environment variables:
+* https://learn.microsoft.com/en-us/azure/active-directory/develop/howto-create-service-principal-portal#register-an-application-with-azure-ad-and-create-a-service-principal[register an application]
+
-[source,bash]
-----
-IMAGE_VERSION="2.0.0-M9.20221224-0226-7c658a3c"
-----
+My guess is that this is a 'deploy' application rather than the application being deployed.
+
-(just selecting an earlier version).
+image::image-2023-01-05-11-44-09-855.png[width=800]
+
+// * https://learn.microsoft.com/en-us/azure/active-directory/develop/howto-create-service-principal-portal#assign-a-role-to-the-application[assign a role to the application]
+
+* lookup your subscriptionId
-* Update the image using `az containerapp update`:
+* as per the MS doc:
+
-[source,bash]
+[source,powershell]
----
-az containerapp update \
- --name $APP_NAME \
- --resource-group $RESOURCE_GROUP \
- --image $IMAGE_NAME:$IMAGE_VERSION
+az ad sp create-for-rbac --name CausewayNightliesDeployPrincipal --role Owner --scopes "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
----
+
-resulting in:
+WARNING: must use powershell here.
+
-[source,bash]
+should result in:
++
+[source]
----
+Found an existing application instance: (id) XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. We will patch it.
+Creating 'Owner' role assignment under scope '/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'
+The output includes credentials that you must protect. Be sure that you do not include these credentials in your code or check the credentials into your source control. For more information, see https://aka.ms/azadsp-cli
{
- "id": "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg/providers/Microsoft.App/containerapps/demo-wicket-jpa",
- "identity": {
- "type": "None"
- },
- "location": "UK South",
- "name": "demo-wicket-jpa",
- "properties": {
- "configuration": {
- "activeRevisionsMode": "Single",
- "dapr": null,
- "ingress": {
- "allowInsecure": false,
- "customDomains": null,
- "exposedPort": 0,
- "external": true,
- "fqdn": "demo-wicket-jpa.graytree-90c75749.uksouth.azurecontainerapps.io",
- "ipSecurityRestrictions": null,
- "targetPort": 8080,
- "traffic": [
- {
- "latestRevision": true,
- "weight": 100
- }
- ],
- "transport": "Auto"
- },
- "maxInactiveRevisions": null,
- "registries": null,
- "secrets": null
- },
- "customDomainVerificationId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
- "environmentId": "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg/providers/Microsoft.App/managedEnvironments/causeway-nightlies-aca-env",
- "eventStreamEndpoint": "https://uksouth.azurecontainerapps.dev/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg/containerApps/demo-wicket-jpa/eventstream",
- "latestRevisionFqdn": "demo-wicket-jpa--hg9md16.graytree-90c75749.uksouth.azurecontainerapps.io",
- "latestRevisionName": "demo-wicket-jpa--hg9md16",
- "managedEnvironmentId": "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg/providers/Microsoft.App/managedEnvironments/causeway-nightlies-aca-env",
- "outboundIpAddresses": [
- "20.108.221.63"
- ],
- "provisioningState": "Succeeded",
- "template": {
- "containers": [
- {
- "image": "apacheisis/demo-wicket-jpa:2.0.0-M9.20221224-0226-7c658a3c",
- "name": "demo-wicket-jpa",
- "resources": {
- "cpu": 0.5,
- "ephemeralStorage": "1Gi",
- "memory": "1Gi"
- }
- }
- ],
- "initContainers": null,
- "revisionSuffix": "",
- "scale": {
- "maxReplicas": 10,
- "minReplicas": null,
- "rules": null
- },
- "volumes": null
- },
- "workloadProfileType": null
- },
- "resourceGroup": "causeway-nightlies-rg",
- "systemData": {
- "createdAt": "2023-01-02T07:06:17.4141558",
- "createdBy": "dan@haywood-associates.co.uk",
- "createdByType": "User",
- "lastModifiedAt": "2023-01-02T07:12:31.4804896",
- "lastModifiedBy": "dan@haywood-associates.co.uk",
- "lastModifiedByType": "User"
- },
- "type": "Microsoft.App/containerApps"
+ "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
+ "displayName": "CausewayNightliesDeployPrincipal",
+ "password": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
+ "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
}
----
-This results in a new revision being provisioned.
-Traffic is automatically migrated over to the new revision, and then the previous revision is removed.
+=== CI Jobs
-=== Automation
+The CI jobs can be found in link:https://github.com/apache-causeway-committers/causeway-nightly-deploys[apache-causeway-committers/causeway-nightly-deploys].
-WARNING: todo.
+The main script consists of these commands:
+
+[source,bash]
+----
+TIMESTAMP=$(date "+%Y%m%d-%H%M%S")
+REVISION_SUFFIX="r${TIMESTAMP}"
+
+az login --service-principal \
+ --username "$AZ_APP_ID" \
+ --password "$AZ_PASSWORD" \
+ --tenant "$AZ_TENANT_ID"
+
+az containerapp revision copy \
+ --name "$APPNAME" \
+ --resource-group "$RESOURCE_GROUP" \
+ --image "$IMAGE" \
+ --cpu "$CPU" \
+ --memory "$MEMORY" \
+ --revision-suffix "$REVISION_SUFFIX"
+----
diff --git a/antora/components/conguide/modules/nightlies/partials/az-containerapp-create.adoc b/antora/components/conguide/modules/nightlies/partials/az-containerapp-create.adoc
new file mode 100644
index 0000000000..a1bef0db7f
--- /dev/null
+++ b/antora/components/conguide/modules/nightlies/partials/az-containerapp-create.adoc
@@ -0,0 +1,12 @@
+[source,bash]
+----
+az containerapp create \
+ --name $APP_NAME \
+ --resource-group $RESOURCE_GROUP \
+ --environment $CONTAINERAPPS_ENVIRONMENT \
+ --environment-variables PROTOTYPING=true \
+ --image $IMAGE_NAME:$IMAGE_VERSION \
+ --target-port 8080 \
+ --ingress 'external' \
+ --query properties.configuration.ingress.fqdn
+----
diff --git a/antora/supplemental-ui/index.html b/antora/supplemental-ui/index.html
index cccbb72fcf..d63ae9a1a9 100644
--- a/antora/supplemental-ui/index.html
+++ b/antora/supplemental-ui/index.html
@@ -551,13 +551,13 @@
<div class="col-lg-6 text-left text-lg-left">
<p class="cta-text text-center" style="margin-block-end: 0; ">
Learn about Apache Isis™ by running the minimal <a href="docs/latest/starters/helloworld.html">helloworld</a> starter app.
- You can see the app running <a href="https://helloworld.jdo.isis.incode.work/" target="_blank">here (jdo)</a> or <a href="https://helloworld.jpa.isis.incode.work/" target="_blank">here (jpa)</a>.
+ You can see the app running <a href="https://helloworld-jdo.apps.causeway.dev/" target="_blank">here (jdo)</a> or <a href="https://helloworld-jpa-snapshot.apps.causeway.dev/" target="_blank">here (jpa)</a>.
</p>
</div>
<div class="col-lg-6 text-left text-lg-left">
<p class="cta-text text-center" style="margin-block-end: 0; ">
Develop your own Apache Isis™ app with the structured <a href="docs/latest/starters/simpleapp.html">simpleapp</a> starter app.
- You can see the app running <a href="https://simpleapp.jdo.isis.incode.work/" target="_blank">here (jdo)</a> or <a href="https://simpleapp.jpa.isis.incode.work/" target="_blank">here (jpa)</a>.
+ You can see the app running <a href="https://simpleapp-jdo.apps.causeway.dev/" target="_blank">here (jdo)</a> or <a href="https://simpleapp-jpa-snapshot.apps.causeway.dev/" target="_blank">here (jpa)</a>.
</p>
</div>
</div>
@@ -640,7 +640,7 @@ mvn -pl webapp spring-boot:run</pre>
<div class="row">
<div class="col-lg-12 text-left text-lg-left">
<p class="cta-text text-center" style="margin-block-end: 0; margin-top: 20px;">
- You can also explore the Apache Isis programming model through the demo app, running <a href="https://demo-wicket.jdo.isis.incode.work/" target="_blank">here (jdo)</a> or <a href="https://demo-wicket.jpa.isis.incode.work/" target="_blank">here (jpa)</a>.
+ You can also explore the Apache Isis programming model through the demo app, running <a href="https://demo-wicket-jdo-snapshot.apps.causeway.dev/" target="_blank">here (jdo)</a> or <a href="https://demo-wicket-jpa-snapshot.apps.causeway.dev/" target="_blank">here (jpa)</a>.
</p>
</div>
</div>
diff --git a/examples/vanilla/pom.xml b/examples/vanilla/pom.xml
deleted file mode 100644
index 9eff83c2a5..0000000000
--- a/examples/vanilla/pom.xml
+++ /dev/null
@@ -1,41 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-
-<!--
- ~ Licensed to the Apache Software Foundation (ASF) under one
- ~ or more contributor license agreements. See the NOTICE file
- ~ distributed with this work for additional information
- ~ regarding copyright ownership. The ASF licenses this file
- ~ to you under the Apache License, Version 2.0 (the
- ~ "License"); you may not use this file except in compliance
- ~ with the License. You may obtain a copy of the License at
- ~
- ~ http://www.apache.org/licenses/LICENSE-2.0
- ~
- ~ Unless required by applicable law or agreed to in writing,
- ~ software distributed under the License is distributed on an
- ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- ~ KIND, either express or implied. See the License for the
- ~ specific language governing permissions and limitations
- ~ under the License.
- ~
- -->
-
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
- <modelVersion>4.0.0</modelVersion>
-
- <!--
- created to allow comparisons of effective-pom between
- causeway-parent or causeway vs vanilla Spring Boot.
- -->
- <groupId>org.apache.causeway.examples.app</groupId>
- <artifactId>vanilla</artifactId>
- <version>2.0.0-SNAPSHOT</version>
- <packaging>pom</packaging>
-
- <parent>
- <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-parent</artifactId>
- <version>2.2.4.RELEASE</version>
- </parent>
-
-</project>
diff --git a/latest-nightly.sh b/latest-nightly.sh
deleted file mode 100644
index 384e5a0ad4..0000000000
--- a/latest-nightly.sh
+++ /dev/null
@@ -1,22 +0,0 @@
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements. See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership. The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License. You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied. See the License for the
-# specific language governing permissions and limitations
-# under the License.
-#
-#
-
-PARENT=$(curl -X GET "https://nexus.incode.work/service/rest/v1/search?sort=version&repository=nightly-builds&group=org.apache.causeway.app&name=causeway-app-starter-parent" -H "accept: application/json" -s | jq '.items[0].version' | sed 's/"//g')
-echo "latest = $PARENT"
diff --git a/viewers/wicket/adoc/modules/ROOT/pages/features/where-am-i.adoc b/viewers/wicket/adoc/modules/ROOT/pages/features/where-am-i.adoc
index 13e262d666..aedd0d7208 100644
--- a/viewers/wicket/adoc/modules/ROOT/pages/features/where-am-i.adoc
+++ b/viewers/wicket/adoc/modules/ROOT/pages/features/where-am-i.adoc
@@ -12,7 +12,7 @@ Domain objects that take part in such a navigable-tree-structure need to declare
== Screenshots
-The following screenshot (from the link:https://demo-wicket.jdo.causeway.incode.work/[demo app]) shows the navigation links below the top menu bar.
+The following screenshot (from the link:https://demo-wicket-jpa-snapshot.causeway.dev/[demo app]) shows the navigation links below the top menu bar.
image::where-am-i/hello_grey_bg.png[width="720px"]
[isis] 03/07: ISIS-3255: updates docs on letsencrypt with ACA
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch ISIS-3255
in repository https://gitbox.apache.org/repos/asf/isis.git
commit 46a693751c5b80fdb846c47e04a0b241496184cb
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Wed Jan 4 07:08:47 2023 +0000
ISIS-3255: updates docs on letsencrypt with ACA
---
.../images/image-2023-01-02-11-10-57-742.png | Bin 399828 -> 0 bytes
.../images/image-2023-01-02-11-15-22-937.png | Bin 177254 -> 0 bytes
.../images/image-2023-01-02-11-37-15-599.png | Bin 277941 -> 0 bytes
.../images/image-2023-01-02-11-39-16-947.png | Bin 123243 -> 0 bytes
.../images/image-2023-01-02-11-41-34-824.png | Bin 53087 -> 0 bytes
.../images/image-2023-01-02-18-54-07-844.png | Bin 44438 -> 0 bytes
.../images/image-2023-01-02-18-55-22-599.png | Bin 43113 -> 0 bytes
.../images/image-2023-01-02-18-57-10-836.png | Bin 30196 -> 0 bytes
.../images/image-2023-01-03-17-58-33-718.png | Bin 0 -> 109418 bytes
.../images/image-2023-01-03-18-07-57-499.png | Bin 0 -> 172103 bytes
.../images/image-2023-01-03-18-10-33-567.png | Bin 0 -> 304198 bytes
.../images/image-2023-01-03-18-16-01-614.png | Bin 0 -> 182994 bytes
.../images/image-2023-01-03-18-22-59-542.png | Bin 0 -> 196650 bytes
.../images/image-2023-01-03-18-27-32-832.png | Bin 0 -> 248437 bytes
.../images/image-2023-01-03-18-33-23-116.png | Bin 0 -> 71103 bytes
.../images/image-2023-01-04-06-23-41-099.png | Bin 0 -> 100404 bytes
.../images/image-2023-01-04-06-25-56-926.png | Bin 0 -> 58685 bytes
.../images/image-2023-01-04-06-26-42-960.png | Bin 0 -> 21755 bytes
.../images/image-2023-01-04-06-29-02-083.png | Bin 0 -> 106044 bytes
.../images/image-2023-01-04-06-31-36-293.png | Bin 0 -> 199485 bytes
.../conguide/modules/nightlies/pages/about.adoc | 271 +++++++++------------
21 files changed, 115 insertions(+), 156 deletions(-)
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-10-57-742.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-10-57-742.png
deleted file mode 100644
index e07f4a0203..0000000000
Binary files a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-10-57-742.png and /dev/null differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-15-22-937.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-15-22-937.png
deleted file mode 100644
index acc9c9624a..0000000000
Binary files a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-15-22-937.png and /dev/null differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-37-15-599.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-37-15-599.png
deleted file mode 100644
index a4fac01fc6..0000000000
Binary files a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-37-15-599.png and /dev/null differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-39-16-947.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-39-16-947.png
deleted file mode 100644
index d373338784..0000000000
Binary files a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-39-16-947.png and /dev/null differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-41-34-824.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-41-34-824.png
deleted file mode 100644
index e55eb0e9e0..0000000000
Binary files a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-41-34-824.png and /dev/null differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-54-07-844.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-54-07-844.png
deleted file mode 100644
index 58659be179..0000000000
Binary files a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-54-07-844.png and /dev/null differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-55-22-599.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-55-22-599.png
deleted file mode 100644
index b67fb6242f..0000000000
Binary files a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-55-22-599.png and /dev/null differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-57-10-836.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-57-10-836.png
deleted file mode 100644
index 127baf44c5..0000000000
Binary files a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-57-10-836.png and /dev/null differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-17-58-33-718.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-17-58-33-718.png
new file mode 100644
index 0000000000..7c139ee581
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-17-58-33-718.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-07-57-499.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-07-57-499.png
new file mode 100644
index 0000000000..ae4d29d131
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-07-57-499.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-10-33-567.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-10-33-567.png
new file mode 100644
index 0000000000..45dcf85bb6
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-10-33-567.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-16-01-614.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-16-01-614.png
new file mode 100644
index 0000000000..546fcb00a8
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-16-01-614.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-22-59-542.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-22-59-542.png
new file mode 100644
index 0000000000..1ae67f86e5
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-22-59-542.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-27-32-832.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-27-32-832.png
new file mode 100644
index 0000000000..3feadd5133
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-27-32-832.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-33-23-116.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-33-23-116.png
new file mode 100644
index 0000000000..705de78206
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-33-23-116.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-23-41-099.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-23-41-099.png
new file mode 100644
index 0000000000..539fb274df
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-23-41-099.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-25-56-926.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-25-56-926.png
new file mode 100644
index 0000000000..ece903b8fa
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-25-56-926.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-26-42-960.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-26-42-960.png
new file mode 100644
index 0000000000..6b146575db
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-26-42-960.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-29-02-083.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-29-02-083.png
new file mode 100644
index 0000000000..6f10b2fe04
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-29-02-083.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-31-36-293.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-31-36-293.png
new file mode 100644
index 0000000000..854a3ab44f
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-31-36-293.png differ
diff --git a/antora/components/conguide/modules/nightlies/pages/about.adoc b/antora/components/conguide/modules/nightlies/pages/about.adoc
index d9c99f0587..5db1b649ee 100644
--- a/antora/components/conguide/modules/nightlies/pages/about.adoc
+++ b/antora/components/conguide/modules/nightlies/pages/about.adoc
@@ -8,7 +8,7 @@ This page describes how we deploy the xref:docs:starters:simpleapp.adoc[], xref:
WARNING: work in progress
-The intention is to use link:https://learn.microsoft.com/en-gb/azure/container-apps/[Azure Container Apps].
+The intention is to use link:https://learn.microsoft.com/en-gb/azure/container-apps/[Azure Container Apps] (hereafter ACA).
== Azure Container Apps
@@ -51,16 +51,24 @@ az provider register --namespace Microsoft.OperationalInsights
-=== Setup
+=== Setup the resource group and ACA environment
+
+In Azure, all resources live in resource groups.
+We will use a single resource group.
+
+One of the resources to be set up is an ACA environment, which creates a secure boundary around a group of container apps.
+Container Apps deployed to the same environment are deployed in the same virtual network and write logs to the same Log Analytics workspace.
+We will use a single ACA environment.
Create a resource group to organize the services related to the container apps.
-* set the environment variables:
+* set these environment variables:
+
[source,bash]
----
RESOURCE_GROUP="causeway-nightlies-rg"
LOCATION="uksouth"
+CONTAINERAPPS_ENVIRONMENT="causeway-nightlies-aca-env"
----
* create the resource group
@@ -89,19 +97,7 @@ resulting in:
}
----
-=== Create an environment
-
-An environment in Azure Container Apps creates a secure boundary around a group of container apps.
-Container Apps deployed to the same environment are deployed in the same virtual network and write logs to the same Log Analytics workspace.
-
-* set a further environment variable:
-+
-[source,bash]
-----
-CONTAINERAPPS_ENVIRONMENT="causeway-nightlies-aca-env"
-----
-
-* xxx
+* next, create the ACA environment:
+
[source,bash]
----
@@ -155,11 +151,15 @@ Container Apps environment created. To deploy a container app, use: az container
}
----
+
=== Create container apps
-For link:https://hub.docker.com/repository/docker/apacheisis/demo-wicket-jpa[apacheisis/demo-wicket-jpa]
+We will create a container app manually.
+In the <<#automation,automation (below)>>, we will simply update the container (replacing the image with a new one).
+
+We'll start with the link:https://hub.docker.com/repository/docker/apacheisis/demo-wicket-jpa[apacheisis/demo-wicket-jpa] Docker image:
-* set a further environment variables:
+* set further environment variables:
+
[source,bash]
----
@@ -189,7 +189,96 @@ resulting in:
Container app created. Access your app at https://demo-wicket-jpa.graytree-90c75749.uksouth.azurecontainerapps.io/
----
-=== Update the app
+* Change scaling from default (1-10) to just a single instance.
++
+image::image-2023-01-03-08-31-58-018.png[width=600]
+
+
+== Lets Encrypt
+
+as per: link:https://dev.to/shibayan/how-to-quickly-setup-a-lets-encrypt-certificate-in-azure-container-apps-3nd7[this blog post] blog, the link:https://github.com/shibayan/containerapps-acmebot[shibayan/containerapps-acmebot] repo provides an Azure deployment that handles the LetsEncrypt certificates.
+
+Following its link:https://github.com/shibayan/containerapps-acmebot/wiki/Getting-Started[Getting-Started] README:
+
+=== DNS management
+
+Created DNS zone for `incode.work`, and then a child zone `apps.incode.work`.
+
+NOTE: the intention is to change this to a more suitable domain.
+
+
+=== Deploy the Services
+
+* from the link:https://github.com/shibayan/containerapps-acmebot/wiki/Getting-Started#1-deploy-acmebot[README]:
++
+image::image-2023-01-03-17-58-33-718.png[width=600]
+
+* add params:
++
+image::image-2023-01-03-18-07-57-499.png[width=800]
++
+results in:
++
+image::image-2023-01-03-18-10-33-567.png[width=800]
+
+
+== Enable App Service Authentication & Access control (IAM)
+
+Continuing with the link:https://github.com/shibayan/containerapps-acmebot/wiki/Getting-Started#3-enable-app-service-authentication[README]:
+
+* add an identity provider to the function app:
++
+image::image-2023-01-03-18-16-01-614.png[width=800]
+
+* add contributor role assignment:
++
+image::image-2023-01-03-18-22-59-542.png[width=1000]
+
+
+== Access function app
+
+Continuing further with the link:https://github.com/shibayan/containerapps-acmebot/wiki/Getting-Started#5-access-to-function-app[README]:
+
+* locate the name of the function app (`func-acmbeot-y3a6` above)
+
+* navigate to link:https://func-acmbeot-y3a6.azurewebsites.net/add-certificate[], and grant permissions to access the site:
++
+image::image-2023-01-03-18-27-32-832.png[width=300]
+
+
+* complete dialog:
++
+image::image-2023-01-04-06-23-41-099.png[width=600]
++
+and `Submit`.
+
+* The docs say "after a few tens of seconds, the certificate will be issued".
+Indeed so:
++
+image::image-2023-01-04-06-26-42-960.png[width=400]
++
+In the DNS zone, it creates this `TXT` record:
++
+image::image-2023-01-04-06-29-02-083.png[width=600]
+
+* Also create a `CNAME` for the app:
++
+image::image-2023-01-04-06-25-56-926.png[width=400]
+
+* Confirm that the app can be accessed:
++
+image::image-2023-01-04-06-31-36-293.png[width=800]
+
+
+== Automation
+
+The nightly automation simply needs to update the apps with new images; there is no need to create ACA environments etc from scratch.
+
+=== Manual update first
+
+To see what this mean, let's first just update the app manually.
+
+Working with the `demo-wicket-jpa` app:
* update the environment variables:
+
@@ -198,9 +287,10 @@ Container app created. Access your app at https://demo-wicket-jpa.graytree-90c75
IMAGE_VERSION="2.0.0-M9.20221229-0233-"
----
+
-NOTE: looks like there's an issue with our generation of the image version, missing the sha Id suffix.
+NOTE: Hmm, looks like there's an issue with our generation of the image version, missing the sha Id suffix.
+But this image _does_ exist.
-* Update the image
+* Update the image using `az containerapp update`:
+
[source,bash]
----
@@ -291,140 +381,9 @@ resulting in:
}
----
-== Custom domain
-
-=== Create self-signed certificate
+This results in a new revision being provisioned.
+Traffic is automatically migrated over to the new revision, and then the previous revision is removed.
-* create `
-+
-[source,bash]
-----
-openssl req -new -newkey RSA:2048 -nodes -keyout ssl.key -out ssl.csr
-----
-+
-resulting in:
-+
-[source,bash]
-----
-Generating a RSA private key
-...............................+++++
-.+++++
-writing new private key to 'ssl.key'
------
-You are about to be asked to enter information that will be incorporated
-into your certificate request.
-What you are about to enter is what is called a Distinguished Name or a DN.
-There are quite a few fields but you can leave some blank
-For some fields there will be a default value,
-If you enter '.', the field will be left blank.
------
-Country Name (2 letter code) [AU]:UK
-State or Province Name (full name) [Some-State]:Worcestershire
-Locality Name (eg, city) []:Malvern
-Organization Name (eg, company) [Internet Widgits Pty Ltd]:Haywood Associates Ltd.
-Organizational Unit Name (eg, section) []:
-Common Name (e.g. server FQDN or YOUR name) []:*.isis.incode.work
-Email Address []:dan@haywood-associates.co.uk
-
-Please enter the following 'extra' attributes
-to be sent with your certificate request
-A challenge password []:
-An optional company name []:Haywood Associates Ltd.
-----
-+
-which results in two files:
-
-** `ssl.csr`
-** `ssl.key`
-
-* create the `.crt` self-signed certificate:
-+
-[source,bash]
-----
-openssl x509 -req -days 365 -in ssl.csr -signkey ssl.key -out ssl.crt
-----
-+
-resulting in:
-+
-[source,bash]
-----
-Signature ok
-subject=C = UK, ST = Worcestershire, L = Malvern, O = Haywood Associates Ltd., CN = *.isis.incode.work, emailAddress = dan@haywood-associates.co.uk
-Getting Private key
-----
-+
-and the additional file:
-
-** `ssl.crt`
-
-
-* convert to a PKCS12 (`.pfx`) file
-+
-[source,bash]
-----
-openssl pkcs12 -inkey ssl.key -in ssl.crt -export -out ssl.pfx
-----
-+
-resulting in:
-+
-[source,bash]
-----
-Enter Export Password:
-Verifying - Enter Export Password:
-----
-+
-and the additional file:
-
-** `ssl.pfx`
-
-
-
-=== Add Custom domain and bind to cert
-
-As per MS docs on https://learn.microsoft.com/en-us/azure/container-apps/custom-domains-certificates[adding custom domain & certificates]
-
-in Azure Portal:
-
-* locate IP:
-+
-image::image-2023-01-02-11-10-57-742.png[width=800px]
-
-* add custom domain:
-+
-image::image-2023-01-02-11-15-22-937.png[width=400]
-
-in DNS nameserver (eg held by registrar)
-
-* add DNS records:
-+
-image::image-2023-01-02-11-37-15-599.png[width=800]
-
-in Azure Portal:
-
-* validate:
-+
-image::image-2023-01-02-11-39-16-947.png[width=400]
-
-* next:
-+
-image::image-2023-01-02-11-41-34-824.png[width=400]
-
-* use `create new` link
-+
-upload the .pfx file created earlier, and validate:
-+
-image::image-2023-01-02-18-54-07-844.png[width=400]
-
-* confirm
-+
-image::image-2023-01-02-18-55-22-599.png[width=400]
-
-* listed:
-+
-image::image-2023-01-02-18-57-10-836.png[width=800]
-
-
-* Change scaling from default (1-10) to just a single instance.
-+
-image::image-2023-01-03-08-31-58-018.png[width=600]
+=== Automation
+WARNING: todo.
[isis] 01/07: ISIS-3255: updates index.html with warning re: Windows classpath length limits
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch ISIS-3255
in repository https://gitbox.apache.org/repos/asf/isis.git
commit 479c0d9032f3e003822d3641df1e0ee5f8f1a560
Author: Dan Haywood <da...@haywood-associates.co.uk>
AuthorDate: Wed Dec 14 23:34:54 2022 +0000
ISIS-3255: updates index.html with warning re: Windows classpath length limits
---
antora/supplemental-ui/index.html | 22 +++++++++++++++-------
1 file changed, 15 insertions(+), 7 deletions(-)
diff --git a/antora/supplemental-ui/index.html b/antora/supplemental-ui/index.html
index 4a313fa5de..cccbb72fcf 100644
--- a/antora/supplemental-ui/index.html
+++ b/antora/supplemental-ui/index.html
@@ -540,16 +540,24 @@
<h3 class="cta-title">Quick Start</h3>
<div class="row">
+ <div class="col-lg-12 text-left text-lg-left">
+ <p class="cta-text text-center" style="margin-block-end: 0; ">
+ Prereqs: Java 11 and Maven 3.6+. <br/>
+ We recommend you try out using Linux, MacOS or WSL2 <br/>
+ (to <a href="https://github.com/spring-projects/spring-boot/issues/17766">avoid exceeding</a> Windows' limits due to classpath length).
+ </p>
+ <br/>
+ </div>
<div class="col-lg-6 text-left text-lg-left">
<p class="cta-text text-center" style="margin-block-end: 0; ">
Learn about Apache Isis™ by running the minimal <a href="docs/latest/starters/helloworld.html">helloworld</a> starter app.
- You can see the app running <a href="https://helloworld.jdo.isis.incode.work/" target="_blank">here (jdo)</a> and <a href="https://helloworld.jpa.isis.incode.work/" target="_blank">here (jpa)</a>.
+ You can see the app running <a href="https://helloworld.jdo.isis.incode.work/" target="_blank">here (jdo)</a> or <a href="https://helloworld.jpa.isis.incode.work/" target="_blank">here (jpa)</a>.
</p>
</div>
<div class="col-lg-6 text-left text-lg-left">
<p class="cta-text text-center" style="margin-block-end: 0; ">
Develop your own Apache Isis™ app with the structured <a href="docs/latest/starters/simpleapp.html">simpleapp</a> starter app.
- You can see the app running <a href="https://simpleapp.jdo.isis.incode.work/" target="_blank">here (jdo)</a> and <a href="https://simpleapp.jpa.isis.incode.work/" target="_blank">here (jpa)</a>.
+ You can see the app running <a href="https://simpleapp.jdo.isis.incode.work/" target="_blank">here (jdo)</a> or <a href="https://simpleapp.jpa.isis.incode.work/" target="_blank">here (jpa)</a>.
</p>
</div>
</div>
@@ -562,7 +570,7 @@ BRANCH=jdo
curl https://codeload.github.com/apache/$APP/zip/$BRANCH | jar xv
cd $APP-$BRANCH
-mvn clean install
+mvn clean install -Dskip.staging -Dskip.nightly
mvn spring-boot:run</pre>
</p>
</div>
@@ -574,7 +582,7 @@ BRANCH=jdo
curl https://codeload.github.com/apache/$APP/zip/$BRANCH | jar xv
cd $APP-$BRANCH
-mvn clean install
+mvn clean install -Dskip.staging -Dskip.nightly
mvn -pl webapp spring-boot:run</pre>
</p>
</div>
@@ -600,7 +608,7 @@ BRANCH=jpa
curl https://codeload.github.com/apache/$APP/zip/$BRANCH | jar xv
cd $APP-$BRANCH
-mvn clean install
+mvn clean install -Dskip.staging -Dskip.nightly
mvn spring-boot:run</pre>
</p>
</div>
@@ -612,7 +620,7 @@ BRANCH=jpa
curl https://codeload.github.com/apache/$APP/zip/$BRANCH | jar xv
cd $APP-$BRANCH
-mvn clean install
+mvn clean install -Dskip.staging -Dskip.nightly
mvn -pl webapp spring-boot:run</pre>
</p>
</div>
@@ -632,7 +640,7 @@ mvn -pl webapp spring-boot:run</pre>
<div class="row">
<div class="col-lg-12 text-left text-lg-left">
<p class="cta-text text-center" style="margin-block-end: 0; margin-top: 20px;">
- You can also explore the Apache Isis programming model through the demo app, running <a href="https://demo-wicket.isis.incode.work/" target="_blank">here</a>.
+ You can also explore the Apache Isis programming model through the demo app, running <a href="https://demo-wicket.jdo.isis.incode.work/" target="_blank">here (jdo)</a> or <a href="https://demo-wicket.jpa.isis.incode.work/" target="_blank">here (jpa)</a>.
</p>
</div>
</div>
[isis] 07/07: ISIS-3255: improves index.html a tiny bit
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch ISIS-3255
in repository https://gitbox.apache.org/repos/asf/isis.git
commit 7a6178a9ed3cb1426e92e79a891eb32dbd0b0595
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Thu Jan 5 16:38:44 2023 +0000
ISIS-3255: improves index.html a tiny bit
---
antora/supplemental-ui/index.html | 46 +++------------------------------------
1 file changed, 3 insertions(+), 43 deletions(-)
diff --git a/antora/supplemental-ui/index.html b/antora/supplemental-ui/index.html
index d63ae9a1a9..18754b33e5 100644
--- a/antora/supplemental-ui/index.html
+++ b/antora/supplemental-ui/index.html
@@ -551,13 +551,13 @@
<div class="col-lg-6 text-left text-lg-left">
<p class="cta-text text-center" style="margin-block-end: 0; ">
Learn about Apache Isis™ by running the minimal <a href="docs/latest/starters/helloworld.html">helloworld</a> starter app.
- You can see the app running <a href="https://helloworld-jdo.apps.causeway.dev/" target="_blank">here (jdo)</a> or <a href="https://helloworld-jpa-snapshot.apps.causeway.dev/" target="_blank">here (jpa)</a>.
+ You can see the app running <a href="https://helloworld-jpa-snapshot.apps.causeway.dev/" target="_blank">here (jpa)</a> or <a href="https://helloworld-jdo-snapshot.apps.causeway.dev/" target="_blank">here (jdo)</a>.
</p>
</div>
<div class="col-lg-6 text-left text-lg-left">
<p class="cta-text text-center" style="margin-block-end: 0; ">
Develop your own Apache Isis™ app with the structured <a href="docs/latest/starters/simpleapp.html">simpleapp</a> starter app.
- You can see the app running <a href="https://simpleapp-jdo.apps.causeway.dev/" target="_blank">here (jdo)</a> or <a href="https://simpleapp-jpa-snapshot.apps.causeway.dev/" target="_blank">here (jpa)</a>.
+ You can see the app running <a href="https://simpleapp-jpa-snapshot.apps.causeway.dev/" target="_blank">here (jpa)</a> or <a href="https://simpleapp-jdo-snapshot.apps.causeway.dev/" target="_blank">here (jdo)</a>.
</p>
</div>
</div>
@@ -640,50 +640,10 @@ mvn -pl webapp spring-boot:run</pre>
<div class="row">
<div class="col-lg-12 text-left text-lg-left">
<p class="cta-text text-center" style="margin-block-end: 0; margin-top: 20px;">
- You can also explore the Apache Isis programming model through the demo app, running <a href="https://demo-wicket-jdo-snapshot.apps.causeway.dev/" target="_blank">here (jdo)</a> or <a href="https://demo-wicket-jpa-snapshot.apps.causeway.dev/" target="_blank">here (jpa)</a>.
+ You can also explore the Apache Isis programming model through the demo app, running <a href="https://demo-wicket-jpa-snapshot.apps.causeway.dev/" target="_blank">here (jpa)</a> or <a href="https://demo-wicket-jdo-snapshot.apps.causeway.dev/" target="_blank">here (jdo)</a>.
</p>
</div>
</div>
-
-<!--
- <div class="row">
- <p class="cta-text text-center" style="margin-block-end: 0; margin-left: 20px; margin-top: 20px;">
- If you want to use the previous 1.x version, you can use these Maven archetypes.
- </p>
- <div class="col-lg-6 text-left text-lg-left">
- <p>
- <pre>
-mvn archetype:generate \
- -D archetypeGroupId=org.apache.isis.archetype \
- -D archetypeArtifactId=helloworld-archetype \
- -D archetypeVersion=1.17.0 \
- -D groupId=com.mycompany \
- -D artifactId=myapp \
- -D version=1.0-SNAPSHOT \
- -B
-
-mvn clean install
-mvn jetty:run</pre>
- </p>
- </div>
- <div class="col-lg-6 text-center text-lg-left">
- <p>
- <pre>
-mvn archetype:generate \
- -D archetypeGroupId=org.apache.isis.archetype \
- -D archetypeArtifactId=$APP-archetype \
- -D archetypeVersion=1.17.0 \
- -D groupId=com.mycompany \
- -D artifactId=myapp \
- -D version=1.0-SNAPSHOT \
- -B
-
-mvn clean install
-mvn -pl webapp jetty:run</pre>
- </p>
- </div>
- </div>
--->
</div>
</div>
</div>
[isis] 06/07: ISIS-3255: fixes up docs
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch ISIS-3255
in repository https://gitbox.apache.org/repos/asf/isis.git
commit 8e54f8a314b40b4bb66fc15c0f3a01521dbe0790
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Thu Jan 5 16:07:46 2023 +0000
ISIS-3255: fixes up docs
---
antora/components/conguide/antora.yml | 1 +
.../images/image-2023-01-03-08-31-58-018.png | Bin
.../images/image-2023-01-03-17-58-33-718.png | Bin
.../images/image-2023-01-03-18-07-57-499.png | Bin
.../images/image-2023-01-03-18-10-33-567.png | Bin
.../images/image-2023-01-03-18-16-01-614.png | Bin
.../images/image-2023-01-03-18-22-59-542.png | Bin
.../images/image-2023-01-03-18-27-32-832.png | Bin
.../images/image-2023-01-03-18-33-23-116.png | Bin
.../images/image-2023-01-04-06-23-41-099.png | Bin
.../images/image-2023-01-04-06-25-56-926.png | Bin
.../images/image-2023-01-04-06-26-42-960.png | Bin
.../images/image-2023-01-04-06-29-02-083.png | Bin
.../images/image-2023-01-04-06-31-36-293.png | Bin
.../images/image-2023-01-05-11-44-09-855.png | Bin
.../{nightlies => nightly-deploys}/nav.adoc | 2 +-
.../pages/about.adoc | 23 ++++++++-------------
.../partials/az-containerapp-create.adoc | 0
18 files changed, 11 insertions(+), 15 deletions(-)
diff --git a/antora/components/conguide/antora.yml b/antora/components/conguide/antora.yml
index 057398dd70..41acb00ea0 100644
--- a/antora/components/conguide/antora.yml
+++ b/antora/components/conguide/antora.yml
@@ -22,6 +22,7 @@ start_page: ROOT:about.adoc
nav:
- modules/ROOT/nav.adoc
- modules/documentation/nav.adoc
+- modules/nightly-deploys/nav.adoc
- modules/intellij/nav.adoc
- modules/eclipse/nav.adoc
- modules/git/nav.adoc
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-08-31-58-018.png b/antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-08-31-58-018.png
similarity index 100%
rename from antora/components/conguide/modules/nightlies/images/image-2023-01-03-08-31-58-018.png
rename to antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-08-31-58-018.png
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-17-58-33-718.png b/antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-17-58-33-718.png
similarity index 100%
rename from antora/components/conguide/modules/nightlies/images/image-2023-01-03-17-58-33-718.png
rename to antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-17-58-33-718.png
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-07-57-499.png b/antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-18-07-57-499.png
similarity index 100%
rename from antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-07-57-499.png
rename to antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-18-07-57-499.png
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-10-33-567.png b/antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-18-10-33-567.png
similarity index 100%
rename from antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-10-33-567.png
rename to antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-18-10-33-567.png
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-16-01-614.png b/antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-18-16-01-614.png
similarity index 100%
rename from antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-16-01-614.png
rename to antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-18-16-01-614.png
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-22-59-542.png b/antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-18-22-59-542.png
similarity index 100%
rename from antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-22-59-542.png
rename to antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-18-22-59-542.png
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-27-32-832.png b/antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-18-27-32-832.png
similarity index 100%
rename from antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-27-32-832.png
rename to antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-18-27-32-832.png
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-33-23-116.png b/antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-18-33-23-116.png
similarity index 100%
rename from antora/components/conguide/modules/nightlies/images/image-2023-01-03-18-33-23-116.png
rename to antora/components/conguide/modules/nightly-deploys/images/image-2023-01-03-18-33-23-116.png
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-23-41-099.png b/antora/components/conguide/modules/nightly-deploys/images/image-2023-01-04-06-23-41-099.png
similarity index 100%
rename from antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-23-41-099.png
rename to antora/components/conguide/modules/nightly-deploys/images/image-2023-01-04-06-23-41-099.png
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-25-56-926.png b/antora/components/conguide/modules/nightly-deploys/images/image-2023-01-04-06-25-56-926.png
similarity index 100%
rename from antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-25-56-926.png
rename to antora/components/conguide/modules/nightly-deploys/images/image-2023-01-04-06-25-56-926.png
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-26-42-960.png b/antora/components/conguide/modules/nightly-deploys/images/image-2023-01-04-06-26-42-960.png
similarity index 100%
rename from antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-26-42-960.png
rename to antora/components/conguide/modules/nightly-deploys/images/image-2023-01-04-06-26-42-960.png
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-29-02-083.png b/antora/components/conguide/modules/nightly-deploys/images/image-2023-01-04-06-29-02-083.png
similarity index 100%
rename from antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-29-02-083.png
rename to antora/components/conguide/modules/nightly-deploys/images/image-2023-01-04-06-29-02-083.png
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-31-36-293.png b/antora/components/conguide/modules/nightly-deploys/images/image-2023-01-04-06-31-36-293.png
similarity index 100%
rename from antora/components/conguide/modules/nightlies/images/image-2023-01-04-06-31-36-293.png
rename to antora/components/conguide/modules/nightly-deploys/images/image-2023-01-04-06-31-36-293.png
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-05-11-44-09-855.png b/antora/components/conguide/modules/nightly-deploys/images/image-2023-01-05-11-44-09-855.png
similarity index 100%
rename from antora/components/conguide/modules/nightlies/images/image-2023-01-05-11-44-09-855.png
rename to antora/components/conguide/modules/nightly-deploys/images/image-2023-01-05-11-44-09-855.png
diff --git a/antora/components/conguide/modules/nightlies/nav.adoc b/antora/components/conguide/modules/nightly-deploys/nav.adoc
similarity index 93%
rename from antora/components/conguide/modules/nightlies/nav.adoc
rename to antora/components/conguide/modules/nightly-deploys/nav.adoc
index 744f63c485..e61de46b3e 100644
--- a/antora/components/conguide/modules/nightlies/nav.adoc
+++ b/antora/components/conguide/modules/nightly-deploys/nav.adoc
@@ -1,4 +1,4 @@
:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
-* xref:conguide:nightlies:about.adoc[Nightlies]
+* xref:nightly-deploys:about.adoc[Nightly Deploys]
diff --git a/antora/components/conguide/modules/nightlies/pages/about.adoc b/antora/components/conguide/modules/nightly-deploys/pages/about.adoc
similarity index 94%
rename from antora/components/conguide/modules/nightlies/pages/about.adoc
rename to antora/components/conguide/modules/nightly-deploys/pages/about.adoc
index 692e995778..dd4b108d19 100644
--- a/antora/components/conguide/modules/nightlies/pages/about.adoc
+++ b/antora/components/conguide/modules/nightly-deploys/pages/about.adoc
@@ -1,14 +1,12 @@
[[nightlies]]
-= Nightlies
+= Nightly Deploys
:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
:page-partial:
-This page describes how we deploy the xref:docs:starters:simpleapp.adoc[], xref:docs:starters:helloworld.adoc[HelloWorld App] and the xref:docs:demo:about.adoc[] each night.
+This page describes how we deploy the xref:docs:starters:simpleapp.adoc[], xref:docs:starters:helloworld.adoc[HelloWorld App] and the xref:docs:demo:about.adoc[] each night, to a Azure App Container Apps (a PaaS based on top of k8s).
-WARNING: work in progress
-
-The intention is to use link:https://learn.microsoft.com/en-gb/azure/container-apps/[Azure Container Apps] (hereafter ACA).
+The actual CI jobs can be found in the link:https://github.com/apache-causeway-committers/causeway-nightly-deploys[apache-causeway-committers/causeway-nightly-deploys] repo.
== Azure Container Apps
@@ -296,9 +294,6 @@ APP_NAME="demo-wicket-jpa-snapshot"
IMAGE_NAME="apacheisis/demo-wicket-jpa"
IMAGE_VERSION="latest"
----
-+
-NOTE: Hmm, looks like there's an issue with our generation of the image version, missing the sha Id suffix.
-But this image _does_ exist.
* Deploy
+
@@ -353,9 +348,6 @@ APP_NAME="demo-wicket-jdo-snapshot"
IMAGE_NAME="apacheisis/demo-wicket-jdo"
IMAGE_VERSION="latest"
----
-+
-NOTE: Hmm, looks like there's an issue with our generation of the image version, missing the sha Id suffix.
-But this image _does_ exist.
* Deploy
+
@@ -577,8 +569,8 @@ to `helloworld-jdo-snapshot.apps.causeway.dev`
== Automation
-The nightly automation simply needs to update the apps with new images, using `az container revision copy`.
-There is no need to create ACA environments etc from scratch.
+With all of the applications created above, the nightly automation simply needs to update the apps with new images, using `az container revision copy`.
+There is *_no need_* to create ACA environments etc from scratch.
=== Prereqs
@@ -622,12 +614,15 @@ The output includes credentials that you must protect. Be sure that you do not i
=== CI Jobs
-The CI jobs can be found in link:https://github.com/apache-causeway-committers/causeway-nightly-deploys[apache-causeway-committers/causeway-nightly-deploys].
+The actual CI jobs can be found in the link:https://github.com/apache-causeway-committers/causeway-nightly-deploys[apache-causeway-committers/causeway-nightly-deploys] repo.
The main script consists of these commands:
[source,bash]
----
+# ... derive $APPNAME
+# ... derive $IMAGE
+
TIMESTAMP=$(date "+%Y%m%d-%H%M%S")
REVISION_SUFFIX="r${TIMESTAMP}"
diff --git a/antora/components/conguide/modules/nightlies/partials/az-containerapp-create.adoc b/antora/components/conguide/modules/nightly-deploys/partials/az-containerapp-create.adoc
similarity index 100%
rename from antora/components/conguide/modules/nightlies/partials/az-containerapp-create.adoc
rename to antora/components/conguide/modules/nightly-deploys/partials/az-containerapp-create.adoc
[isis] 02/07: ISIS-3255: adds docs on using ACA to host nightlies
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch ISIS-3255
in repository https://gitbox.apache.org/repos/asf/isis.git
commit fac142c539f08b79ea0575f17cebd36ca27eef36
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Tue Jan 3 08:34:38 2023 +0000
ISIS-3255: adds docs on using ACA to host nightlies
---
.../images/image-2023-01-02-11-10-57-742.png | Bin 0 -> 399828 bytes
.../images/image-2023-01-02-11-15-22-937.png | Bin 0 -> 177254 bytes
.../images/image-2023-01-02-11-37-15-599.png | Bin 0 -> 277941 bytes
.../images/image-2023-01-02-11-39-16-947.png | Bin 0 -> 123243 bytes
.../images/image-2023-01-02-11-41-34-824.png | Bin 0 -> 53087 bytes
.../images/image-2023-01-02-18-54-07-844.png | Bin 0 -> 44438 bytes
.../images/image-2023-01-02-18-55-22-599.png | Bin 0 -> 43113 bytes
.../images/image-2023-01-02-18-57-10-836.png | Bin 0 -> 30196 bytes
.../images/image-2023-01-03-08-31-58-018.png | Bin 0 -> 77018 bytes
.../components/conguide/modules/nightlies/nav.adoc | 4 +
.../conguide/modules/nightlies/pages/about.adoc | 430 +++++++++++++++++++++
11 files changed, 434 insertions(+)
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-10-57-742.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-10-57-742.png
new file mode 100644
index 0000000000..e07f4a0203
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-10-57-742.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-15-22-937.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-15-22-937.png
new file mode 100644
index 0000000000..acc9c9624a
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-15-22-937.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-37-15-599.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-37-15-599.png
new file mode 100644
index 0000000000..a4fac01fc6
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-37-15-599.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-39-16-947.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-39-16-947.png
new file mode 100644
index 0000000000..d373338784
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-39-16-947.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-41-34-824.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-41-34-824.png
new file mode 100644
index 0000000000..e55eb0e9e0
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-41-34-824.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-54-07-844.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-54-07-844.png
new file mode 100644
index 0000000000..58659be179
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-54-07-844.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-55-22-599.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-55-22-599.png
new file mode 100644
index 0000000000..b67fb6242f
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-55-22-599.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-57-10-836.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-57-10-836.png
new file mode 100644
index 0000000000..127baf44c5
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-57-10-836.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-08-31-58-018.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-08-31-58-018.png
new file mode 100644
index 0000000000..ed5aaa58db
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-08-31-58-018.png differ
diff --git a/antora/components/conguide/modules/nightlies/nav.adoc b/antora/components/conguide/modules/nightlies/nav.adoc
new file mode 100644
index 0000000000..744f63c485
--- /dev/null
+++ b/antora/components/conguide/modules/nightlies/nav.adoc
@@ -0,0 +1,4 @@
+
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
+
+* xref:conguide:nightlies:about.adoc[Nightlies]
diff --git a/antora/components/conguide/modules/nightlies/pages/about.adoc b/antora/components/conguide/modules/nightlies/pages/about.adoc
new file mode 100644
index 0000000000..d9c99f0587
--- /dev/null
+++ b/antora/components/conguide/modules/nightlies/pages/about.adoc
@@ -0,0 +1,430 @@
+[[nightlies]]
+= Nightlies
+
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
+:page-partial:
+
+This page describes how we deploy the xref:docs:starters:simpleapp.adoc[], xref:docs:starters:helloworld.adoc[HelloWorld App] and the xref:docs:demo:about.adoc[] each night.
+
+WARNING: work in progress
+
+The intention is to use link:https://learn.microsoft.com/en-gb/azure/container-apps/[Azure Container Apps].
+
+== Azure Container Apps
+
+Following link:https://learn.microsoft.com/en-gb/azure/container-apps/get-started?ocid=AID3042118&tabs=bash[azure docs] for ACA
+
+=== Prereqs
+
+* link:https://learn.microsoft.com/en-us/cli/azure/install-azure-cli[install Azure CLI]
+
+=== Authenticate
+
+Authenticate and prepare working environment
+
+* login
++
+[source,bash]
+----
+az login
+----
++
+Confirm using web browser.
+
+* add ACA extension
++
+[source,bash]
+----
+az extension add --name containerapp --upgrade
+----
++
+This takes a minute or two.
+
+* register the `Microsoft.OperationalInsights` provider for the Azure Monitor Log Analytics workspace
++
+[source,bash]
+----
+az provider register --namespace Microsoft.OperationalInsights
+----
++
+(as have not used it before).
+
+
+
+=== Setup
+
+Create a resource group to organize the services related to the container apps.
+
+* set the environment variables:
++
+[source,bash]
+----
+RESOURCE_GROUP="causeway-nightlies-rg"
+LOCATION="uksouth"
+----
+
+* create the resource group
++
+[source,bash]
+----
+az group create \
+ --name $RESOURCE_GROUP \
+ --location $LOCATION
+----
++
+resulting in:
++
+[source,bash]
+----
+{
+ "id": "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg",
+ "location": "ukwest",
+ "managedBy": null,
+ "name": "causeway-nightlies-rg",
+ "properties": {
+ "provisioningState": "Succeeded"
+ },
+ "tags": null,
+ "type": "Microsoft.Resources/resourceGroups"
+}
+----
+
+=== Create an environment
+
+An environment in Azure Container Apps creates a secure boundary around a group of container apps.
+Container Apps deployed to the same environment are deployed in the same virtual network and write logs to the same Log Analytics workspace.
+
+* set a further environment variable:
++
+[source,bash]
+----
+CONTAINERAPPS_ENVIRONMENT="causeway-nightlies-aca-env"
+----
+
+* xxx
++
+[source,bash]
+----
+az containerapp env create \
+ --name $CONTAINERAPPS_ENVIRONMENT \
+ --resource-group $RESOURCE_GROUP \
+ --location $LOCATION
+----
++
+resulting in:
++
+[source,bash]
+----
+No Log Analytics workspace provided.
+Generating a Log Analytics workspace with name "workspace-causewaynightliesrgT0WN"
+
+Container Apps environment created. To deploy a container app, use: az containerapp create --help
+
+{
+ "id": "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg/providers/Microsoft.App/managedEnvironments/causeway-nightlies-aca-env",
+ "location": "uksouth",
+ "name": "causeway-nightlies-aca-env",
+ "properties": {
+ "appLogsConfiguration": {
+ "destination": "log-analytics",
+ "logAnalyticsConfiguration": {
+ "customerId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+ }
+ },
+ "customDomainConfiguration": {
+ "customDomainVerificationId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
+ },
+ "defaultDomain": "graytree-90c75749.uksouth.azurecontainerapps.io",
+ "provisioningState": "Succeeded",
+ "staticIp": "20.108.221.167",
+ "zoneRedundant": false
+ },
+ "resourceGroup": "causeway-nightlies-rg",
+ "sku": {
+ "name": "Consumption"
+ },
+ "systemData": {
+ "createdAt": "2023-01-02T06:54:25.6911574",
+ "createdBy": "dan@haywood-associates.co.uk",
+ "createdByType": "User",
+ "lastModifiedAt": "2023-01-02T06:54:25.6911574",
+ "lastModifiedBy": "dan@haywood-associates.co.uk",
+ "lastModifiedByType": "User"
+ },
+ "type": "Microsoft.App/managedEnvironments"
+}
+----
+
+=== Create container apps
+
+For link:https://hub.docker.com/repository/docker/apacheisis/demo-wicket-jpa[apacheisis/demo-wicket-jpa]
+
+* set a further environment variables:
++
+[source,bash]
+----
+APP_NAME="demo-wicket-jpa"
+IMAGE_NAME="apacheisis/demo-wicket-jpa"
+IMAGE_VERSION="2.0.0-M9.20221224-0226-7c658a3c"
+----
+
+* create the app
++
+[source,bash]
+----
+az containerapp create \
+ --name $APP_NAME \
+ --resource-group $RESOURCE_GROUP \
+ --environment $CONTAINERAPPS_ENVIRONMENT \
+ --image $IMAGE_NAME:$IMAGE_VERSION \
+ --target-port 8080 \
+ --ingress 'external' \
+ --query properties.configuration.ingress.fqdn
+----
++
+resulting in:
++
+[source,bash]
+----
+Container app created. Access your app at https://demo-wicket-jpa.graytree-90c75749.uksouth.azurecontainerapps.io/
+----
+
+=== Update the app
+
+* update the environment variables:
++
+[source,bash]
+----
+IMAGE_VERSION="2.0.0-M9.20221229-0233-"
+----
++
+NOTE: looks like there's an issue with our generation of the image version, missing the sha Id suffix.
+
+* Update the image
++
+[source,bash]
+----
+az containerapp update \
+ --name $APP_NAME \
+ --resource-group $RESOURCE_GROUP \
+ --image $IMAGE_NAME:$IMAGE_VERSION
+----
++
+resulting in:
++
+[source,bash]
+----
+{
+ "id": "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg/providers/Microsoft.App/containerapps/demo-wicket-jpa",
+ "identity": {
+ "type": "None"
+ },
+ "location": "UK South",
+ "name": "demo-wicket-jpa",
+ "properties": {
+ "configuration": {
+ "activeRevisionsMode": "Single",
+ "dapr": null,
+ "ingress": {
+ "allowInsecure": false,
+ "customDomains": null,
+ "exposedPort": 0,
+ "external": true,
+ "fqdn": "demo-wicket-jpa.graytree-90c75749.uksouth.azurecontainerapps.io",
+ "ipSecurityRestrictions": null,
+ "targetPort": 8080,
+ "traffic": [
+ {
+ "latestRevision": true,
+ "weight": 100
+ }
+ ],
+ "transport": "Auto"
+ },
+ "maxInactiveRevisions": null,
+ "registries": null,
+ "secrets": null
+ },
+ "customDomainVerificationId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
+ "environmentId": "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg/providers/Microsoft.App/managedEnvironments/causeway-nightlies-aca-env",
+ "eventStreamEndpoint": "https://uksouth.azurecontainerapps.dev/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg/containerApps/demo-wicket-jpa/eventstream",
+ "latestRevisionFqdn": "demo-wicket-jpa--hg9md16.graytree-90c75749.uksouth.azurecontainerapps.io",
+ "latestRevisionName": "demo-wicket-jpa--hg9md16",
+ "managedEnvironmentId": "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg/providers/Microsoft.App/managedEnvironments/causeway-nightlies-aca-env",
+ "outboundIpAddresses": [
+ "20.108.221.63"
+ ],
+ "provisioningState": "Succeeded",
+ "template": {
+ "containers": [
+ {
+ "image": "apacheisis/demo-wicket-jpa:2.0.0-M9.20221224-0226-7c658a3c",
+ "name": "demo-wicket-jpa",
+ "resources": {
+ "cpu": 0.5,
+ "ephemeralStorage": "1Gi",
+ "memory": "1Gi"
+ }
+ }
+ ],
+ "initContainers": null,
+ "revisionSuffix": "",
+ "scale": {
+ "maxReplicas": 10,
+ "minReplicas": null,
+ "rules": null
+ },
+ "volumes": null
+ },
+ "workloadProfileType": null
+ },
+ "resourceGroup": "causeway-nightlies-rg",
+ "systemData": {
+ "createdAt": "2023-01-02T07:06:17.4141558",
+ "createdBy": "dan@haywood-associates.co.uk",
+ "createdByType": "User",
+ "lastModifiedAt": "2023-01-02T07:12:31.4804896",
+ "lastModifiedBy": "dan@haywood-associates.co.uk",
+ "lastModifiedByType": "User"
+ },
+ "type": "Microsoft.App/containerApps"
+}
+----
+
+== Custom domain
+
+=== Create self-signed certificate
+
+* create `
++
+[source,bash]
+----
+openssl req -new -newkey RSA:2048 -nodes -keyout ssl.key -out ssl.csr
+----
++
+resulting in:
++
+[source,bash]
+----
+Generating a RSA private key
+...............................+++++
+.+++++
+writing new private key to 'ssl.key'
+-----
+You are about to be asked to enter information that will be incorporated
+into your certificate request.
+What you are about to enter is what is called a Distinguished Name or a DN.
+There are quite a few fields but you can leave some blank
+For some fields there will be a default value,
+If you enter '.', the field will be left blank.
+-----
+Country Name (2 letter code) [AU]:UK
+State or Province Name (full name) [Some-State]:Worcestershire
+Locality Name (eg, city) []:Malvern
+Organization Name (eg, company) [Internet Widgits Pty Ltd]:Haywood Associates Ltd.
+Organizational Unit Name (eg, section) []:
+Common Name (e.g. server FQDN or YOUR name) []:*.isis.incode.work
+Email Address []:dan@haywood-associates.co.uk
+
+Please enter the following 'extra' attributes
+to be sent with your certificate request
+A challenge password []:
+An optional company name []:Haywood Associates Ltd.
+----
++
+which results in two files:
+
+** `ssl.csr`
+** `ssl.key`
+
+* create the `.crt` self-signed certificate:
++
+[source,bash]
+----
+openssl x509 -req -days 365 -in ssl.csr -signkey ssl.key -out ssl.crt
+----
++
+resulting in:
++
+[source,bash]
+----
+Signature ok
+subject=C = UK, ST = Worcestershire, L = Malvern, O = Haywood Associates Ltd., CN = *.isis.incode.work, emailAddress = dan@haywood-associates.co.uk
+Getting Private key
+----
++
+and the additional file:
+
+** `ssl.crt`
+
+
+* convert to a PKCS12 (`.pfx`) file
++
+[source,bash]
+----
+openssl pkcs12 -inkey ssl.key -in ssl.crt -export -out ssl.pfx
+----
++
+resulting in:
++
+[source,bash]
+----
+Enter Export Password:
+Verifying - Enter Export Password:
+----
++
+and the additional file:
+
+** `ssl.pfx`
+
+
+
+=== Add Custom domain and bind to cert
+
+As per MS docs on https://learn.microsoft.com/en-us/azure/container-apps/custom-domains-certificates[adding custom domain & certificates]
+
+in Azure Portal:
+
+* locate IP:
++
+image::image-2023-01-02-11-10-57-742.png[width=800px]
+
+* add custom domain:
++
+image::image-2023-01-02-11-15-22-937.png[width=400]
+
+in DNS nameserver (eg held by registrar)
+
+* add DNS records:
++
+image::image-2023-01-02-11-37-15-599.png[width=800]
+
+in Azure Portal:
+
+* validate:
++
+image::image-2023-01-02-11-39-16-947.png[width=400]
+
+* next:
++
+image::image-2023-01-02-11-41-34-824.png[width=400]
+
+* use `create new` link
++
+upload the .pfx file created earlier, and validate:
++
+image::image-2023-01-02-18-54-07-844.png[width=400]
+
+* confirm
++
+image::image-2023-01-02-18-55-22-599.png[width=400]
+
+* listed:
++
+image::image-2023-01-02-18-57-10-836.png[width=800]
+
+
+* Change scaling from default (1-10) to just a single instance.
++
+image::image-2023-01-03-08-31-58-018.png[width=600]
+