Skip to content

Commit 8e21456

Browse files
authored
Updated README.md with screenshots
1 parent fbd539f commit 8e21456

File tree

1 file changed

+50
-9
lines changed

1 file changed

+50
-9
lines changed

extensions/azure-stack-edge/README.md

Lines changed: 50 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,29 +8,70 @@ Prerequisites:
88
* You have access to a [fully functional ASE with internet access and allocated sufficient IP address space for k8s services](https://docs.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-deploy-configure-network-compute-web-proxy#enable-compute-network) exopsed on your local network.
99
* [Create a new user and namespace with proper RBAC on ASE k8s](https://docs.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-create-kubernetes-cluster).
1010
* [Enable edge container registry on ASE](https://docs.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-edge-container-registry).
11-
* Install Helm3 on your build agent.
11+
* [Install latest stable Helm](https://helm.sh/docs/intro/install/) on your build agent.
12+
* Your build agent should have network connectivity to reach the k8s cluster on ASE.
1213
* **Optional**: You can [create a VM on ASE](https://docs.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-deploy-virtual-machine-portal) and use it as the ADO agent for building and deploying the Claims API.
1314

1415
Steps:
15-
1. Create a new branch (e.g. "ase-test") on GitHub.
16-
2. Checkout the new branch.
16+
1. [Create a new branch](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository) (e.g. "ase-test") on GitHub.
17+
2. [Checkout](https://git-scm.com/book/en/v2/Git-Branching-Basic-Branching-and-Merging) the new branch.
1718
3. Rename your existing claims-api directory to **aks-aspnet-sqldb-rest/claims-api.orig**.
1819
4. Copy **aks-aspnet-sqldb-rest/extensions/azure-stack-edge/claims-api** to **aks-aspnet-sqldb-rest/claims-api**.
19-
5. Make necessary changes under "imageCredentials" in **values.yaml**.
20+
5. Make necessary changes (registry url, username, password, email) under "imageCredentials" in **values.yaml**.
2021
6. Commit and push changes to new branch.
21-
7. Go to the ADO project and update the build pipeline using new branch (instead of master).
22-
8. Create a new container registry service connection for your edge container registry and update the build pipeline (e.g. "https://ecr.dbe-70c9r53.microsoftdatabox.com:31001/").
23-
9. Create a new Kubernetes service connection using the kubeconfig file for the user who's grant access to the namespace for deployment.
22+
7. Go to the ADO project and update the build pipeline using your new branch (instead of master):
23+
![EXT-ase-branch](https://user-images.githubusercontent.com/15071173/113321960-f9621000-92c8-11eb-81d2-a6aaa87e2a0f.png)
24+
8. Create a new container registry service connection for your edge container registry and update the build pipeline (e.g. "https://ecr.dbe-70c9r53.microsoftdatabox.com:31001/"):
25+
![EXT-ase-cr](https://user-images.githubusercontent.com/15071173/113322028-0b43b300-92c9-11eb-8b61-65a5a4e7d64d.png)
26+
9. Create a new Kubernetes service connection using the KubeConfig file for the user who's grant access to the namespace for deployment:
27+
![EXT-ase-kubeconfig](https://user-images.githubusercontent.com/15071173/113322064-13035780-92c9-11eb-825d-22817c39f826.png)
2428
10. In the release pipeline, edit the namespace and use the one you created for Claims API deployment.
25-
11. Run pipeline and verify result:
29+
11. Run pipeline and verify result with curl:
2630
```bash
2731
azureuser@Ubuntu1804:~$ helm ls -n claims-api-dev
2832
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
2933
aks-aspnetcore-lab claims-api-dev 1 2021-03-31 23:44:33.354484376 +0000 UTC deployed claims-api-0.1.0 1.0
3034
azureuser@Ubuntu1804:~$ kubectl get services -n claims-api-dev
3135
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
3236
claims-api-svc LoadBalancer 172.28.121.185 192.168.1.9 80:31608/TCP 154m
37+
azureuser@Ubuntu1804:~$ curl -i http://192.168.1.9/api/v1/claims
38+
HTTP/1.1 200 OK
39+
Date: Thu, 01 Apr 2021 15:41:39 GMT
40+
Content-Type: application/json; charset=utf-8
41+
Server: Kestrel
42+
Transfer-Encoding: chunked
43+
X-Pod-IpAddr: 172.27.114.62
44+
45+
[{"claimItemId":100,"claimStatus":"02","claimType":"InstClaim","senderID":"CLPCSVNTEST2","receiverID":"APPCSVNTEST1","originatorID":"ORGNCSVTEST1","destinationID":"DESMEDSTEST1","claimInputMethod":"E","subscriberInfo":[{"subscriberInfoId":100,"subscriberRelationship":"18","subscriberPolicyNumber":"12345","insuredGroupName":"MD000004","subscriberLastName":"Doe","subscriberFirstName":"John","subscriberMiddleName":"","subscriberIdentifierSSN":"489-88-7001","subscriberAddressLine1":"5589 Hawthorne Way","subscriberAddressLine2":"","subscriberCity":"Sacramento","subscriberState":"CA","subscriberPostalCode":"95835","subscriberCountry":"US","subDateOfBirth":"12-19-1984","subscriberGender":"Male","payerName":"","patientLastName":"","patientFirstName":"","patientSSN":"489-88-7001","patientMemberID":"12345","patientDOB":"12-19-1984","patientGender":"Male","catgOfService":"Consultation","claimItemId":100}],"claimNumber":"1234121235","totalClaimCharge":1234.50,"patientStatus":"01","patientAmountDue":0.00,"serviceDate":"0001-01-01T00:00:00","policyNumber":"898435","claimPaidDate":"2021-02-03T00:06:38.4030071","serviceLineDetails":[{"serviceLineDetailsId":100,"statementDate":"2018-10-31T08:30:00","lineCounter":1,"serviceCodeDescription":"INPT","lineChargeAmount":15000.00,"drugCode":"UN","drugUnitQuantity":23,"pharmacyPrescriptionNumber":"123897","serviceType":"Consultation","providerCode":"72","providerLastName":"Longhorn","providerFirstName":"Dr. James","providerIdentification":"20120904-20120907","inNetworkIndicator":true,"claimItemId":100}],"planPayment":[{"planPaymentId":100,"primaryPayerID":"MEDICAID","cobServicePaidAmount":15000.00,"serviceCode":"ABC","paymentDate":"2021-02-03T00:00:00","claimAdjGroupCode":"HIPAA","claimAdjReasonCode":"CO","claimAdjAmount":500.00,"claimAdjQuantity":"3","claimItemId":100}]}]
3346
```
3447

3548
Notes:
36-
* Since we are using the edge container registry instead of ACR, we will need to create imagePullSecret on k8s to store the credentials. This is handled by helm 3 charts.
49+
* Since we are using the edge container registry (ECR) instead of ACR, we will need to create imagePullSecret on k8s to store the ECR credential "**regcred**", see below:
50+
```bash
51+
azureuser@Ubuntu1804:~$ kubectl get secrets -n claims-api-dev
52+
NAME TYPE DATA AGE
53+
default-token-424lf kubernetes.io/service-account-token 3 4d20h
54+
regcred kubernetes.io/dockerconfigjson 1 15h
55+
sec-smbcredentials microsoft.com/smb 2 46h
56+
sh.helm.release.v1.aks-aspnetcore-lab.v1 helm.sh/release.v1 1 15h
57+
azureuser@Ubuntu1804:~$ kubectl get secret regcred -n claims-api-dev --output=yaml
58+
apiVersion: v1
59+
data:
60+
.dockerconfigjson: eyJhdXRocyI6eyJodHRwczovL2Vjci5kYmUtNzBjOXI1My5taWNyb3NvZnRkYXRhYm94LmNvbTozMTAwMSI6eyJ1c2VybmFtZSI6ImFzZS1lY3ItdXNlciIsInBhc3N3b3JkIjoiTG5KbFF5V0owZlRXNEZsIiwiZW1haWwiOiJrOHNhZG1pbkByZWRvbmRvYXNlLm9yZyIsImF1dGgiOiJZWE5sTFdWamNpMTFjMlZ5T2t4dVNteFJlVmRLTUdaVVZ6UkdiQT09In19fQ==
61+
kind: Secret
62+
metadata:
63+
annotations:
64+
meta.helm.sh/release-name: aks-aspnetcore-lab
65+
meta.helm.sh/release-namespace: claims-api-dev
66+
creationTimestamp: "2021-03-31T23:44:33Z"
67+
labels:
68+
app.kubernetes.io/managed-by: Helm
69+
name: regcred
70+
namespace: claims-api-dev
71+
resourceVersion: "394062"
72+
selfLink: /api/v1/namespaces/claims-api-dev/secrets/regcred
73+
uid: 1ce2902e-78b3-433b-a289-f6c0fa2b655c
74+
type: kubernetes.io/dockerconfigjson
75+
```
76+
* Seeing is believing:
77+
![InkedEXT-ase-redondo_LI](https://user-images.githubusercontent.com/15071173/113322952-34b10e80-92ca-11eb-890c-c065b3d37433.jpg)

0 commit comments

Comments
 (0)