Skip to content

Commit

Permalink
Merge pull request #959 from ArmDeveloperEcosystem/main
Browse files Browse the repository at this point in the history
Production update
  • Loading branch information
pareenaverma authored May 31, 2024
2 parents 025643e + 9c40693 commit 3f9043f
Show file tree
Hide file tree
Showing 78 changed files with 2,531 additions and 205 deletions.
156 changes: 155 additions & 1 deletion .wordlist.txt
Original file line number Diff line number Diff line change
Expand Up @@ -2704,4 +2704,158 @@ mprof
rustc
binutils
RPi
GoogleTest
GoogleTest
InstallAzureCLIDeb
sL
ExecuTorch
LLaMA
Eigen
Eigen's
eigen
UB
FX
Benoît
Guennebaud
KOffice
ACL
MKL
NCCL
NUMA
Preconfigured
bazelrc
configs
mkl
nogcp
nonccl
numa
SendNotification
SNS
sns
SendNotification
subscribeEmailToTopic
AWSthat
Altivec
AmazonSNSFullAccess
AppleClang
Arnaud
Bcmake
CERN
CMakeFiles
Calligra
Celestia
Chari
CodeBlocks
CodeLite
DEIGEN
DEXECUTORCH
DNDEBUG
DONT
DPYTHON
EQ
GTest
GTestConfig
GTestConfigVersion
GTestTargets
Grandmaison
Groupwise
Hadron
Homebrew
Ieigen
Krita
LDLT
LHC
LLT
LM
LlamaDemo
MSA
MatComp
MeshLab
Meta's
Miniconda
Mul
NxM
PTHREAD
PTQ
ROCm
SMS
SNSClient
SNSFull
SYCL
Sqrt
TTK
TutorialMatrixClass
Unary
VSX
Varun
WikiText
Wikitext
Wno
XNNPACK
Xcode
ZZZZZ
activations
belows
binaryOperator
booleanConversion
ccache
chatbots
copyAssign
copyConstruct
createSnsTopic
decompositions
defaultConstruct
embeddings
executorch
extendability
fillConstruct
functionalAdd
functionalDotProduct
functionalSub
getElement
getNumColumns
getNumElements
getNumRows
getSizeInBytes
getVersion
gmock
googlemock
googletest
gradle
groupsize
groupsizes
groupwise
gtest
hardcoded
homebrew
inPlaceAdd
inPlaceDotProduct
inPlaceSub
initializerListAssign
initializerListConstruct
libeigen
libexec
libgmock
libgtest
linkers
markos
matchers
minimalistic
mjs
moveAssign
moveConstruct
notEqual
params
pkgconfig
pretrained
representable
setElement
sqrt
tiktoken
tokenizer
torchao
typedefs
unary
unaryOperator
uninitializedConstruct
whitepapers
xN
47 changes: 42 additions & 5 deletions content/install-guides/azure-cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,11 +25,13 @@ It is available for a variety of operating systems and Linux distributions and h

## Before you begin

[General installation information](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli-linux?pivots=apt) is available which covers all supported Linux distributions. The instructions state that Azure CLI doesn't support Linux on Arm.
[General installation information](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli-linux?pivots=apt) is available which covers all supported Linux distributions. Starting with version 2.46.0, Azure CLI supports Arm64 Linux distributions. The 'apt' package manager contains both x86_64 and Arm64 packages for the following linux distributions

It's likely Arm support will come soon, monitor the [GitHub issue](https://github.com/Azure/azure-cli/issues/7368) for new details.
```output
Ubuntu 20.04, Ubuntu 22.04, Ubuntu 24.04
```

This article provides a quick solution to install Azure CLI for Ubuntu on Arm.
## Install via Azure CLI script

Confirm you are using an Arm machine by running:

Expand All @@ -45,9 +47,34 @@ aarch64

If you see a different result, you are not using an Arm computer running 64-bit Linux.

## Download and Install
You can install Azure CLI using the following script. This script pulls required Arm64 packages and installs those on the system

```bash { target="ubuntu:latest" }
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash
```

Execute the following command to verify the Azure CLI is installed correctly

```bash { target="ubuntu:latest" }
az version
```

The easiest way to install Azure CLI for Ubuntu on Arm is to use Python pip.
You should see an output similar to below

```output
{
"azure-cli": "2.61.0",
"azure-cli-core": "2.61.0",
"azure-cli-telemetry": "1.1.0",
"extensions": {}
}
```

If you prefer installing the Azure CLI using Python3, follow the instructions below.

## Download and Install using pip

Another way to install Azure CLI for Ubuntu on Arm is to use Python pip.

Install Python pip.

Expand All @@ -67,5 +94,15 @@ The pip install updates $HOME/.profile with the path the `az` executable. Check
source $HOME/.profile
az version
```
You should see an output similar to below

```output
{
"azure-cli": "2.61.0",
"azure-cli-core": "2.61.0",
"azure-cli-telemetry": "1.1.0",
"extensions": {}
}
```

After a successful log in, you can use the [Azure CLI](../azure-cli) and automation tools like [Terraform](../terraform) from the terminal.
9 changes: 5 additions & 4 deletions content/install-guides/docker/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,12 +20,13 @@ layout: installtoolsall # DO NOT MODIFY. Always true for tool install ar
Docker containers are widely used, primarily because they run the same everywhere. Containers are used on all operating systems, on all computing architectures, to build, share, and run software.

The operating system of the computer and the architecture (x86 or Arm) determines how to install Docker.

### How do I install Docker on Linux and Chrome OS?

- Docker Engine on Linux runs on a variety of Linux distributions and architectures, including arm32v7 and arm64v8 (AArch64). Use these instructions for Linux and Chrome OS (using the Linux feature).
- Docker Engine on Linux runs on a variety of Linux distributions and architectures, including arm32v7 and arm64v8 (AArch64). Use these instructions for Linux and Chrome OS (using the Linux feature). This includes the Windows Subsystem for Linux 2 (WSL 2).

### How do I install Docker on Windows and macOS?

- Docker Desktop is the easiest way to install Docker on Windows and macOS. The macOS version supports both Intel and Apple Silicon. The Windows version does not support Windows on Arm. There is also a new Docker Desktop for Linux available if your machine has KVM support and is running a KDE or Gnome desktop environment.

- Docker on Windows on Arm runs on Windows on Arm machines using the Windows Subsystem for Linux 2 (WSL 2). There is no Docker Desktop for Windows on Arm, [please show your support by asking for it](https://github.com/docker/roadmap/issues/91).
- Docker Desktop is the easiest way to install Docker on Windows and macOS. The macOS version supports both Intel and Apple Silicon.
- The Windows on Arm version of Docker Desktop was announced at Microsoft Build 2024.
- Docker Desktop for Linux is available if your machine has KVM support and is running a KDE or Gnome desktop environment.
6 changes: 4 additions & 2 deletions content/install-guides/docker/docker-desktop.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ additional_search_terms:
- virtual machines

### Estimated completion time in minutes (please use integer multiple of 5)
minutes_to_complete: 30
minutes_to_complete: 15

author_primary: Jason Andrews

Expand All @@ -22,6 +22,7 @@ multi_install: false # Set to true if first page of multi-page articl
multitool_install_part: true # Set to true if a sub-page of a multi-page article, else false
layout: installtoolsall # DO NOT MODIFY. Always true for tool install articles
---

## How do I install and test Docker Desktop?

All of the download files are available on the
Expand All @@ -47,7 +48,7 @@ This message shows that your installation appears to be working correctly.
To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(arm64v8)
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
Expand All @@ -67,6 +68,7 @@ Use the `uname` command to identify the architecture:
```console
uname -m
```

Apple Silicon is reported as `arm64`.

Docker Engine is now ready to use. You can explore [Docker related Learning Paths](/tag/docker/).
Expand Down
2 changes: 1 addition & 1 deletion content/install-guides/docker/docker-engine.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ additional_search_terms:
- virtual machines

### Estimated completion time in minutes (please use integer multiple of 5)
minutes_to_complete: 30
minutes_to_complete: 15

author_primary: Jason Andrews

Expand Down
54 changes: 14 additions & 40 deletions content/install-guides/docker/docker-woa.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ additional_search_terms:
- virtual machines

### Estimated completion time in minutes (please use integer multiple of 5)
minutes_to_complete: 30
minutes_to_complete: 15

author_primary: Jason Andrews

Expand All @@ -25,54 +25,34 @@ layout: installtoolsall # DO NOT MODIFY. Always true for tool install ar

## How do I install Docker for Windows on Arm {#docker-woa}?

Docker can be run on Windows on Arm machines using the Windows Subsystem for Linux 2 (WSL2).
Docker Desktop on Windows requires WSL 2 or Hyper-V. Both are available for Windows on Arm.

There is no Docker Desktop for Windows on Arm, [please show your support by asking for it](https://github.com/docker/roadmap/issues/91)
Docker Desktop for Windows on Arm was [announced at Microsoft Build 2024](https://www.docker.com/blog/announcing-docker-desktop-support-for-windows-on-arm/). The first available version is 4.30.

### What should I do before installing Docker for Windows on Arm?
### What should I do before installing Docker Desktop for Windows on Arm?

- Install WSL 2 on the Windows on Arm laptop
- Install a Linux distribution such as Ubuntu 22.04 Linux distribution in WSL 2 from the Microsoft Store

More information is available in the Learning Path [Get started with Windows Subsystem for Linux (WSL) on Arm](/learning-paths/laptops-and-desktops/wsl2/).
- Install WSL 2 on the Windows on Arm laptop, or turn on Hyper-V and Containers Windows features.

### Which Windows on Arm computers are supported?
Below are three examples of Windows on Arm computers today:

Here are three examples of Windows on Arm computers:
- Lenovo Thinkpad X13s.
- Microsoft Surface Pro X.
- Samsung Galaxy Book S.

### How do I install and test Docker Engine?

You can use the general Linux install instructions to install Docker in WSL 2 for Windows on Arm.

```console
curl -fsSL test.docker.com -o get-docker.sh && sh get-docker.sh
sudo usermod -aG docker $USER ; newgrp docker
```
Additional models of Windows on Arm computers are expected to be available in mid-2024.

The Docker daemon will not automatically start in WSL 2.
### How do I install and test Docker Desktop for Windows on Arm?

It can be started manually:
```console
sudo /etc/init.d/docker start
```
Download [Docker Desktop for Windows on Arm](https://desktop.docker.com/win/main/arm64/149282/Docker%20Desktop%20Installer.exe) and run the installer.

It can also be started automatically using by editing `/etc/wsl2.conf`
Once the installation is complete, you can test it by running `docker` in a Windows Command Prompt or PowerShell Prompt:

Add the info below to the file:
```console
# Set a command to run when a new WSL instance launches. This example starts the Docker container service.
[boot]
command = service docker start
```

To confirm the installation is successful run:
```console
docker run hello-world
```

The output should be a welcome message such as:
You should see a welcome message similar to the following:

```output
Hello from Docker!
Expand All @@ -98,14 +78,8 @@ For more examples and ideas, visit:
```

Use the `uname` command to identify the architecture:

```console
uname -m
```

The output is `aarch64` (Arm 64-bit).
Docker Desktop is now ready to use for Windows on Arm.

Docker Engine is now ready to use for Windows on Arm. You can explore [Docker related Learning Paths](/tag/docker/) or learn more about [WSL for Windows on Arm](/learning-paths/laptops-and-desktops/wsl2/).
You can explore [Docker related Learning Paths](/tag/docker/).

You may want to create an account on [Docker Hub](https://hub.docker.com) to share images and automate workflows.
Loading

0 comments on commit 3f9043f

Please sign in to comment.